微信小程序 列表渲染wx:key的作用
其实初次看 官方文档 可能会对 wx:key 有点懵,官方解释是这样的:
根据我多年看文档经验,一般我看不懂的可以忽略不重要的文字,只需关注重点,例如上图的文字加粗部分,因此,一开始我选择不写 wx:key 这个属性。然而在开发过程中写多了列表渲染(而没有加 wx:key)之后,控制台会报很多的 wx:key 的警告,对于有点代码洁癖的我看起来很不爽,但又苦于不清楚 wx:key 的真正作用,于是自创了一个解决办法,那就是在每个列表渲染后面加上 wx:key=”{{index}}”,类似下面这样:
123 | <view wx: for = "{{array}}" wx:key= "{{index}}" > {{item}} </view> |
于是我惊奇地发现警告统统不见了,也没有其他负面影响,于是我就这样用了大半年。
然而,半年前我做的一个项目里面有个列表渲染需要试试获取用户头像和昵称,于是我之前的做法不管用了,每次获取到的用户信息跟当前内容不对应,并且会发生错乱。于是我重新理解了一遍 wx:key,结合下面的例子,我似乎明白了:
123 | < switch wx: for = "{{objectArray}}" wx:key= "unique" style= "display: block;" > {{item.id}} </ switch > |
123456789101112 | 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' }, ] } }) |
其实,wx:key 是用来绑定当前列表中的项目特征的,也就是说,如果列表是动态更新的,那么 wx:key 的作用是保持原有项目的整个状态不变。
结合上面的例子,我们可以知道,对于列表数组是个对象数组,那么 wx:key 属性直接写对应的唯一的属性名就可以了,比如上面的 wx:key=”unique”, 或者 wx:key=”id” 也是可以的,只要保持属性是唯一值就行了,有点类似页面标签里面的 id 属性在页面是唯一的。
对于列表数组是个基本类型数组,那么直接写 wx:key=”*this” 就可以了,如下:
1234 | <block wx: for = "{{[1, 2, 3]}}" wx:key= "*this" > <view>{{index}}:</view> <view>{{item}}</view> </block> |
巧用 wx:key 属性
- 如果很明确自己的列表渲染是个静态列表,那么你可以像我一开始那样做,加个 wx:key=”{{index}}” 就可以了
- 反之,如果是个动态列表,那么就得在数组里找到唯一的键值,放在 wx:key 里面
- 当然如果你无视警告,也不影响功能,不加也行