字节跳动小程序开发框架 TTML-列表渲染

由 卓别林 创建, 最后一次修改 2019-07-29

我们经常需要渲染列表,这个时候我们可以使用 tt:for;

默认数组的当前项的下标变量名默认为 index,数组当前项的变量名默认为 item;

<!-- index.ttml -->
<view tt:for="{{array}}">
  {{index}}: {{item.message}}
</view>
// index.js
Page({
  data: {
    array: [{
      message: 'foo',
    }, {
      message: 'bar'
    }]
  }
})

使用 tt:for-item 可以指定数组当前元素的变量名,

使用 tt:for-index 可以指定数组当前下标的变量名:

<view tt:for="{{array}}" tt:for-index="idx" tt:for-item="itemName">
  {{idx}}: {{itemName.message}}
</view>

block tt:for


可以将 tt:for 用在<block/>标签上,以渲染一个包含多节点的结构块。例如:

<block tt:for="{{[1, 2, 3]}}">
  <view> {{index}}: </view>
  <view> {{item}} </view>
</block>

tt:key


当列表内容变化时,某些元素会被重新渲染而失去之前的UI状态,如果希望前后保持相同的状态,可以使用tt:key来指定列表中项目的唯一标识,这个可以类比React或者Vue中列表渲染的key。

tt:key如何指定:

  • 字符串,代表item的某个字段,比如tt:key="unique",那么指定item的unique字段为key
  • *this,代表item本身,比如tt:key="*this",那么就是用item本身(字符串)作为key

WARNING

不要通过数据绑定的方式指定key,比如tt:key="{ { unique } }",这样会把花括号也认为是字段名的一部分,从而访问item['{ { unique } }']


以上内容是否对您有帮助:
二维码
建议反馈
二维码