微信小程序-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

目录
相关文章
|
JSON 小程序 数据格式
微信小程序默认的文字内容在左上角怎么办?带你0基础快速了解skyline渲染模式。
本文主要介绍微信小程序开发中遇到的问题及其解决方法。问题通常由微信小程序自带的Skyline渲染模式引起,而非代码编写错误。解决步骤包括:1. 找到全局配置文件app.json;2. 去掉相关配置项;3. 修改后的配置示例。通过这些步骤可以有效解决文字内容顶格或覆盖的问题。文中还提供了进一步了解Skyline渲染模式的链接,帮助开发者深入理解其原理和应用。
1368 59
|
JSON 小程序 前端开发
towxml的使用,在微信小程序中快速将markdown格式渲染为wxml文本
本文介绍了在微信小程序中使用`towxml`库将Markdown格式文本渲染为WXML的方法。文章提供了`towxml`的概述、安装步骤、以及如何在小程序中配置和使用`towxml`进行Markdown解析的详细说明和代码示例。
|
小程序 前端开发 索引
微信小程序中的条件渲染和列表渲染,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属性的说明
|
小程序
【微信小程序-原生开发】列表 - 拖拽排序(官方组件 movable-area 和 movable-view 的用法)
【微信小程序-原生开发】列表 - 拖拽排序(官方组件 movable-area 和 movable-view 的用法)
1798 0
|
小程序 开发者
【微信小程序】 微信小程序报错不在以下request合法域名列表中
【微信小程序】 微信小程序报错不在以下request合法域名列表中
3041 0
|
小程序 前端开发
【微信小程序-原生开发】实用教程22 - 绘制图表(引入 echarts,含图表的懒加载-获取到数据后再渲染图表,多图表加载等技巧)
【微信小程序-原生开发】实用教程22 - 绘制图表(引入 echarts,含图表的懒加载-获取到数据后再渲染图表,多图表加载等技巧)
1358 0
|
小程序
【微信小程序-原生开发】wxml 支持 includes (wxml中执行函数的方法)
【微信小程序-原生开发】wxml 支持 includes (wxml中执行函数的方法)
906 0
|
小程序 数据库 C++
【微信小程序-原生开发】实用教程17 - 详情页触发列表页刷新,点击图片放大预览,转发给好友/群,分享到朋友圈
【微信小程序-原生开发】实用教程17 - 详情页触发列表页刷新,点击图片放大预览,转发给好友/群,分享到朋友圈
262 0
|
小程序 数据库
【微信小程序-原生开发】实用教程15 - 列表的排序、搜索(含云数据库常用查询条件的使用方法,t-search 组件的使用)
【微信小程序-原生开发】实用教程15 - 列表的排序、搜索(含云数据库常用查询条件的使用方法,t-search 组件的使用)
672 0
|
移动开发 小程序
thinkphp+uniapp开发的多端商城系统源码/H5/小程序/APP支持DIY模板直播分销
thinkphp+uniapp开发的多端商城系统源码/H5/小程序/APP支持DIY模板直播分销
693 0

热门文章

最新文章