循环

s-for

通过循环渲染列表是常见的场景,在元素上作用 s-for 指令,我们可以渲染一个列表。

默认情况

默认不写情况下,下标索引是为 index,数组当前变量名默认为 item。

代码示例

  1. <!-- for-demo.swan-->
  2. <view>
  3. <view s-for="persons">
  4. {{index}}: {{item.name}}
  5. </view>
  6. </view>
// for-demo.js
Page({
    data: {
        persons: [
            {name: 'Curry'},
            {name: 'Thompson'},
            {name: 'Durant'},
            {name: 'Green'},
            {name: 'Cousins'}
        ]
    }
});

简写

通过简写的方式,指定下标索引和数组当前变量名。

代码示例

<!-- for-demo.swan-->
<view>
    <view s-for="p,index in persons">
        {{index}}: {{p.name}}
    </view>
</view>

也可以通过使用 s-for-index 来指定下标索引,s-for-item 来指定数组当前变量名。

<!-- for-demo.swan-->
<view>
    <view s-for="persons" s-for-index="idx" s-for-item="p">
        {{idx}}: {{p.name}}
    </view>
</view>

trackBy

如果列表中的项目会动态地增加、删除,并且希望列表中的项目保持自己的特征和状态(例如 input 中的输入内容),需要在 s-for 指令声明中指定 trackBy。

trackBy 后跟的值可以是 s-for 的 array 中 item 本身或者其属性(如 item.id),该值需要是列表中唯一的字符串或数字,且不能动态改变。

当数据更新触发重新渲染时,将自动跟踪项的变更,原先列表内的项位置会移动,新添加的项会被渲染,以确保组件保持自身的状态,并且省去一部分重新渲染带来的消耗。

代码示例在开发者工具中预览效果

<input s-for="list trackBy item" placeholder="请输入内容" />
<button bindtap="delete">删除首项</button>
Page({
    data: {
        list: [1, 2, 3, 4]
    },
    delete() {
        const list = this.data.list
        console.log('当前删除项目 id', list.splice(0, 1)[0])
        this.setData({list})
    }
})

Tips

当循环渲染自定义组件列表时,不指定 trackBy 而动态增删数组中的元素,可能会导致调用错误的 attached detached 生命周期函数。