### Page.prototype.route > 基礎庫 1.2.0 開始支持，低版本需做[兼容處理](https://mp.weixin.qq.com/debug/wxadoc/dev/framework/compatibility.html) `route` 字段可以獲取到當前頁面的路徑。 ### Page.prototype.setData() `setData` 函數用于將數據從邏輯層發送到視圖層（異步），同時改變對應的 `this.data` 的值（同步）。 ### setData() 參數格式 | 字段 | 類型 | 必填 | 描述 | 最低版本 | | -------- | -------- | ---- | -------- | ---------------------------------------- | | data | Object | 是 | 這次要改變的數據 | | | callback | Function | 否 | 回調函數 | [1.5.0](https://mp.weixin.qq.com/debug/wxadoc/dev/framework/compatibility.html) | object 以 key，value 的形式表示將 this.data 中的 key 對應的值改變成 value。 callback 是一個回調函數，在這次setData對界面渲染完畢后調用。 其中 key 可以非常靈活，以數據路徑的形式給出，如 `array[2].message`，`a.b.c.d`，并且不需要在 this.data 中預先定義。 **注意：** 1. **直接修改 this.data 而不調用 this.setData 是無法改變頁面的狀態的，還會造成數據不一致**。 2. **單次設置的數據不能超過1024kB，請盡量避免一次設置過多的數據**。 3. 請不要把 data 中任何一項的 value 設為 `undefined` ，否則這一項將不被設置并可能遺留一些潛在問題。 **示例代碼：** ```html <!--index.wxml--> <view>{{text}}</view> <button bindtap="changeText"> Change normal data </button> <view>{{num}}</view> <button bindtap="changeNum"> Change normal num </button> <view>{{array[0].text}}</view> <button bindtap="changeItemInArray"> Change Array data </button> <view>{{object.text}}</view> <button bindtap="changeItemInObject"> Change Object data </button> <view>{{newField.text}}</view> <button bindtap="addNewField"> Add new data </button> ``` ```js //index.js Page({ data: { text: 'init data', num: 0, array: [{text: 'init data'}], object: { text: 'init data' } }, changeText: function() { // this.data.text = 'changed data' // bad, it can not work this.setData({ text: 'changed data' }) }, changeNum: function() { this.data.num = 1 this.setData({ num: this.data.num }) }, changeItemInArray: function() { // you can use this way to modify a danamic data path this.setData({ 'array[0].text':'changed data' }) }, changeItemInObject: function(){ this.setData({ 'object.text': 'changed data' }); }, addNewField: function() { this.setData({ 'newField.text': 'new data' }) } }) ```