小程序~列表渲染~key

Posted 2022-03-08 jianxian

如果列表中项目的位置会动态改变或者有新的项目添加到列表中，并且希望列表中的项目保持自己的特征和状态（如 <input/> 中的输入内容， <switch/> 的选中状态），需要使用 wx:key 来指定列表中项目的唯一的标识符。

wx:key 的值以两种形式提供：

1、字符串，代表在 for 循环的 array 中 item 的某个 property，该 property 的值需要是列表中唯一的字符串或数字，且不能动态改变。

2、保留关键字 this 代表在 for 循环中的 item 本身，这种表示需要 item 本身是一个唯一的字符串或者数字，如：

当数据改变触发渲染层重新渲染的时候，会校正带有 key 的组件，框架会确保他们被重新排序，而不是重新创建，以确保使组件保持自身的状态，并且提高列表渲染时的效率。

代码使用 wx:key 示例（WXML）

<switch wx:for="objectArray" wx:key="unique" > item.id </switch>
<button bindtap="switch"> Switch </button>
<button bindtap="addToFront"> Add to the front </button>


<switch wx:for="numberArray" wx:key="*this" > item </switch>
<button bindtap="addNumberToFront"> Add Number to the front </button>

代码使用 wx:key 示例（javascript）

Page(
  data: 
    objectArray: [
      id: 5, unique: ‘unique_5‘,
      id: 4, unique: ‘unique_4‘,
      id: 3, unique: ‘unique_3‘,
      id: 2, unique: ‘unique_2‘,
      id: 1, unique: ‘unique_1‘,
      id: 0, unique: ‘unique_0‘,
    ],
    numberArray: [1, 2, 3, 4]
  ,
  switch: function(e) 
    const length = this.data.objectArray.length
    for (let i = 0; i < length; ++i) 
      const x = Math.floor(Math.random() * length)
      const y = Math.floor(Math.random() * length)
      const temp = this.data.objectArray[x]
      this.data.objectArray[x] = this.data.objectArray[y]
      this.data.objectArray[y] = temp
    
    this.setData(
      objectArray: this.data.objectArray
    )
  ,
  addToFront: function(e) 
    const length = this.data.objectArray.length
    this.data.objectArray = [id: length, unique: ‘unique_‘ + length].concat(this.data.objectArray)
    this.setData(
      objectArray: this.data.objectArray
    )
  ,
  addNumberToFront: function(e)
    this.data.numberArray = [ this.data.numberArray.length + 1 ].concat(this.data.numberArray)
    this.setData(
      numberArray: this.data.numberArray
    )
  
)

 

 

 

 

 

 

.