文档翻译--list

[ldllidonglin]

本文档已迁移至 https://weex-project.io/cn/references/components/list.html ，此处不再维护，谢谢。

<list>

0.4

概括

这是一个提供了常见的列表功能的核心组件，通过平滑滚动和内存回收提供了更好的用户体验和性能

子组件

注意: list'的子组件只能包括 cell, header, refresh, loading 或者是 fix定位的组件. 其他形式的组件将不能被正确的渲染

• cell 定义了展现在list中的元件的属性和行为
• header ^0.6.1 当 header到达屏幕顶部时，将会固定在屏幕顶部 .
• refresh 组件可以用来给列表添加下拉刷新的功能
• loading 组件可以用来给列表添加上拉加载更多的功能
• refresh and loading 请查看 refresh-loading.

属性

• loadmoreoffset: <number> 触发loadmore事件所需要的滚动条距离list底部的垂直偏移距离.当list的滚动条滚动到足够接近list底部时将会触发loadmore这个事件

其他属性请查看 公共属性.

样式

公共样式: 查看 组件公共样式

• 支持flexbox 等样式
• 支持box model 等样式
• 支持position 等样式
• 支持opacity, background-color 等

事件

• loadmore ^0.5: 如果列表滚动到底部将会立即触发这个事件，你可以在这个事件的处理函数中加载下一页的列表项.

公共事件: 查看 公共事件

• 支持click 事件，查看 common events
• 支持 appear / disappear 事件. 查看common events

API

所以得cell或者类cell都支持 scrollToElement API dom module

约束

不允许相同方向的list或者scroller互相嵌套.换句话说就是嵌套的lists/scroller必须是不同的方向

举个例子，不允许一个垂直方向的list嵌套的一个垂直方向的scroller中，但是一个垂直方向的list是可以嵌套的一个水平方向的list或者scroller中的.

示例

查看 list-basic demo

[coderyi]

这篇没有加入
Weex中文文档

References - list

[robin-shine]

好多链接已失效

[ldllidonglin]

@Tanner-sun 谢谢提醒，现在我已经全部修复了

[Jam1zhu]

loadmore事件，在安卓上能触发吗

[bluesky0109]

不允许相同方向的list或者scroller互相嵌套，我记得RN中的 sroll 嵌套同方向的 list都是可以正常工作的，这个后期weex 也是一直不支持的吗？？

[wzj583585700]

demo 里面的list-base不能运行啊

[wzj583585700]

服了，在手机上运行什么反应都没有

[yundongbot]

@Jam1zhu @wzj583585700 loadmore 试一下这个例子 http://dotwe.org/bc445ede8746a31360e3607d210304c5.

更多例子可以参考新文档 https://alibaba.github.io/weex/cn/doc/components/list.html

[yundongbot]

@bluesky0109 目前暂不支持相同方向的 list/scroller 互相嵌套

[yundongbot]

@Jam1zhu android 支持 loadmore 事件。

[yundongbot]

本文档已迁移至 https://weex-project.io/cn/references/components/list.html ，此处不再维护，谢谢。