微信小程序-WXML列表渲染Key

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

wx:key

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


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

  • 字符串:代表在 for 循环的 array 中 item 的某个 property,该 property 的值需要是列表中唯一的字符串或数字,且不能动态改变。
  • 保留关键字:*this 代表在 for 循环中 item 本身,这种表示需要 item 本身是一个唯一的字符串或者
  • 数字。


?> 底层原理:小程序内部也使用了虚拟DOM(和Vue,React相似),通过key可以更好更快的判断是否可以复用


首先来看一个不使用wx:key的情况下,我们的示例会出现什么意想不到的情况,我们现在index.js定义一个属性来存储一些数据,然后编写一个方法用来给index.wxml页面按钮点击事件使用:


index.js:

data: {
  chs: ['a', 'b', 'c']
},
_myClickHandle: function(){
  console.log("加之前:" + this.data.chs)
  this.data.chs.push('d');
  this.setData(this.data);
  console.log("加之后:" + this.data.chs)
},


index.wxml:

<view wx:for="{{ chs }}">
  <switch/>
  <text>{{ item }}</text>
</view>
<button bindtap="_myClickHandle">按钮</button>


这个实例看起来一切正常,我们是往数组的后面追加元素的,我们来改造成往前面进行添加元素,更改一下_myClickHandle方法的追加方式从 push 改为 unshift:

this.data.chs.unshift('d');


再次运行我们的程序结果如下:

image.gif


发现我们新增的元素的开关状态自动被打开了,这个时候就出现了很严重的问题。


出现问题的原因:

2105804-20230409115444598-460046546.png

正是因为如此,就有了wx:key这么一个东西来解决该问题。


wx:key 官方文档:https://developers.weixin.qq.com/miniprogram/dev/reference/wxml/list.html#wx-key


到了这里我们就知道了如果不用wx:key那么就会出现复用DOM出错的情况,那么我们就来使用下,经过上面的一帆介绍我们知道了有两种wx:key的使用方式我们先来看,保留关键字。


保留关键字

2105804-20230409115837840-2085559031.png

如果上图的效果很显然,我们的问题已经得到了解决,那么为啥添加了wx:key那么就不会导致我们新增的元素复用错误呢,我画了张图看下图:

2105804-20230409115919752-468834029.png

好了,通过上图我们可以很清楚的看明白,我们的新增元素在复用组件当中找不到所以会重新创建一个新的。


如果列表渲染出来的数据不会发生变化,那么添加不添加wx:key都无所谓,但是还是建议添加,如果列表渲染出来的数据会发生变化,那么必须添加wx:key保证数据状态的正确性。


*this:表示当前遍历到的元素,也就是item中存储的内容,如果是独一无二的简单类型数据,可以使用 *this 但是如果是复杂类型(对象/数组), 不能使用*this。因为给到的结构是[object object] 无法保证唯一。


字符串

关于字符串的wx:key这里就简单弄个数据结构进行渲染即可:


index.js:

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'},
],


index.wxml:

<view wx:for="{{ objectArray }}" wx:key="id">
  <text>{{ item.unique }}</text>
</view>


wx:key=“id” 表示从当前遍历到的数组中获取id的值,item -> object -> item.id

目录
相关文章
|
5月前
|
小程序 前端开发 索引
微信小程序中的条件渲染和列表渲染,wx:if ,wx:elif,wx:else,wx:for,wx:key的使用,以及block标记和hidden属性的说明
这篇文章介绍了微信小程序中条件渲染和列表渲染的使用方法,包括wx:if、wx:elif、wx:else、wx:for、wx:key以及block标记和hidden属性的使用。
微信小程序中的条件渲染和列表渲染,wx:if ,wx:elif,wx:else,wx:for,wx:key的使用,以及block标记和hidden属性的说明
|
7月前
|
小程序 开发者
【微信小程序】 微信小程序报错不在以下request合法域名列表中
【微信小程序】 微信小程序报错不在以下request合法域名列表中
1160 0
|
7月前
|
小程序
【微信小程序-原生开发】列表 - 拖拽排序(官方组件 movable-area 和 movable-view 的用法)
【微信小程序-原生开发】列表 - 拖拽排序(官方组件 movable-area 和 movable-view 的用法)
566 0
|
4月前
|
JSON 小程序 JavaScript
uni-app开发微信小程序的报错[渲染层错误]排查及解决
uni-app开发微信小程序的报错[渲染层错误]排查及解决
922 7
|
4月前
|
小程序 JavaScript 前端开发
uni-app开发微信小程序:四大解决方案,轻松应对主包与vendor.js过大打包难题
uni-app开发微信小程序:四大解决方案,轻松应对主包与vendor.js过大打包难题
897 1
|
4月前
|
小程序 前端开发 测试技术
微信小程序的开发完整流程是什么?
微信小程序的开发完整流程是什么?
244 7
ly~
|
5月前
|
存储 供应链 小程序
除了微信小程序,PHP 还可以用于开发哪些类型的小程序?
除了微信小程序,PHP 还可用于开发多种类型的小程序,包括支付宝小程序、百度智能小程序、抖音小程序、企业内部小程序及行业特定小程序。在电商、生活服务、资讯、工具、娱乐、营销等领域,PHP 能有效管理商品信息、订单处理、支付接口、内容抓取、复杂计算、游戏数据、活动规则等多种业务。同时,在企业内部,PHP 可提升工作效率,实现审批流程、文件共享、生产计划等功能;在医疗和教育等行业,PHP 能管理患者信息、在线问诊、课程资源、成绩查询等重要数据。
ly~
105 6
|
4月前
|
缓存 小程序 索引
uni-app开发微信小程序时vant组件van-tabs的使用陷阱及解决方案
uni-app开发微信小程序时vant组件van-tabs的使用陷阱及解决方案
311 1
|
4月前
|
小程序 前端开发 数据安全/隐私保护
微信小程序全栈开发中的身份认证与授权机制
【10月更文挑战第3天】随着移动互联网的发展,微信小程序凭借便捷的用户体验和强大的社交传播能力,成为企业拓展业务的新渠道。本文探讨了小程序全栈开发中的身份认证与授权机制,包括手机号码验证、微信登录、第三方登录及角色权限控制等方法,并强调了安全性、用户体验和合规性的重要性,帮助开发者更好地理解和应用这一关键技术。
127 5
|
4月前
|
小程序 前端开发 JavaScript
微信小程序全栈开发中的PWA技术应用
【10月更文挑战第3天】微信小程序作为新兴应用形态,凭借便捷体验与社交传播能力,成为企业拓展业务的新渠道。本文探讨了微信小程序全栈开发中的PWA技术应用,包括离线访问、后台运行、桌面图标及原生体验等方面,助力开发者提升小程序性能与用户体验。PWA技术在不同平台的兼容性、性能优化及用户体验是实践中需注意的关键点。
93 5

热门文章

最新文章