• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# list<a name="ZH-CN_TOPIC_0000001163932194"></a>
2
3列表包含一系列相同宽度的列表项。适合连续、多行呈现同类数据,例如图片和文本。
4
5## 权限列表<a name="zh-cn_topic_0000001127284836_section11257113618419"></a>
6
78
9## 子组件<a name="zh-cn_topic_0000001127284836_section9288143101012"></a>
10
11仅支持<[list-item-group](js-components-container-list-item-group.md)\>和<[list-item](js-components-container-list-item.md)\>。
12
13## 属性<a name="zh-cn_topic_0000001127284836_section2907183951110"></a>
14
15除支持[通用属性](js-components-common-attributes.md)外,还支持如下属性:
16
17<a name="zh-cn_topic_0000001127284836_table20633101642315"></a>
18<table><thead align="left"><tr id="zh-cn_topic_0000001127284836_row663331618238"><th class="cellrowborder" valign="top" width="23.119999999999997%" id="mcps1.1.6.1.1"><p id="zh-cn_topic_0000001127284836_zh-cn_topic_0000001058340523_a9ba8c579217b4b8b841b035f1d28b20e"><a name="zh-cn_topic_0000001127284836_zh-cn_topic_0000001058340523_a9ba8c579217b4b8b841b035f1d28b20e"></a><a name="zh-cn_topic_0000001127284836_zh-cn_topic_0000001058340523_a9ba8c579217b4b8b841b035f1d28b20e"></a>名称</p>
19</th>
20<th class="cellrowborder" valign="top" width="14.67%" id="mcps1.1.6.1.2"><p id="zh-cn_topic_0000001127284836_zh-cn_topic_0000001058340523_a633002333b024497914a4b172446f14e"><a name="zh-cn_topic_0000001127284836_zh-cn_topic_0000001058340523_a633002333b024497914a4b172446f14e"></a><a name="zh-cn_topic_0000001127284836_zh-cn_topic_0000001058340523_a633002333b024497914a4b172446f14e"></a>类型</p>
21</th>
22<th class="cellrowborder" valign="top" width="10.92%" id="mcps1.1.6.1.3"><p id="zh-cn_topic_0000001127284836_zh-cn_topic_0000001058340523_a4950f7884c6540b9ad523ac34657d952"><a name="zh-cn_topic_0000001127284836_zh-cn_topic_0000001058340523_a4950f7884c6540b9ad523ac34657d952"></a><a name="zh-cn_topic_0000001127284836_zh-cn_topic_0000001058340523_a4950f7884c6540b9ad523ac34657d952"></a>默认值</p>
23</th>
24<th class="cellrowborder" valign="top" width="9.33%" id="mcps1.1.6.1.4"><p id="zh-cn_topic_0000001127284836_p824610360217"><a name="zh-cn_topic_0000001127284836_p824610360217"></a><a name="zh-cn_topic_0000001127284836_p824610360217"></a>必填</p>
25</th>
26<th class="cellrowborder" valign="top" width="41.959999999999994%" id="mcps1.1.6.1.5"><p id="zh-cn_topic_0000001127284836_zh-cn_topic_0000001058340523_a1313564aa9404a338447087d5918c17d"><a name="zh-cn_topic_0000001127284836_zh-cn_topic_0000001058340523_a1313564aa9404a338447087d5918c17d"></a><a name="zh-cn_topic_0000001127284836_zh-cn_topic_0000001058340523_a1313564aa9404a338447087d5918c17d"></a>描述</p>
27</th>
28</tr>
29</thead>
30<tbody><tr id="zh-cn_topic_0000001127284836_row389219166580"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p32747328584"><a name="zh-cn_topic_0000001127284836_p32747328584"></a><a name="zh-cn_topic_0000001127284836_p32747328584"></a>scrollpage</p>
31</td>
32<td class="cellrowborder" valign="top" width="14.67%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p1927413328589"><a name="zh-cn_topic_0000001127284836_p1927413328589"></a><a name="zh-cn_topic_0000001127284836_p1927413328589"></a>boolean</p>
33</td>
34<td class="cellrowborder" valign="top" width="10.92%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p142747324586"><a name="zh-cn_topic_0000001127284836_p142747324586"></a><a name="zh-cn_topic_0000001127284836_p142747324586"></a>false</p>
35</td>
36<td class="cellrowborder" valign="top" width="9.33%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p1827423217589"><a name="zh-cn_topic_0000001127284836_p1827423217589"></a><a name="zh-cn_topic_0000001127284836_p1827423217589"></a>否</p>
37</td>
38<td class="cellrowborder" valign="top" width="41.959999999999994%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p627473213585"><a name="zh-cn_topic_0000001127284836_p627473213585"></a><a name="zh-cn_topic_0000001127284836_p627473213585"></a>设置为true时,将 list 顶部页面中非 list 部分随 list 一起滑出可视区域,当list方向为row时,不支持此属性。</p>
39</td>
40</tr>
41<tr id="zh-cn_topic_0000001127284836_row9893216145818"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p112749323589"><a name="zh-cn_topic_0000001127284836_p112749323589"></a><a name="zh-cn_topic_0000001127284836_p112749323589"></a>cachedcount</p>
42</td>
43<td class="cellrowborder" valign="top" width="14.67%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p1427483225810"><a name="zh-cn_topic_0000001127284836_p1427483225810"></a><a name="zh-cn_topic_0000001127284836_p1427483225810"></a>number</p>
44</td>
45<td class="cellrowborder" valign="top" width="10.92%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p16274432145815"><a name="zh-cn_topic_0000001127284836_p16274432145815"></a><a name="zh-cn_topic_0000001127284836_p16274432145815"></a>0</p>
46</td>
47<td class="cellrowborder" valign="top" width="9.33%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p32741132185811"><a name="zh-cn_topic_0000001127284836_p32741132185811"></a><a name="zh-cn_topic_0000001127284836_p32741132185811"></a>否</p>
48</td>
49<td class="cellrowborder" valign="top" width="41.959999999999994%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p02741932195811"><a name="zh-cn_topic_0000001127284836_p02741932195811"></a><a name="zh-cn_topic_0000001127284836_p02741932195811"></a>长列表延迟加载时list-item最少缓存数量。</p>
50<p id="zh-cn_topic_0000001127284836_p182741432115814"><a name="zh-cn_topic_0000001127284836_p182741432115814"></a><a name="zh-cn_topic_0000001127284836_p182741432115814"></a>可视区域外缓存的list-item数量少于该值时,会触发requestitem事件。</p>
51</td>
52</tr>
53<tr id="zh-cn_topic_0000001127284836_row9893131620589"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p827410325586"><a name="zh-cn_topic_0000001127284836_p827410325586"></a><a name="zh-cn_topic_0000001127284836_p827410325586"></a>scrollbar</p>
54</td>
55<td class="cellrowborder" valign="top" width="14.67%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p72741332125816"><a name="zh-cn_topic_0000001127284836_p72741332125816"></a><a name="zh-cn_topic_0000001127284836_p72741332125816"></a>string</p>
56</td>
57<td class="cellrowborder" valign="top" width="10.92%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p122741532125818"><a name="zh-cn_topic_0000001127284836_p122741532125818"></a><a name="zh-cn_topic_0000001127284836_p122741532125818"></a>off</p>
58</td>
59<td class="cellrowborder" valign="top" width="9.33%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p1227413295813"><a name="zh-cn_topic_0000001127284836_p1227413295813"></a><a name="zh-cn_topic_0000001127284836_p1227413295813"></a>否</p>
60</td>
61<td class="cellrowborder" valign="top" width="41.959999999999994%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p142744322587"><a name="zh-cn_topic_0000001127284836_p142744322587"></a><a name="zh-cn_topic_0000001127284836_p142744322587"></a>侧边滑动栏的显示模式(当前只支持纵向):</p>
62<a name="zh-cn_topic_0000001127284836_ul162752325582"></a><a name="zh-cn_topic_0000001127284836_ul162752325582"></a><ul id="zh-cn_topic_0000001127284836_ul162752325582"><li>off:不显示。</li><li>auto:按需显示(触摸时显示,2s后消失)。</li><li>on:常驻显示。</li></ul>
63</td>
64</tr>
65<tr id="zh-cn_topic_0000001127284836_row1089321620582"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p1275832125813"><a name="zh-cn_topic_0000001127284836_p1275832125813"></a><a name="zh-cn_topic_0000001127284836_p1275832125813"></a>scrolleffect</p>
66</td>
67<td class="cellrowborder" valign="top" width="14.67%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p7275193216582"><a name="zh-cn_topic_0000001127284836_p7275193216582"></a><a name="zh-cn_topic_0000001127284836_p7275193216582"></a>string</p>
68</td>
69<td class="cellrowborder" valign="top" width="10.92%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p13275232125815"><a name="zh-cn_topic_0000001127284836_p13275232125815"></a><a name="zh-cn_topic_0000001127284836_p13275232125815"></a>spring</p>
70</td>
71<td class="cellrowborder" valign="top" width="9.33%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p327520323585"><a name="zh-cn_topic_0000001127284836_p327520323585"></a><a name="zh-cn_topic_0000001127284836_p327520323585"></a>否</p>
72</td>
73<td class="cellrowborder" valign="top" width="41.959999999999994%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p1827516324585"><a name="zh-cn_topic_0000001127284836_p1827516324585"></a><a name="zh-cn_topic_0000001127284836_p1827516324585"></a>滑动效果,目前支持如下滑动效果:</p>
74<a name="zh-cn_topic_0000001127284836_ul13275532195819"></a><a name="zh-cn_topic_0000001127284836_ul13275532195819"></a><ul id="zh-cn_topic_0000001127284836_ul13275532195819"><li>spring:弹性物理动效,滑动到边缘后可以根据初始速度或通过触摸事件继续滑动一段距离,松手后回弹。</li><li>fade:渐隐物理动效,滑动到边缘后展示一个波浪形的渐隐,根据速度和滑动距离的变化渐隐也会发送一定的变化。</li><li>no:滑动到边缘后无效果。</li></ul>
75</td>
76</tr>
77<tr id="zh-cn_topic_0000001127284836_row208941516165811"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p1327573215812"><a name="zh-cn_topic_0000001127284836_p1327573215812"></a><a name="zh-cn_topic_0000001127284836_p1327573215812"></a>indexer</p>
78</td>
79<td class="cellrowborder" valign="top" width="14.67%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p15275163245815"><a name="zh-cn_topic_0000001127284836_p15275163245815"></a><a name="zh-cn_topic_0000001127284836_p15275163245815"></a>boolean | Array&lt;string&gt;</p>
80</td>
81<td class="cellrowborder" valign="top" width="10.92%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p427553220580"><a name="zh-cn_topic_0000001127284836_p427553220580"></a><a name="zh-cn_topic_0000001127284836_p427553220580"></a>false</p>
82</td>
83<td class="cellrowborder" valign="top" width="9.33%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p627613214585"><a name="zh-cn_topic_0000001127284836_p627613214585"></a><a name="zh-cn_topic_0000001127284836_p627613214585"></a>否</p>
84</td>
85<td class="cellrowborder" valign="top" width="41.959999999999994%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p1127613275818"><a name="zh-cn_topic_0000001127284836_p1127613275818"></a><a name="zh-cn_topic_0000001127284836_p1127613275818"></a>是否展示侧边栏快速字母索引栏。设置为true或者自定义索引时,索引栏会显示在列表右边界处。示例:</p>
86<p id="zh-cn_topic_0000001127284836_p19276132105811"><a name="zh-cn_topic_0000001127284836_p19276132105811"></a><a name="zh-cn_topic_0000001127284836_p19276132105811"></a>"indexer" : "true"表示使用默认字母索引表。</p>
87<p id="zh-cn_topic_0000001127284836_p10276133295813"><a name="zh-cn_topic_0000001127284836_p10276133295813"></a><a name="zh-cn_topic_0000001127284836_p10276133295813"></a>"indexer" : "false"表示无索引。</p>
88<p id="zh-cn_topic_0000001127284836_p1027643295815"><a name="zh-cn_topic_0000001127284836_p1027643295815"></a><a name="zh-cn_topic_0000001127284836_p1027643295815"></a>"indexer" : ['#',‘1’,'2',‘3’,'4',‘5’,'6',‘7’,'8']表示自定义索引表。自定义时"#"必须要存在。</p>
89<div class="note" id="zh-cn_topic_0000001127284836_note1752771418501"><a name="zh-cn_topic_0000001127284836_note1752771418501"></a><a name="zh-cn_topic_0000001127284836_note1752771418501"></a><span class="notetitle"> 说明: </span><div class="notebody"><a name="zh-cn_topic_0000001127284836_ul55231518155017"></a><a name="zh-cn_topic_0000001127284836_ul55231518155017"></a><ul id="zh-cn_topic_0000001127284836_ul55231518155017"><li>indexer属性生效需要flex-direction属性配合设置为column,且columns属性设置为1。</li><li>点击索引条进行列表项索引需要list-item子组件配合设置相应的<a href="js-components-container-list-item.md#zh-cn_topic_0000001127125046_section2907183951110">section属性</a>。</li></ul>
90</div></div>
91</td>
92</tr>
93<tr id="zh-cn_topic_0000001127284836_row1981645163320"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p105121047125317"><a name="zh-cn_topic_0000001127284836_p105121047125317"></a><a name="zh-cn_topic_0000001127284836_p105121047125317"></a>indexercircle<sup id="zh-cn_topic_0000001127284836_sup43038121535"><a name="zh-cn_topic_0000001127284836_sup43038121535"></a><a name="zh-cn_topic_0000001127284836_sup43038121535"></a><span>5+</span></sup></p>
94</td>
95<td class="cellrowborder" valign="top" width="14.67%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p8512114712538"><a name="zh-cn_topic_0000001127284836_p8512114712538"></a><a name="zh-cn_topic_0000001127284836_p8512114712538"></a>boolean</p>
96</td>
97<td class="cellrowborder" valign="top" width="10.92%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p551317471531"><a name="zh-cn_topic_0000001127284836_p551317471531"></a><a name="zh-cn_topic_0000001127284836_p551317471531"></a>-</p>
98</td>
99<td class="cellrowborder" valign="top" width="9.33%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p4513547195316"><a name="zh-cn_topic_0000001127284836_p4513547195316"></a><a name="zh-cn_topic_0000001127284836_p4513547195316"></a>否</p>
100</td>
101<td class="cellrowborder" valign="top" width="41.959999999999994%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p1898916471451"><a name="zh-cn_topic_0000001127284836_p1898916471451"></a><a name="zh-cn_topic_0000001127284836_p1898916471451"></a>是否为环形索引。</p>
102<p id="zh-cn_topic_0000001127284836_p10513447125316"><a name="zh-cn_topic_0000001127284836_p10513447125316"></a><a name="zh-cn_topic_0000001127284836_p10513447125316"></a>穿戴设备默认为true,其他为false。indexer为false时不生效。</p>
103</td>
104</tr>
105<tr id="zh-cn_topic_0000001127284836_row1926180153418"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p1370619211500"><a name="zh-cn_topic_0000001127284836_p1370619211500"></a><a name="zh-cn_topic_0000001127284836_p1370619211500"></a>indexermulti<sup id="zh-cn_topic_0000001127284836_sup1478641710316"><a name="zh-cn_topic_0000001127284836_sup1478641710316"></a><a name="zh-cn_topic_0000001127284836_sup1478641710316"></a><span>5+</span></sup></p>
106</td>
107<td class="cellrowborder" valign="top" width="14.67%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p13706112125019"><a name="zh-cn_topic_0000001127284836_p13706112125019"></a><a name="zh-cn_topic_0000001127284836_p13706112125019"></a>boolean</p>
108</td>
109<td class="cellrowborder" valign="top" width="10.92%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p1770622195017"><a name="zh-cn_topic_0000001127284836_p1770622195017"></a><a name="zh-cn_topic_0000001127284836_p1770622195017"></a>false</p>
110</td>
111<td class="cellrowborder" valign="top" width="9.33%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p97060218503"><a name="zh-cn_topic_0000001127284836_p97060218503"></a><a name="zh-cn_topic_0000001127284836_p97060218503"></a>否</p>
112</td>
113<td class="cellrowborder" valign="top" width="41.959999999999994%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p1768357350"><a name="zh-cn_topic_0000001127284836_p1768357350"></a><a name="zh-cn_topic_0000001127284836_p1768357350"></a>是否开启索引条多语言功能。</p>
114<p id="zh-cn_topic_0000001127284836_p57061219500"><a name="zh-cn_topic_0000001127284836_p57061219500"></a><a name="zh-cn_topic_0000001127284836_p57061219500"></a>indexer为false时不生效。</p>
115</td>
116</tr>
117<tr id="zh-cn_topic_0000001127284836_row289205623319"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p336515269516"><a name="zh-cn_topic_0000001127284836_p336515269516"></a><a name="zh-cn_topic_0000001127284836_p336515269516"></a>indexerbubble<sup id="zh-cn_topic_0000001127284836_sup3412121919314"><a name="zh-cn_topic_0000001127284836_sup3412121919314"></a><a name="zh-cn_topic_0000001127284836_sup3412121919314"></a><span>5+</span></sup></p>
118</td>
119<td class="cellrowborder" valign="top" width="14.67%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p836613263515"><a name="zh-cn_topic_0000001127284836_p836613263515"></a><a name="zh-cn_topic_0000001127284836_p836613263515"></a>boolean</p>
120</td>
121<td class="cellrowborder" valign="top" width="10.92%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p153661126165120"><a name="zh-cn_topic_0000001127284836_p153661126165120"></a><a name="zh-cn_topic_0000001127284836_p153661126165120"></a>true</p>
122</td>
123<td class="cellrowborder" valign="top" width="9.33%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p0366182611512"><a name="zh-cn_topic_0000001127284836_p0366182611512"></a><a name="zh-cn_topic_0000001127284836_p0366182611512"></a>否</p>
124</td>
125<td class="cellrowborder" valign="top" width="41.959999999999994%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p15708185468"><a name="zh-cn_topic_0000001127284836_p15708185468"></a><a name="zh-cn_topic_0000001127284836_p15708185468"></a>是否开启索引切换的气泡提示。</p>
126<p id="zh-cn_topic_0000001127284836_p12366132614518"><a name="zh-cn_topic_0000001127284836_p12366132614518"></a><a name="zh-cn_topic_0000001127284836_p12366132614518"></a>indexer为false时不生效。</p>
127</td>
128</tr>
129<tr id="zh-cn_topic_0000001127284836_row19197115453311"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p191412818511"><a name="zh-cn_topic_0000001127284836_p191412818511"></a><a name="zh-cn_topic_0000001127284836_p191412818511"></a>divider<sup id="zh-cn_topic_0000001127284836_sup918814291347"><a name="zh-cn_topic_0000001127284836_sup918814291347"></a><a name="zh-cn_topic_0000001127284836_sup918814291347"></a><span>5+</span></sup></p>
130</td>
131<td class="cellrowborder" valign="top" width="14.67%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p3914284516"><a name="zh-cn_topic_0000001127284836_p3914284516"></a><a name="zh-cn_topic_0000001127284836_p3914284516"></a>boolean</p>
132</td>
133<td class="cellrowborder" valign="top" width="10.92%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p10914285514"><a name="zh-cn_topic_0000001127284836_p10914285514"></a><a name="zh-cn_topic_0000001127284836_p10914285514"></a>false</p>
134</td>
135<td class="cellrowborder" valign="top" width="9.33%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p8914148051"><a name="zh-cn_topic_0000001127284836_p8914148051"></a><a name="zh-cn_topic_0000001127284836_p8914148051"></a>否</p>
136</td>
137<td class="cellrowborder" valign="top" width="41.959999999999994%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p111882182061"><a name="zh-cn_topic_0000001127284836_p111882182061"></a><a name="zh-cn_topic_0000001127284836_p111882182061"></a>item是否自带分隔线。</p>
138<p id="zh-cn_topic_0000001127284836_p20914284518"><a name="zh-cn_topic_0000001127284836_p20914284518"></a><a name="zh-cn_topic_0000001127284836_p20914284518"></a>其样式参考<a href="#zh-cn_topic_0000001127284836_section5775351116">样式列表</a>的divider-color、divider-height、divider-length、divider-origin。</p>
139</td>
140</tr>
141<tr id="zh-cn_topic_0000001127284836_row311191013583"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p9276123217583"><a name="zh-cn_topic_0000001127284836_p9276123217583"></a><a name="zh-cn_topic_0000001127284836_p9276123217583"></a>shapemode</p>
142</td>
143<td class="cellrowborder" valign="top" width="14.67%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p1527610320588"><a name="zh-cn_topic_0000001127284836_p1527610320588"></a><a name="zh-cn_topic_0000001127284836_p1527610320588"></a>string</p>
144</td>
145<td class="cellrowborder" valign="top" width="10.92%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p17276832195815"><a name="zh-cn_topic_0000001127284836_p17276832195815"></a><a name="zh-cn_topic_0000001127284836_p17276832195815"></a>default</p>
146</td>
147<td class="cellrowborder" valign="top" width="9.33%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p142761532145817"><a name="zh-cn_topic_0000001127284836_p142761532145817"></a><a name="zh-cn_topic_0000001127284836_p142761532145817"></a>否</p>
148</td>
149<td class="cellrowborder" valign="top" width="41.959999999999994%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p182761532205818"><a name="zh-cn_topic_0000001127284836_p182761532205818"></a><a name="zh-cn_topic_0000001127284836_p182761532205818"></a>侧边滑动栏的形状类型。</p>
150<a name="zh-cn_topic_0000001127284836_ul4276203212589"></a><a name="zh-cn_topic_0000001127284836_ul4276203212589"></a><ul id="zh-cn_topic_0000001127284836_ul4276203212589"><li>default:不指定,跟随主题;</li><li>rect:矩形;</li><li>round:圆形。</li></ul>
151</td>
152</tr>
153<tr id="zh-cn_topic_0000001127284836_row1465212481574"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p102776324585"><a name="zh-cn_topic_0000001127284836_p102776324585"></a><a name="zh-cn_topic_0000001127284836_p102776324585"></a>updateeffect</p>
154</td>
155<td class="cellrowborder" valign="top" width="14.67%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p4277133275818"><a name="zh-cn_topic_0000001127284836_p4277133275818"></a><a name="zh-cn_topic_0000001127284836_p4277133275818"></a>boolean</p>
156</td>
157<td class="cellrowborder" valign="top" width="10.92%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p627763235813"><a name="zh-cn_topic_0000001127284836_p627763235813"></a><a name="zh-cn_topic_0000001127284836_p627763235813"></a>false</p>
158</td>
159<td class="cellrowborder" valign="top" width="9.33%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p1927893215584"><a name="zh-cn_topic_0000001127284836_p1927893215584"></a><a name="zh-cn_topic_0000001127284836_p1927893215584"></a>否</p>
160</td>
161<td class="cellrowborder" valign="top" width="41.959999999999994%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p3278032145815"><a name="zh-cn_topic_0000001127284836_p3278032145815"></a><a name="zh-cn_topic_0000001127284836_p3278032145815"></a>用于设置当list内部的item发生删除或新增时是否支持动效。</p>
162<a name="zh-cn_topic_0000001127284836_ul8278153205815"></a><a name="zh-cn_topic_0000001127284836_ul8278153205815"></a><ul id="zh-cn_topic_0000001127284836_ul8278153205815"><li>false:新增删除item时无过渡动效。</li><li>true:新增删除item时播放过程动效。</li></ul>
163</td>
164</tr>
165<tr id="zh-cn_topic_0000001127284836_row1788316557427"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p198831055124217"><a name="zh-cn_topic_0000001127284836_p198831055124217"></a><a name="zh-cn_topic_0000001127284836_p198831055124217"></a>chainanimation<sup id="zh-cn_topic_0000001127284836_sup13376443103416"><a name="zh-cn_topic_0000001127284836_sup13376443103416"></a><a name="zh-cn_topic_0000001127284836_sup13376443103416"></a>5+</sup></p>
166</td>
167<td class="cellrowborder" valign="top" width="14.67%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p0883955174217"><a name="zh-cn_topic_0000001127284836_p0883955174217"></a><a name="zh-cn_topic_0000001127284836_p0883955174217"></a>boolean</p>
168</td>
169<td class="cellrowborder" valign="top" width="10.92%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p888305574219"><a name="zh-cn_topic_0000001127284836_p888305574219"></a><a name="zh-cn_topic_0000001127284836_p888305574219"></a>false</p>
170</td>
171<td class="cellrowborder" valign="top" width="9.33%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p19884755204213"><a name="zh-cn_topic_0000001127284836_p19884755204213"></a><a name="zh-cn_topic_0000001127284836_p19884755204213"></a>否</p>
172</td>
173<td class="cellrowborder" valign="top" width="41.959999999999994%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p78841255154210"><a name="zh-cn_topic_0000001127284836_p78841255154210"></a><a name="zh-cn_topic_0000001127284836_p78841255154210"></a>用于设置当前list是否启用链式联动动效,开启后列表滑动以及顶部和底部拖拽时会有链式联动的效果。链式联动效果:list内的list-item间隔一定距离,在基本的滑动交互行为下,主动对象驱动从动对象进行联动,驱动效果遵循弹簧物理动效。</p>
174<a name="zh-cn_topic_0000001127284836_ul1490293714519"></a><a name="zh-cn_topic_0000001127284836_ul1490293714519"></a><ul id="zh-cn_topic_0000001127284836_ul1490293714519"><li>false:不启用链式联动</li><li>true:启用链式联动<div class="note" id="zh-cn_topic_0000001127284836_note775214910343"><a name="zh-cn_topic_0000001127284836_note775214910343"></a><a name="zh-cn_topic_0000001127284836_note775214910343"></a><span class="notetitle"> 说明: </span><div class="notebody"><a name="zh-cn_topic_0000001127284836_ul99031432111819"></a><a name="zh-cn_topic_0000001127284836_ul99031432111819"></a><ul id="zh-cn_topic_0000001127284836_ul99031432111819"><li>不支持动态修改。</li><li>如同时配置了indexer,链式动效不生效。</li><li>如配置了链式动效,list-item的sticky不生效。</li></ul>
175</div></div>
176</li></ul>
177</td>
178</tr>
179<tr id="zh-cn_topic_0000001127284836_row114931435579"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p2278932185814"><a name="zh-cn_topic_0000001127284836_p2278932185814"></a><a name="zh-cn_topic_0000001127284836_p2278932185814"></a>initialindex</p>
180</td>
181<td class="cellrowborder" valign="top" width="14.67%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p627818324584"><a name="zh-cn_topic_0000001127284836_p627818324584"></a><a name="zh-cn_topic_0000001127284836_p627818324584"></a>number</p>
182</td>
183<td class="cellrowborder" valign="top" width="10.92%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p142783321586"><a name="zh-cn_topic_0000001127284836_p142783321586"></a><a name="zh-cn_topic_0000001127284836_p142783321586"></a>0</p>
184</td>
185<td class="cellrowborder" valign="top" width="9.33%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p20278123225811"><a name="zh-cn_topic_0000001127284836_p20278123225811"></a><a name="zh-cn_topic_0000001127284836_p20278123225811"></a>否</p>
186</td>
187<td class="cellrowborder" valign="top" width="41.959999999999994%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p627813212587"><a name="zh-cn_topic_0000001127284836_p627813212587"></a><a name="zh-cn_topic_0000001127284836_p627813212587"></a>用于设置当前List初次加载时视口起始位置显示的item,默认为0,即显示第一个item,如设置的序号超过了最后一个item的序号,则设置不生效,当同时设置了initialoffset属性时,当前属性不生效。当indexer为true或者scrollpage为true时,不生效。</p>
188</td>
189</tr>
190<tr id="zh-cn_topic_0000001127284836_row950539135714"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p827963212580"><a name="zh-cn_topic_0000001127284836_p827963212580"></a><a name="zh-cn_topic_0000001127284836_p827963212580"></a>initialoffset</p>
191</td>
192<td class="cellrowborder" valign="top" width="14.67%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p227917321582"><a name="zh-cn_topic_0000001127284836_p227917321582"></a><a name="zh-cn_topic_0000001127284836_p227917321582"></a>&lt;length&gt;</p>
193</td>
194<td class="cellrowborder" valign="top" width="10.92%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p62791332105814"><a name="zh-cn_topic_0000001127284836_p62791332105814"></a><a name="zh-cn_topic_0000001127284836_p62791332105814"></a>0</p>
195</td>
196<td class="cellrowborder" valign="top" width="9.33%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p1527943212583"><a name="zh-cn_topic_0000001127284836_p1527943212583"></a><a name="zh-cn_topic_0000001127284836_p1527943212583"></a>否</p>
197</td>
198<td class="cellrowborder" valign="top" width="41.959999999999994%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p327920329582"><a name="zh-cn_topic_0000001127284836_p327920329582"></a><a name="zh-cn_topic_0000001127284836_p327920329582"></a>用于设置当前List初次加载时视口的起始偏移量,偏移量无法超过当前List可滑动的范围,如果超过会被截断为可滑动范围的极限值。当indexer为true或者scrollpage为true时,不生效。</p>
199</td>
200</tr>
201<tr id="zh-cn_topic_0000001127284836_row1914605315918"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p19147135375914"><a name="zh-cn_topic_0000001127284836_p19147135375914"></a><a name="zh-cn_topic_0000001127284836_p19147135375914"></a>selected<sup id="zh-cn_topic_0000001127284836_sup2083525912347"><a name="zh-cn_topic_0000001127284836_sup2083525912347"></a><a name="zh-cn_topic_0000001127284836_sup2083525912347"></a>5+</sup></p>
202</td>
203<td class="cellrowborder" valign="top" width="14.67%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p12147105375915"><a name="zh-cn_topic_0000001127284836_p12147105375915"></a><a name="zh-cn_topic_0000001127284836_p12147105375915"></a>string</p>
204</td>
205<td class="cellrowborder" valign="top" width="10.92%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p161471753195920"><a name="zh-cn_topic_0000001127284836_p161471753195920"></a><a name="zh-cn_topic_0000001127284836_p161471753195920"></a>-</p>
206</td>
207<td class="cellrowborder" valign="top" width="9.33%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p314745313591"><a name="zh-cn_topic_0000001127284836_p314745313591"></a><a name="zh-cn_topic_0000001127284836_p314745313591"></a>否</p>
208</td>
209<td class="cellrowborder" valign="top" width="41.959999999999994%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p11147853145914"><a name="zh-cn_topic_0000001127284836_p11147853145914"></a><a name="zh-cn_topic_0000001127284836_p11147853145914"></a>指定当前列表中被选中激活的项,可选值为list-item的section属性值。</p>
210</td>
211</tr>
212</tbody>
213</table>
214
215## 样式<a name="zh-cn_topic_0000001127284836_section5775351116"></a>
216
217除支持[通用样式](js-components-common-styles.md)外,还支持如下样式:
218
219<a name="zh-cn_topic_0000001127284836_table1744514388541"></a>
220<table><thead align="left"><tr id="zh-cn_topic_0000001127284836_row1244614388545"><th class="cellrowborder" valign="top" width="23.11768823117688%" id="mcps1.1.6.1.1"><p id="zh-cn_topic_0000001127284836_ae8fba6e2bad749f49d7af2927756ecac"><a name="zh-cn_topic_0000001127284836_ae8fba6e2bad749f49d7af2927756ecac"></a><a name="zh-cn_topic_0000001127284836_ae8fba6e2bad749f49d7af2927756ecac"></a>名称</p>
221</th>
222<th class="cellrowborder" valign="top" width="20.477952204779523%" id="mcps1.1.6.1.2"><p id="zh-cn_topic_0000001127284836_a4543b5564fb34df0b7d83c5640a46890"><a name="zh-cn_topic_0000001127284836_a4543b5564fb34df0b7d83c5640a46890"></a><a name="zh-cn_topic_0000001127284836_a4543b5564fb34df0b7d83c5640a46890"></a>类型</p>
223</th>
224<th class="cellrowborder" valign="top" width="8.869113088691131%" id="mcps1.1.6.1.3"><p id="zh-cn_topic_0000001127284836_a779ef1afb2d74c0fac0e8014dd85e120"><a name="zh-cn_topic_0000001127284836_a779ef1afb2d74c0fac0e8014dd85e120"></a><a name="zh-cn_topic_0000001127284836_a779ef1afb2d74c0fac0e8014dd85e120"></a>默认值</p>
225</th>
226<th class="cellrowborder" valign="top" width="7.519248075192481%" id="mcps1.1.6.1.4"><p id="zh-cn_topic_0000001127284836_p117421754619"><a name="zh-cn_topic_0000001127284836_p117421754619"></a><a name="zh-cn_topic_0000001127284836_p117421754619"></a>必填</p>
227</th>
228<th class="cellrowborder" valign="top" width="40.01599840015999%" id="mcps1.1.6.1.5"><p id="zh-cn_topic_0000001127284836_aaed5c586aaf5480c8db9e53a6a22428c"><a name="zh-cn_topic_0000001127284836_aaed5c586aaf5480c8db9e53a6a22428c"></a><a name="zh-cn_topic_0000001127284836_aaed5c586aaf5480c8db9e53a6a22428c"></a>描述</p>
229</th>
230</tr>
231</thead>
232<tbody><tr id="zh-cn_topic_0000001127284836_row194212174919"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p199724441985"><a name="zh-cn_topic_0000001127284836_p199724441985"></a><a name="zh-cn_topic_0000001127284836_p199724441985"></a>divider-color<sup id="zh-cn_topic_0000001127284836_sup3982558172012"><a name="zh-cn_topic_0000001127284836_sup3982558172012"></a><a name="zh-cn_topic_0000001127284836_sup3982558172012"></a><span>5+</span></sup></p>
233</td>
234<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p097214420817"><a name="zh-cn_topic_0000001127284836_p097214420817"></a><a name="zh-cn_topic_0000001127284836_p097214420817"></a>&lt;color&gt;</p>
235</td>
236<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p2097211443820"><a name="zh-cn_topic_0000001127284836_p2097211443820"></a><a name="zh-cn_topic_0000001127284836_p2097211443820"></a>transparent</p>
237</td>
238<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p11972204415818"><a name="zh-cn_topic_0000001127284836_p11972204415818"></a><a name="zh-cn_topic_0000001127284836_p11972204415818"></a>否</p>
239</td>
240<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p1397215441382"><a name="zh-cn_topic_0000001127284836_p1397215441382"></a><a name="zh-cn_topic_0000001127284836_p1397215441382"></a>item分隔线颜色,仅当list的divider属性为true时生效。</p>
241</td>
242</tr>
243<tr id="zh-cn_topic_0000001127284836_row391641412910"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p1098356680"><a name="zh-cn_topic_0000001127284836_p1098356680"></a><a name="zh-cn_topic_0000001127284836_p1098356680"></a>divider-height<sup id="zh-cn_topic_0000001127284836_sup19987635215"><a name="zh-cn_topic_0000001127284836_sup19987635215"></a><a name="zh-cn_topic_0000001127284836_sup19987635215"></a><span>5+</span></sup></p>
244</td>
245<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p149835619814"><a name="zh-cn_topic_0000001127284836_p149835619814"></a><a name="zh-cn_topic_0000001127284836_p149835619814"></a>&lt;length&gt;</p>
246</td>
247<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p1498145614817"><a name="zh-cn_topic_0000001127284836_p1498145614817"></a><a name="zh-cn_topic_0000001127284836_p1498145614817"></a>1</p>
248</td>
249<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p29815567820"><a name="zh-cn_topic_0000001127284836_p29815567820"></a><a name="zh-cn_topic_0000001127284836_p29815567820"></a>否</p>
250</td>
251<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p10983561383"><a name="zh-cn_topic_0000001127284836_p10983561383"></a><a name="zh-cn_topic_0000001127284836_p10983561383"></a>item分隔线高度,仅当list的divider属性为true时生效。</p>
252</td>
253</tr>
254<tr id="zh-cn_topic_0000001127284836_row28222110920"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p1144015414911"><a name="zh-cn_topic_0000001127284836_p1144015414911"></a><a name="zh-cn_topic_0000001127284836_p1144015414911"></a>divider-length<sup id="zh-cn_topic_0000001127284836_sup5326118102117"><a name="zh-cn_topic_0000001127284836_sup5326118102117"></a><a name="zh-cn_topic_0000001127284836_sup5326118102117"></a><span>5+</span></sup></p>
255</td>
256<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p3440174196"><a name="zh-cn_topic_0000001127284836_p3440174196"></a><a name="zh-cn_topic_0000001127284836_p3440174196"></a>&lt;length&gt;</p>
257</td>
258<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p0440741193"><a name="zh-cn_topic_0000001127284836_p0440741193"></a><a name="zh-cn_topic_0000001127284836_p0440741193"></a>主轴宽度</p>
259</td>
260<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p15440541997"><a name="zh-cn_topic_0000001127284836_p15440541997"></a><a name="zh-cn_topic_0000001127284836_p15440541997"></a>否</p>
261</td>
262<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p10440341697"><a name="zh-cn_topic_0000001127284836_p10440341697"></a><a name="zh-cn_topic_0000001127284836_p10440341697"></a>item分隔线长度,不设置时最大长度为主轴宽度,具体长度取决于divider-origin,仅当list的divider属性为true时生效。</p>
263</td>
264</tr>
265<tr id="zh-cn_topic_0000001127284836_row46441281390"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p1223216191395"><a name="zh-cn_topic_0000001127284836_p1223216191395"></a><a name="zh-cn_topic_0000001127284836_p1223216191395"></a>divider-origin<sup id="zh-cn_topic_0000001127284836_sup18714913122119"><a name="zh-cn_topic_0000001127284836_sup18714913122119"></a><a name="zh-cn_topic_0000001127284836_sup18714913122119"></a><span>5+</span></sup></p>
266</td>
267<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p1232161919915"><a name="zh-cn_topic_0000001127284836_p1232161919915"></a><a name="zh-cn_topic_0000001127284836_p1232161919915"></a>&lt;length&gt;</p>
268</td>
269<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p723231910913"><a name="zh-cn_topic_0000001127284836_p723231910913"></a><a name="zh-cn_topic_0000001127284836_p723231910913"></a>0</p>
270</td>
271<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p3232141916912"><a name="zh-cn_topic_0000001127284836_p3232141916912"></a><a name="zh-cn_topic_0000001127284836_p3232141916912"></a>否</p>
272</td>
273<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p42327191895"><a name="zh-cn_topic_0000001127284836_p42327191895"></a><a name="zh-cn_topic_0000001127284836_p42327191895"></a>item分隔线相对于item主轴起点位置的偏移量,仅当list的divider属性为true时生效。</p>
274</td>
275</tr>
276<tr id="zh-cn_topic_0000001127284836_row39106404819"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p11283866482"><a name="zh-cn_topic_0000001127284836_p11283866482"></a><a name="zh-cn_topic_0000001127284836_p11283866482"></a>flex-direction</p>
277</td>
278<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p7283162488"><a name="zh-cn_topic_0000001127284836_p7283162488"></a><a name="zh-cn_topic_0000001127284836_p7283162488"></a>string</p>
279<p id="zh-cn_topic_0000001127284836_p182831368480"><a name="zh-cn_topic_0000001127284836_p182831368480"></a><a name="zh-cn_topic_0000001127284836_p182831368480"></a></p>
280</td>
281<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p0283762488"><a name="zh-cn_topic_0000001127284836_p0283762488"></a><a name="zh-cn_topic_0000001127284836_p0283762488"></a>column</p>
282</td>
283<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p172837614485"><a name="zh-cn_topic_0000001127284836_p172837614485"></a><a name="zh-cn_topic_0000001127284836_p172837614485"></a>否</p>
284</td>
285<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p172837654814"><a name="zh-cn_topic_0000001127284836_p172837654814"></a><a name="zh-cn_topic_0000001127284836_p172837654814"></a>设置flex容器主轴的方向,指定flex项如何放置在flex容器中,可选值为:</p>
286<a name="zh-cn_topic_0000001127284836_ul132831763482"></a><a name="zh-cn_topic_0000001127284836_ul132831763482"></a><ul id="zh-cn_topic_0000001127284836_ul132831763482"><li>column:主轴为纵向。</li><li>row:主轴为横向。</li></ul>
287<p id="zh-cn_topic_0000001127284836_p132831263486"><a name="zh-cn_topic_0000001127284836_p132831263486"></a><a name="zh-cn_topic_0000001127284836_p132831263486"></a>其他组件默认值为row,在list组件中默认值为column。</p>
288</td>
289</tr>
290<tr id="zh-cn_topic_0000001127284836_row114441253204717"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p192847684817"><a name="zh-cn_topic_0000001127284836_p192847684817"></a><a name="zh-cn_topic_0000001127284836_p192847684817"></a>columns</p>
291</td>
292<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p92848613481"><a name="zh-cn_topic_0000001127284836_p92848613481"></a><a name="zh-cn_topic_0000001127284836_p92848613481"></a>number</p>
293</td>
294<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p1928410616485"><a name="zh-cn_topic_0000001127284836_p1928410616485"></a><a name="zh-cn_topic_0000001127284836_p1928410616485"></a>1</p>
295</td>
296<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p192844611485"><a name="zh-cn_topic_0000001127284836_p192844611485"></a><a name="zh-cn_topic_0000001127284836_p192844611485"></a>否</p>
297</td>
298<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p1928418624820"><a name="zh-cn_topic_0000001127284836_p1928418624820"></a><a name="zh-cn_topic_0000001127284836_p1928418624820"></a>list交叉轴方向的显示列数,默认为1列。</p>
299<div class="note" id="zh-cn_topic_0000001127284836_note87762014175811"><a name="zh-cn_topic_0000001127284836_note87762014175811"></a><a name="zh-cn_topic_0000001127284836_note87762014175811"></a><span class="notetitle"> 说明: </span><div class="notebody"><p id="zh-cn_topic_0000001127284836_p157761214205810"><a name="zh-cn_topic_0000001127284836_p157761214205810"></a><a name="zh-cn_topic_0000001127284836_p157761214205810"></a>设置多列时,在list交叉轴上进行均分,每一列大小相同。</p>
300</div></div>
301</td>
302</tr>
303<tr id="zh-cn_topic_0000001127284836_row2220195185518"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p12617942184311"><a name="zh-cn_topic_0000001127284836_p12617942184311"></a><a name="zh-cn_topic_0000001127284836_p12617942184311"></a>align-items</p>
304</td>
305<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p15617194264312"><a name="zh-cn_topic_0000001127284836_p15617194264312"></a><a name="zh-cn_topic_0000001127284836_p15617194264312"></a>string</p>
306</td>
307<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p061744213433"><a name="zh-cn_topic_0000001127284836_p061744213433"></a><a name="zh-cn_topic_0000001127284836_p061744213433"></a>stretch</p>
308</td>
309<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p12617154214437"><a name="zh-cn_topic_0000001127284836_p12617154214437"></a><a name="zh-cn_topic_0000001127284836_p12617154214437"></a>否</p>
310</td>
311<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p9617542124318"><a name="zh-cn_topic_0000001127284836_p9617542124318"></a><a name="zh-cn_topic_0000001127284836_p9617542124318"></a>list每一列交叉轴上的对齐格式,可选值为:</p>
312<a name="zh-cn_topic_0000001127284836_ul166171442134312"></a><a name="zh-cn_topic_0000001127284836_ul166171442134312"></a><ul id="zh-cn_topic_0000001127284836_ul166171442134312"><li>stretch:弹性元素被在交叉轴方向被拉伸到与容器相同的高度或宽度。</li><li>flex-start:元素向交叉轴起点对齐。</li><li>flex-end:元素向交叉轴终点对齐。</li><li>center:元素在交叉轴居中。<div class="note" id="zh-cn_topic_0000001127284836_note10891229703"><a name="zh-cn_topic_0000001127284836_note10891229703"></a><a name="zh-cn_topic_0000001127284836_note10891229703"></a><span class="notetitle"> 说明: </span><div class="notebody"><p id="zh-cn_topic_0000001127284836_p18891029105"><a name="zh-cn_topic_0000001127284836_p18891029105"></a><a name="zh-cn_topic_0000001127284836_p18891029105"></a>align-items样式作用在每一列的子元素上,列与列之间采用均分方式布局。</p>
313</div></div>
314</li></ul>
315</td>
316</tr>
317<tr id="zh-cn_topic_0000001127284836_row487325034719"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p2028420617487"><a name="zh-cn_topic_0000001127284836_p2028420617487"></a><a name="zh-cn_topic_0000001127284836_p2028420617487"></a>item-extent</p>
318</td>
319<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p828496164810"><a name="zh-cn_topic_0000001127284836_p828496164810"></a><a name="zh-cn_topic_0000001127284836_p828496164810"></a>&lt;length&gt; | &lt;percentage&gt;</p>
320</td>
321<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p928413644818"><a name="zh-cn_topic_0000001127284836_p928413644818"></a><a name="zh-cn_topic_0000001127284836_p928413644818"></a>-</p>
322</td>
323<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p2028416134815"><a name="zh-cn_topic_0000001127284836_p2028416134815"></a><a name="zh-cn_topic_0000001127284836_p2028416134815"></a>否</p>
324</td>
325<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p18284660488"><a name="zh-cn_topic_0000001127284836_p18284660488"></a><a name="zh-cn_topic_0000001127284836_p18284660488"></a>设置内部item为固定大小,设置为百分比格式时,指相对于list的视口主轴方向长度的百分比。</p>
326</td>
327</tr>
328<tr id="zh-cn_topic_0000001127284836_row99041447114713"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p172840624815"><a name="zh-cn_topic_0000001127284836_p172840624815"></a><a name="zh-cn_topic_0000001127284836_p172840624815"></a>fade-color</p>
329</td>
330<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p132851863484"><a name="zh-cn_topic_0000001127284836_p132851863484"></a><a name="zh-cn_topic_0000001127284836_p132851863484"></a><span>&lt;</span><span>color</span><span>&gt;</span></p>
331</td>
332<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p1728506174819"><a name="zh-cn_topic_0000001127284836_p1728506174819"></a><a name="zh-cn_topic_0000001127284836_p1728506174819"></a>grey</p>
333</td>
334<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p22852060481"><a name="zh-cn_topic_0000001127284836_p22852060481"></a><a name="zh-cn_topic_0000001127284836_p22852060481"></a>否</p>
335</td>
336<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p428518694818"><a name="zh-cn_topic_0000001127284836_p428518694818"></a><a name="zh-cn_topic_0000001127284836_p428518694818"></a>设置渐隐物理动效的颜色。当滑动效果设置为渐隐物理动效时生效。</p>
337</td>
338</tr>
339<tr id="zh-cn_topic_0000001127284836_row023410442716"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p829911534213"><a name="zh-cn_topic_0000001127284836_p829911534213"></a><a name="zh-cn_topic_0000001127284836_p829911534213"></a>scrollbar-color<sup id="zh-cn_topic_0000001127284836_sup843916381239"><a name="zh-cn_topic_0000001127284836_sup843916381239"></a><a name="zh-cn_topic_0000001127284836_sup843916381239"></a>6+</sup></p>
340</td>
341<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p122991553112113"><a name="zh-cn_topic_0000001127284836_p122991553112113"></a><a name="zh-cn_topic_0000001127284836_p122991553112113"></a>&lt;color&gt;</p>
342</td>
343<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p17299253132120"><a name="zh-cn_topic_0000001127284836_p17299253132120"></a><a name="zh-cn_topic_0000001127284836_p17299253132120"></a>-</p>
344</td>
345<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p9299135342110"><a name="zh-cn_topic_0000001127284836_p9299135342110"></a><a name="zh-cn_topic_0000001127284836_p9299135342110"></a>否</p>
346</td>
347<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p14300165317215"><a name="zh-cn_topic_0000001127284836_p14300165317215"></a><a name="zh-cn_topic_0000001127284836_p14300165317215"></a>设置滚动条的颜色。</p>
348</td>
349</tr>
350<tr id="zh-cn_topic_0000001127284836_row1117810274"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p1433575912212"><a name="zh-cn_topic_0000001127284836_p1433575912212"></a><a name="zh-cn_topic_0000001127284836_p1433575912212"></a>scrollbar-width<sup id="zh-cn_topic_0000001127284836_sup10700174022317"><a name="zh-cn_topic_0000001127284836_sup10700174022317"></a><a name="zh-cn_topic_0000001127284836_sup10700174022317"></a>6+</sup></p>
351</td>
352<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p3335165919217"><a name="zh-cn_topic_0000001127284836_p3335165919217"></a><a name="zh-cn_topic_0000001127284836_p3335165919217"></a>&lt;length&gt;</p>
353</td>
354<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p6335175914219"><a name="zh-cn_topic_0000001127284836_p6335175914219"></a><a name="zh-cn_topic_0000001127284836_p6335175914219"></a>-</p>
355</td>
356<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p13335759172115"><a name="zh-cn_topic_0000001127284836_p13335759172115"></a><a name="zh-cn_topic_0000001127284836_p13335759172115"></a>否</p>
357</td>
358<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p533510595217"><a name="zh-cn_topic_0000001127284836_p533510595217"></a><a name="zh-cn_topic_0000001127284836_p533510595217"></a>设置滚动条的宽度。</p>
359</td>
360</tr>
361<tr id="zh-cn_topic_0000001127284836_row11452128142314"><td class="cellrowborder" valign="top" width="23.11768823117688%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001127284836_p99726914238"><a name="zh-cn_topic_0000001127284836_p99726914238"></a><a name="zh-cn_topic_0000001127284836_p99726914238"></a>scrollbar-offset<sup id="zh-cn_topic_0000001127284836_sup697216902311"><a name="zh-cn_topic_0000001127284836_sup697216902311"></a><a name="zh-cn_topic_0000001127284836_sup697216902311"></a>6+</sup></p>
362</td>
363<td class="cellrowborder" valign="top" width="20.477952204779523%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001127284836_p119725918233"><a name="zh-cn_topic_0000001127284836_p119725918233"></a><a name="zh-cn_topic_0000001127284836_p119725918233"></a>&lt;length&gt;</p>
364</td>
365<td class="cellrowborder" valign="top" width="8.869113088691131%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001127284836_p79725972313"><a name="zh-cn_topic_0000001127284836_p79725972313"></a><a name="zh-cn_topic_0000001127284836_p79725972313"></a>0</p>
366</td>
367<td class="cellrowborder" valign="top" width="7.519248075192481%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001127284836_p1297210918239"><a name="zh-cn_topic_0000001127284836_p1297210918239"></a><a name="zh-cn_topic_0000001127284836_p1297210918239"></a>否</p>
368</td>
369<td class="cellrowborder" valign="top" width="40.01599840015999%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001127284836_p17972694239"><a name="zh-cn_topic_0000001127284836_p17972694239"></a><a name="zh-cn_topic_0000001127284836_p17972694239"></a>设置滚动条距离List默认位置的偏移量,只支持正数,默认位置在List右边缘,可以通过这个偏移量调整滚动条的水平位置,如果滚动条绘制在list外部,而list父组件有裁剪,会导致滚动条被裁剪。</p>
370</td>
371</tr>
372</tbody>
373</table>
374
375## 事件<a name="zh-cn_topic_0000001127284836_section471854810515"></a>
376
377除支持[通用事件](js-components-common-events.md)外,还支持如下事件:
378
379<a name="zh-cn_topic_0000001127284836_table12718648205119"></a>
380<table><thead align="left"><tr id="zh-cn_topic_0000001127284836_row17185480518"><th class="cellrowborder" valign="top" width="24.852485248524854%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001127284836_p14718114825114"><a name="zh-cn_topic_0000001127284836_p14718114825114"></a><a name="zh-cn_topic_0000001127284836_p14718114825114"></a>名称</p>
381</th>
382<th class="cellrowborder" valign="top" width="29.552955295529554%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001127284836_p137181948105111"><a name="zh-cn_topic_0000001127284836_p137181948105111"></a><a name="zh-cn_topic_0000001127284836_p137181948105111"></a>参数</p>
383</th>
384<th class="cellrowborder" valign="top" width="45.5945594559456%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001127284836_p18718164812518"><a name="zh-cn_topic_0000001127284836_p18718164812518"></a><a name="zh-cn_topic_0000001127284836_p18718164812518"></a>描述</p>
385</th>
386</tr>
387</thead>
388<tbody><tr id="zh-cn_topic_0000001127284836_row0718194813519"><td class="cellrowborder" valign="top" width="24.852485248524854%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001127284836_p971894825110"><a name="zh-cn_topic_0000001127284836_p971894825110"></a><a name="zh-cn_topic_0000001127284836_p971894825110"></a>indexerchange<sup id="zh-cn_topic_0000001127284836_sup27189486514"><a name="zh-cn_topic_0000001127284836_sup27189486514"></a><a name="zh-cn_topic_0000001127284836_sup27189486514"></a><span>5+</span></sup></p>
389</td>
390<td class="cellrowborder" valign="top" width="29.552955295529554%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001127284836_p197191148155114"><a name="zh-cn_topic_0000001127284836_p197191148155114"></a><a name="zh-cn_topic_0000001127284836_p197191148155114"></a>{ local: booleanValue }</p>
391</td>
392<td class="cellrowborder" valign="top" width="45.5945594559456%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001127284836_p1871920489510"><a name="zh-cn_topic_0000001127284836_p1871920489510"></a><a name="zh-cn_topic_0000001127284836_p1871920489510"></a>多语言索引条切换事件,仅当indexer属性为true,indexermulti为true时生效。booleanValue可能值为true或者false:</p>
393<a name="zh-cn_topic_0000001127284836_ul18719104820516"></a><a name="zh-cn_topic_0000001127284836_ul18719104820516"></a><ul id="zh-cn_topic_0000001127284836_ul18719104820516"><li>true: 当前展示本地索引。</li><li>false: 当前展示字母索引。</li></ul>
394</td>
395</tr>
396<tr id="zh-cn_topic_0000001127284836_row4719114805113"><td class="cellrowborder" valign="top" width="24.852485248524854%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001127284836_p157191048155110"><a name="zh-cn_topic_0000001127284836_p157191048155110"></a><a name="zh-cn_topic_0000001127284836_p157191048155110"></a>scroll</p>
397</td>
398<td class="cellrowborder" valign="top" width="29.552955295529554%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001127284836_p177191548175111"><a name="zh-cn_topic_0000001127284836_p177191548175111"></a><a name="zh-cn_topic_0000001127284836_p177191548175111"></a>{ scrollX: scrollXValue, scrollY: scrollYValue, scrollState: stateValue }</p>
399</td>
400<td class="cellrowborder" valign="top" width="45.5945594559456%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001127284836_p1571914895114"><a name="zh-cn_topic_0000001127284836_p1571914895114"></a><a name="zh-cn_topic_0000001127284836_p1571914895114"></a>列表滑动的偏移量和状态回调。</p>
401<p id="zh-cn_topic_0000001127284836_p13719164815112"><a name="zh-cn_topic_0000001127284836_p13719164815112"></a><a name="zh-cn_topic_0000001127284836_p13719164815112"></a>stateValue: 0表示列表滑动已经停止。</p>
402<p id="zh-cn_topic_0000001127284836_p1719154885113"><a name="zh-cn_topic_0000001127284836_p1719154885113"></a><a name="zh-cn_topic_0000001127284836_p1719154885113"></a>stateValue: 1表示列表正在用户触摸状态下滑动。</p>
403<p id="zh-cn_topic_0000001127284836_p8719148105112"><a name="zh-cn_topic_0000001127284836_p8719148105112"></a><a name="zh-cn_topic_0000001127284836_p8719148105112"></a>stateValue: 2表示列表正在用户松手状态下滑动。</p>
404</td>
405</tr>
406<tr id="zh-cn_topic_0000001127284836_row1371954819511"><td class="cellrowborder" valign="top" width="24.852485248524854%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001127284836_p671984817514"><a name="zh-cn_topic_0000001127284836_p671984817514"></a><a name="zh-cn_topic_0000001127284836_p671984817514"></a>scrollbottom</p>
407</td>
408<td class="cellrowborder" valign="top" width="29.552955295529554%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001127284836_p1971944810515"><a name="zh-cn_topic_0000001127284836_p1971944810515"></a><a name="zh-cn_topic_0000001127284836_p1971944810515"></a>-</p>
409</td>
410<td class="cellrowborder" valign="top" width="45.5945594559456%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001127284836_p371984855113"><a name="zh-cn_topic_0000001127284836_p371984855113"></a><a name="zh-cn_topic_0000001127284836_p371984855113"></a>当前列表已滑动到底部位置。</p>
411</td>
412</tr>
413<tr id="zh-cn_topic_0000001127284836_row1671944812519"><td class="cellrowborder" valign="top" width="24.852485248524854%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001127284836_p971919481515"><a name="zh-cn_topic_0000001127284836_p971919481515"></a><a name="zh-cn_topic_0000001127284836_p971919481515"></a>scrolltop</p>
414</td>
415<td class="cellrowborder" valign="top" width="29.552955295529554%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001127284836_p12719348135112"><a name="zh-cn_topic_0000001127284836_p12719348135112"></a><a name="zh-cn_topic_0000001127284836_p12719348135112"></a>-</p>
416</td>
417<td class="cellrowborder" valign="top" width="45.5945594559456%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001127284836_p127193483517"><a name="zh-cn_topic_0000001127284836_p127193483517"></a><a name="zh-cn_topic_0000001127284836_p127193483517"></a>当前列表已滑动到顶部位置。</p>
418</td>
419</tr>
420<tr id="zh-cn_topic_0000001127284836_row17209489513"><td class="cellrowborder" valign="top" width="24.852485248524854%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001127284836_p672034817518"><a name="zh-cn_topic_0000001127284836_p672034817518"></a><a name="zh-cn_topic_0000001127284836_p672034817518"></a>scrollend</p>
421</td>
422<td class="cellrowborder" valign="top" width="29.552955295529554%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001127284836_p67202487511"><a name="zh-cn_topic_0000001127284836_p67202487511"></a><a name="zh-cn_topic_0000001127284836_p67202487511"></a>-</p>
423</td>
424<td class="cellrowborder" valign="top" width="45.5945594559456%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001127284836_p1472054895112"><a name="zh-cn_topic_0000001127284836_p1472054895112"></a><a name="zh-cn_topic_0000001127284836_p1472054895112"></a>列表滑动已经结束。</p>
425</td>
426</tr>
427<tr id="zh-cn_topic_0000001127284836_row27207484515"><td class="cellrowborder" valign="top" width="24.852485248524854%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001127284836_p67201048125114"><a name="zh-cn_topic_0000001127284836_p67201048125114"></a><a name="zh-cn_topic_0000001127284836_p67201048125114"></a>scrolltouchup</p>
428</td>
429<td class="cellrowborder" valign="top" width="29.552955295529554%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001127284836_p1720164814510"><a name="zh-cn_topic_0000001127284836_p1720164814510"></a><a name="zh-cn_topic_0000001127284836_p1720164814510"></a>-</p>
430</td>
431<td class="cellrowborder" valign="top" width="45.5945594559456%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001127284836_p17720548105118"><a name="zh-cn_topic_0000001127284836_p17720548105118"></a><a name="zh-cn_topic_0000001127284836_p17720548105118"></a>手指已经抬起且列表仍在惯性滑动。</p>
432</td>
433</tr>
434<tr id="zh-cn_topic_0000001127284836_row18720104812512"><td class="cellrowborder" valign="top" width="24.852485248524854%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001127284836_p14720174820515"><a name="zh-cn_topic_0000001127284836_p14720174820515"></a><a name="zh-cn_topic_0000001127284836_p14720174820515"></a>requestitem</p>
435</td>
436<td class="cellrowborder" valign="top" width="29.552955295529554%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001127284836_p572034875112"><a name="zh-cn_topic_0000001127284836_p572034875112"></a><a name="zh-cn_topic_0000001127284836_p572034875112"></a>-</p>
437</td>
438<td class="cellrowborder" valign="top" width="45.5945594559456%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001127284836_p272034815115"><a name="zh-cn_topic_0000001127284836_p272034815115"></a><a name="zh-cn_topic_0000001127284836_p272034815115"></a>请求创建新的list-item。</p>
439<p id="zh-cn_topic_0000001127284836_p1372014820516"><a name="zh-cn_topic_0000001127284836_p1372014820516"></a><a name="zh-cn_topic_0000001127284836_p1372014820516"></a>长列表延迟加载时,可视区域外缓存的list-item数量少于cachedcount时,会触发该事件。</p>
440</td>
441</tr>
442<tr id="zh-cn_topic_0000001127284836_row16353171781416"><td class="cellrowborder" valign="top" width="24.852485248524854%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001127284836_p13354161718142"><a name="zh-cn_topic_0000001127284836_p13354161718142"></a><a name="zh-cn_topic_0000001127284836_p13354161718142"></a>rotation<sup id="zh-cn_topic_0000001127284836_sup915919368206"><a name="zh-cn_topic_0000001127284836_sup915919368206"></a><a name="zh-cn_topic_0000001127284836_sup915919368206"></a>7+</sup></p>
443</td>
444<td class="cellrowborder" valign="top" width="29.552955295529554%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001127284836_p1135419179146"><a name="zh-cn_topic_0000001127284836_p1135419179146"></a><a name="zh-cn_topic_0000001127284836_p1135419179146"></a>{ rotateValue: number }</p>
445</td>
446<td class="cellrowborder" valign="top" width="45.5945594559456%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001127284836_p1835471721415"><a name="zh-cn_topic_0000001127284836_p1835471721415"></a><a name="zh-cn_topic_0000001127284836_p1835471721415"></a>返回表冠旋转角度增量值,仅智能穿戴支持。</p>
447</td>
448</tr>
449</tbody>
450</table>
451
452## 方法<a name="zh-cn_topic_0000001127284836_section47669296127"></a>
453
454支持[通用方法](js-components-common-methods.md)外,还支持如下方法:
455
456<a name="zh-cn_topic_0000001127284836_t0c307a0cf3734cb28f3adf6af246a486"></a>
457<table><thead align="left"><tr id="zh-cn_topic_0000001127284836_r83b0c5b4f4b54874b1b3d7a36bcfa36b"><th class="cellrowborder" valign="top" width="14.09%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001127284836_af4002018158a424c9fe9ad1a0e8a395f"><a name="zh-cn_topic_0000001127284836_af4002018158a424c9fe9ad1a0e8a395f"></a><a name="zh-cn_topic_0000001127284836_af4002018158a424c9fe9ad1a0e8a395f"></a>名称</p>
458</th>
459<th class="cellrowborder" valign="top" width="34.910000000000004%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001127284836_a08987b2b1bc34babb92dd601235b0e24"><a name="zh-cn_topic_0000001127284836_a08987b2b1bc34babb92dd601235b0e24"></a><a name="zh-cn_topic_0000001127284836_a08987b2b1bc34babb92dd601235b0e24"></a>参数</p>
460</th>
461<th class="cellrowborder" valign="top" width="51%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001127284836_a5e3e3d76323a4ebe96e1bdb1d1c338eb"><a name="zh-cn_topic_0000001127284836_a5e3e3d76323a4ebe96e1bdb1d1c338eb"></a><a name="zh-cn_topic_0000001127284836_a5e3e3d76323a4ebe96e1bdb1d1c338eb"></a>描述</p>
462</th>
463</tr>
464</thead>
465<tbody><tr id="zh-cn_topic_0000001127284836_r6eb16143d32645c2ae58f1e4857b0d99"><td class="cellrowborder" valign="top" width="14.09%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001127284836_a16f9fd69364541c3bf57f9b2305ba51f"><a name="zh-cn_topic_0000001127284836_a16f9fd69364541c3bf57f9b2305ba51f"></a><a name="zh-cn_topic_0000001127284836_a16f9fd69364541c3bf57f9b2305ba51f"></a>scrollTo</p>
466</td>
467<td class="cellrowborder" valign="top" width="34.910000000000004%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001127284836_abfb4febc1ae4429b8f593e96c50c9bc7"><a name="zh-cn_topic_0000001127284836_abfb4febc1ae4429b8f593e96c50c9bc7"></a><a name="zh-cn_topic_0000001127284836_abfb4febc1ae4429b8f593e96c50c9bc7"></a>{ index: number(指定位置) }</p>
468</td>
469<td class="cellrowborder" valign="top" width="51%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001127284836_a75c53230ef704966b5b25d2e2606584f"><a name="zh-cn_topic_0000001127284836_a75c53230ef704966b5b25d2e2606584f"></a><a name="zh-cn_topic_0000001127284836_a75c53230ef704966b5b25d2e2606584f"></a>list滑动到指定index的item位置。</p>
470</td>
471</tr>
472<tr id="zh-cn_topic_0000001127284836_r9c30e9310fb349a4bf157e92668927fc"><td class="cellrowborder" valign="top" width="14.09%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001127284836_a8ce0c025f94046a89cfe7a3d4e20d802"><a name="zh-cn_topic_0000001127284836_a8ce0c025f94046a89cfe7a3d4e20d802"></a><a name="zh-cn_topic_0000001127284836_a8ce0c025f94046a89cfe7a3d4e20d802"></a>scrollBy</p>
473</td>
474<td class="cellrowborder" valign="top" width="34.910000000000004%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001127284836_ae74f4613d9a44d7f890b38e10b61e249"><a name="zh-cn_topic_0000001127284836_ae74f4613d9a44d7f890b38e10b61e249"></a><a name="zh-cn_topic_0000001127284836_ae74f4613d9a44d7f890b38e10b61e249"></a><a href="#zh-cn_topic_0000001127284836_t54327f53ea104788bc430b9047ecb47b">ScrollParam</a></p>
475</td>
476<td class="cellrowborder" valign="top" width="51%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001127284836_a5a3997da89d649f0ac1c71461d953294"><a name="zh-cn_topic_0000001127284836_a5a3997da89d649f0ac1c71461d953294"></a><a name="zh-cn_topic_0000001127284836_a5a3997da89d649f0ac1c71461d953294"></a>触发list滑动一段距离。</p>
477<p id="zh-cn_topic_0000001127284836_a0767362b2b4a4535a06cb42e483b14cd"><a name="zh-cn_topic_0000001127284836_a0767362b2b4a4535a06cb42e483b14cd"></a><a name="zh-cn_topic_0000001127284836_a0767362b2b4a4535a06cb42e483b14cd"></a>智慧屏特有方法。</p>
478</td>
479</tr>
480<tr id="zh-cn_topic_0000001127284836_row10674141618528"><td class="cellrowborder" valign="top" width="14.09%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001127284836_p1166501614521"><a name="zh-cn_topic_0000001127284836_p1166501614521"></a><a name="zh-cn_topic_0000001127284836_p1166501614521"></a>scrollTop</p>
481</td>
482<td class="cellrowborder" valign="top" width="34.910000000000004%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001127284836_p13665201655211"><a name="zh-cn_topic_0000001127284836_p13665201655211"></a><a name="zh-cn_topic_0000001127284836_p13665201655211"></a>{ smooth: boolean }</p>
483</td>
484<td class="cellrowborder" valign="top" width="51%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001127284836_p1466520168521"><a name="zh-cn_topic_0000001127284836_p1466520168521"></a><a name="zh-cn_topic_0000001127284836_p1466520168521"></a>smooth缺省为false,表示直接滚动到顶部。</p>
485<p id="zh-cn_topic_0000001127284836_p1166519160524"><a name="zh-cn_topic_0000001127284836_p1166519160524"></a><a name="zh-cn_topic_0000001127284836_p1166519160524"></a>smooth为true,表示平滑滚动到顶部。</p>
486</td>
487</tr>
488<tr id="zh-cn_topic_0000001127284836_row1067461665217"><td class="cellrowborder" valign="top" width="14.09%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001127284836_p96651616195214"><a name="zh-cn_topic_0000001127284836_p96651616195214"></a><a name="zh-cn_topic_0000001127284836_p96651616195214"></a>scrollBottom</p>
489</td>
490<td class="cellrowborder" valign="top" width="34.910000000000004%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001127284836_p566501617522"><a name="zh-cn_topic_0000001127284836_p566501617522"></a><a name="zh-cn_topic_0000001127284836_p566501617522"></a>{ smooth: boolean }</p>
491</td>
492<td class="cellrowborder" valign="top" width="51%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001127284836_p1966571635219"><a name="zh-cn_topic_0000001127284836_p1966571635219"></a><a name="zh-cn_topic_0000001127284836_p1966571635219"></a>smooth缺省为false,表示直接滚动到底部。</p>
493<p id="zh-cn_topic_0000001127284836_p1566513161529"><a name="zh-cn_topic_0000001127284836_p1566513161529"></a><a name="zh-cn_topic_0000001127284836_p1566513161529"></a>smooth为true,表示平滑滚动到底部。</p>
494</td>
495</tr>
496<tr id="zh-cn_topic_0000001127284836_row667481665218"><td class="cellrowborder" valign="top" width="14.09%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001127284836_p966520161520"><a name="zh-cn_topic_0000001127284836_p966520161520"></a><a name="zh-cn_topic_0000001127284836_p966520161520"></a>scrollPage</p>
497</td>
498<td class="cellrowborder" valign="top" width="34.910000000000004%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001127284836_p1166551610522"><a name="zh-cn_topic_0000001127284836_p1166551610522"></a><a name="zh-cn_topic_0000001127284836_p1166551610522"></a>{ reverse: boolean, smooth: boolean }</p>
499</td>
500<td class="cellrowborder" valign="top" width="51%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001127284836_p156651016205211"><a name="zh-cn_topic_0000001127284836_p156651016205211"></a><a name="zh-cn_topic_0000001127284836_p156651016205211"></a>reverse缺省值为false,表示下一页,无完整页则滚动到底部。</p>
501<p id="zh-cn_topic_0000001127284836_p11665141617522"><a name="zh-cn_topic_0000001127284836_p11665141617522"></a><a name="zh-cn_topic_0000001127284836_p11665141617522"></a>reverse为true,表示上一页,无完整页则滚动到顶部。</p>
502<p id="zh-cn_topic_0000001127284836_p466513161522"><a name="zh-cn_topic_0000001127284836_p466513161522"></a><a name="zh-cn_topic_0000001127284836_p466513161522"></a>smooth缺省值为false,表示直接滚动一页。</p>
503<p id="zh-cn_topic_0000001127284836_p5665131615528"><a name="zh-cn_topic_0000001127284836_p5665131615528"></a><a name="zh-cn_topic_0000001127284836_p5665131615528"></a>smooth为true,表示平滑滚动一页。</p>
504</td>
505</tr>
506<tr id="zh-cn_topic_0000001127284836_row13674616205216"><td class="cellrowborder" valign="top" width="14.09%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001127284836_p176652164528"><a name="zh-cn_topic_0000001127284836_p176652164528"></a><a name="zh-cn_topic_0000001127284836_p176652164528"></a>scrollArrow</p>
507</td>
508<td class="cellrowborder" valign="top" width="34.910000000000004%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001127284836_p166513161529"><a name="zh-cn_topic_0000001127284836_p166513161529"></a><a name="zh-cn_topic_0000001127284836_p166513161529"></a>{ reverse: boolean, smooth: boolean }</p>
509</td>
510<td class="cellrowborder" valign="top" width="51%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001127284836_p1966551617521"><a name="zh-cn_topic_0000001127284836_p1966551617521"></a><a name="zh-cn_topic_0000001127284836_p1966551617521"></a>reverse缺省值为false,表示向底部方向滑动一段距离,无足够距离则滚动到底部。</p>
511<p id="zh-cn_topic_0000001127284836_p266511168524"><a name="zh-cn_topic_0000001127284836_p266511168524"></a><a name="zh-cn_topic_0000001127284836_p266511168524"></a>reverse为true,表示向顶部方向滑动一段距离,无足够距离则滚动到顶部。</p>
512<p id="zh-cn_topic_0000001127284836_p466510161529"><a name="zh-cn_topic_0000001127284836_p466510161529"></a><a name="zh-cn_topic_0000001127284836_p466510161529"></a>smooth缺省值为false,表示直接滚动。</p>
513<p id="zh-cn_topic_0000001127284836_p966561612526"><a name="zh-cn_topic_0000001127284836_p966561612526"></a><a name="zh-cn_topic_0000001127284836_p966561612526"></a>smooth为true,表示平滑滚动。</p>
514</td>
515</tr>
516<tr id="zh-cn_topic_0000001127284836_row146741516135215"><td class="cellrowborder" valign="top" width="14.09%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001127284836_p16666161613523"><a name="zh-cn_topic_0000001127284836_p16666161613523"></a><a name="zh-cn_topic_0000001127284836_p16666161613523"></a>collapseGroup</p>
517</td>
518<td class="cellrowborder" valign="top" width="34.910000000000004%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001127284836_p466641685216"><a name="zh-cn_topic_0000001127284836_p466641685216"></a><a name="zh-cn_topic_0000001127284836_p466641685216"></a>{ groupid: string }</p>
519</td>
520<td class="cellrowborder" valign="top" width="51%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001127284836_p206661165523"><a name="zh-cn_topic_0000001127284836_p206661165523"></a><a name="zh-cn_topic_0000001127284836_p206661165523"></a>收拢指定的group。</p>
521<p id="zh-cn_topic_0000001127284836_p15666516205215"><a name="zh-cn_topic_0000001127284836_p15666516205215"></a><a name="zh-cn_topic_0000001127284836_p15666516205215"></a>groupid:需要收拢的group的id。</p>
522<p id="zh-cn_topic_0000001127284836_p1566613167526"><a name="zh-cn_topic_0000001127284836_p1566613167526"></a><a name="zh-cn_topic_0000001127284836_p1566613167526"></a>当groupid未指定时收拢所有的group。</p>
523</td>
524</tr>
525<tr id="zh-cn_topic_0000001127284836_row2674171665212"><td class="cellrowborder" valign="top" width="14.09%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001127284836_p16666716155214"><a name="zh-cn_topic_0000001127284836_p16666716155214"></a><a name="zh-cn_topic_0000001127284836_p16666716155214"></a>expandGroup</p>
526</td>
527<td class="cellrowborder" valign="top" width="34.910000000000004%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001127284836_p1466681665219"><a name="zh-cn_topic_0000001127284836_p1466681665219"></a><a name="zh-cn_topic_0000001127284836_p1466681665219"></a>{ groupid: string }</p>
528</td>
529<td class="cellrowborder" valign="top" width="51%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001127284836_p11666816135210"><a name="zh-cn_topic_0000001127284836_p11666816135210"></a><a name="zh-cn_topic_0000001127284836_p11666816135210"></a>展开指定的group。</p>
530<p id="zh-cn_topic_0000001127284836_p1766615169528"><a name="zh-cn_topic_0000001127284836_p1766615169528"></a><a name="zh-cn_topic_0000001127284836_p1766615169528"></a>groupid:需要展开的group的id。</p>
531<p id="zh-cn_topic_0000001127284836_p1766616164528"><a name="zh-cn_topic_0000001127284836_p1766616164528"></a><a name="zh-cn_topic_0000001127284836_p1766616164528"></a>当groupid未指定时展开所有的group。</p>
532</td>
533</tr>
534<tr id="zh-cn_topic_0000001127284836_row9562194955312"><td class="cellrowborder" valign="top" width="14.09%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001127284836_p4562174912536"><a name="zh-cn_topic_0000001127284836_p4562174912536"></a><a name="zh-cn_topic_0000001127284836_p4562174912536"></a>currentOffset</p>
535</td>
536<td class="cellrowborder" valign="top" width="34.910000000000004%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001127284836_p5562449185318"><a name="zh-cn_topic_0000001127284836_p5562449185318"></a><a name="zh-cn_topic_0000001127284836_p5562449185318"></a>-</p>
537</td>
538<td class="cellrowborder" valign="top" width="51%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001127284836_p8563144914534"><a name="zh-cn_topic_0000001127284836_p8563144914534"></a><a name="zh-cn_topic_0000001127284836_p8563144914534"></a>返回当前滑动的偏移量。返回值类型是Object,返回值说明请见<a href="#zh-cn_topic_0000001127284836_table1145513617576">表2</a>。</p>
539</td>
540</tr>
541</tbody>
542</table>
543
544**表 1**  ScrollParam
545
546<a name="zh-cn_topic_0000001127284836_t54327f53ea104788bc430b9047ecb47b"></a>
547<table><thead align="left"><tr id="zh-cn_topic_0000001127284836_r6bc769560d884ebca11d7ef155cfc00c"><th class="cellrowborder" valign="top" width="12.000000000000002%" id="mcps1.2.6.1.1"><p id="zh-cn_topic_0000001127284836_a2b340d5b063045f9b972339877932f7d"><a name="zh-cn_topic_0000001127284836_a2b340d5b063045f9b972339877932f7d"></a><a name="zh-cn_topic_0000001127284836_a2b340d5b063045f9b972339877932f7d"></a>名称</p>
548</th>
549<th class="cellrowborder" valign="top" width="22.000000000000004%" id="mcps1.2.6.1.2"><p id="zh-cn_topic_0000001127284836_a9710da1e083c4c4980317ab1772446a1"><a name="zh-cn_topic_0000001127284836_a9710da1e083c4c4980317ab1772446a1"></a><a name="zh-cn_topic_0000001127284836_a9710da1e083c4c4980317ab1772446a1"></a>类型</p>
550</th>
551<th class="cellrowborder" valign="top" width="24.000000000000004%" id="mcps1.2.6.1.3"><p id="zh-cn_topic_0000001127284836_a273155109e9b41b1876c7b4944800ee4"><a name="zh-cn_topic_0000001127284836_a273155109e9b41b1876c7b4944800ee4"></a><a name="zh-cn_topic_0000001127284836_a273155109e9b41b1876c7b4944800ee4"></a>是否必选</p>
552</th>
553<th class="cellrowborder" valign="top" width="21.000000000000004%" id="mcps1.2.6.1.4"><p id="zh-cn_topic_0000001127284836_ae31408099fa24514bac47cf09a9e7b1a"><a name="zh-cn_topic_0000001127284836_ae31408099fa24514bac47cf09a9e7b1a"></a><a name="zh-cn_topic_0000001127284836_ae31408099fa24514bac47cf09a9e7b1a"></a>默认值</p>
554</th>
555<th class="cellrowborder" valign="top" width="21.000000000000004%" id="mcps1.2.6.1.5"><p id="zh-cn_topic_0000001127284836_a333063706a09429cbe9ac81130d2b6cc"><a name="zh-cn_topic_0000001127284836_a333063706a09429cbe9ac81130d2b6cc"></a><a name="zh-cn_topic_0000001127284836_a333063706a09429cbe9ac81130d2b6cc"></a>备注</p>
556</th>
557</tr>
558</thead>
559<tbody><tr id="zh-cn_topic_0000001127284836_r6d4c75c9670d49ada849ec9f6bef83dd"><td class="cellrowborder" valign="top" width="12.000000000000002%" headers="mcps1.2.6.1.1 "><p id="zh-cn_topic_0000001127284836_ac4d9ce9a62d9442cb65658878f44e018"><a name="zh-cn_topic_0000001127284836_ac4d9ce9a62d9442cb65658878f44e018"></a><a name="zh-cn_topic_0000001127284836_ac4d9ce9a62d9442cb65658878f44e018"></a>dx</p>
560</td>
561<td class="cellrowborder" valign="top" width="22.000000000000004%" headers="mcps1.2.6.1.2 "><p id="zh-cn_topic_0000001127284836_aa6b8f1f0155a4954aab3a9609cadaf3a"><a name="zh-cn_topic_0000001127284836_aa6b8f1f0155a4954aab3a9609cadaf3a"></a><a name="zh-cn_topic_0000001127284836_aa6b8f1f0155a4954aab3a9609cadaf3a"></a>number</p>
562</td>
563<td class="cellrowborder" valign="top" width="24.000000000000004%" headers="mcps1.2.6.1.3 "><p id="zh-cn_topic_0000001127284836_a95db84bc6a774d029883ad1abae2d022"><a name="zh-cn_topic_0000001127284836_a95db84bc6a774d029883ad1abae2d022"></a><a name="zh-cn_topic_0000001127284836_a95db84bc6a774d029883ad1abae2d022"></a>否</p>
564</td>
565<td class="cellrowborder" valign="top" width="21.000000000000004%" headers="mcps1.2.6.1.4 "><p id="zh-cn_topic_0000001127284836_aaa6df3c43c9b47bf81b339edcae98840"><a name="zh-cn_topic_0000001127284836_aaa6df3c43c9b47bf81b339edcae98840"></a><a name="zh-cn_topic_0000001127284836_aaa6df3c43c9b47bf81b339edcae98840"></a>0</p>
566</td>
567<td class="cellrowborder" valign="top" width="21.000000000000004%" headers="mcps1.2.6.1.5 "><p id="zh-cn_topic_0000001127284836_aaffe44e874d74b6297ea7841258cb941"><a name="zh-cn_topic_0000001127284836_aaffe44e874d74b6297ea7841258cb941"></a><a name="zh-cn_topic_0000001127284836_aaffe44e874d74b6297ea7841258cb941"></a>水平方向滑动的偏移量,单位为px。</p>
568</td>
569</tr>
570<tr id="zh-cn_topic_0000001127284836_rf56d36eb7a184adc843f20b499344ed6"><td class="cellrowborder" valign="top" width="12.000000000000002%" headers="mcps1.2.6.1.1 "><p id="zh-cn_topic_0000001127284836_acb8223e7297d4dbfa243b4b974c92560"><a name="zh-cn_topic_0000001127284836_acb8223e7297d4dbfa243b4b974c92560"></a><a name="zh-cn_topic_0000001127284836_acb8223e7297d4dbfa243b4b974c92560"></a>dy</p>
571</td>
572<td class="cellrowborder" valign="top" width="22.000000000000004%" headers="mcps1.2.6.1.2 "><p id="zh-cn_topic_0000001127284836_aa88695593f93485a9b64158a7e05cda4"><a name="zh-cn_topic_0000001127284836_aa88695593f93485a9b64158a7e05cda4"></a><a name="zh-cn_topic_0000001127284836_aa88695593f93485a9b64158a7e05cda4"></a>number</p>
573</td>
574<td class="cellrowborder" valign="top" width="24.000000000000004%" headers="mcps1.2.6.1.3 "><p id="zh-cn_topic_0000001127284836_a08e26d1dfd3e406b849dfaa715b0e985"><a name="zh-cn_topic_0000001127284836_a08e26d1dfd3e406b849dfaa715b0e985"></a><a name="zh-cn_topic_0000001127284836_a08e26d1dfd3e406b849dfaa715b0e985"></a>否</p>
575</td>
576<td class="cellrowborder" valign="top" width="21.000000000000004%" headers="mcps1.2.6.1.4 "><p id="zh-cn_topic_0000001127284836_aede3e64e10724335b9297743fece7e4a"><a name="zh-cn_topic_0000001127284836_aede3e64e10724335b9297743fece7e4a"></a><a name="zh-cn_topic_0000001127284836_aede3e64e10724335b9297743fece7e4a"></a>0</p>
577</td>
578<td class="cellrowborder" valign="top" width="21.000000000000004%" headers="mcps1.2.6.1.5 "><p id="zh-cn_topic_0000001127284836_ade99317ad7354fee8e88ca282cf70446"><a name="zh-cn_topic_0000001127284836_ade99317ad7354fee8e88ca282cf70446"></a><a name="zh-cn_topic_0000001127284836_ade99317ad7354fee8e88ca282cf70446"></a>垂直方向滑动的偏移量,单位为px。</p>
579</td>
580</tr>
581<tr id="zh-cn_topic_0000001127284836_r69d5b3d9c60a4a5ea242be132f754948"><td class="cellrowborder" valign="top" width="12.000000000000002%" headers="mcps1.2.6.1.1 "><p id="zh-cn_topic_0000001127284836_ae0636046822644c7b7a5289fbbcd53e6"><a name="zh-cn_topic_0000001127284836_ae0636046822644c7b7a5289fbbcd53e6"></a><a name="zh-cn_topic_0000001127284836_ae0636046822644c7b7a5289fbbcd53e6"></a>smooth</p>
582</td>
583<td class="cellrowborder" valign="top" width="22.000000000000004%" headers="mcps1.2.6.1.2 "><p id="zh-cn_topic_0000001127284836_a7d930786d83a4f9f92a4ba4e6cbb9db0"><a name="zh-cn_topic_0000001127284836_a7d930786d83a4f9f92a4ba4e6cbb9db0"></a><a name="zh-cn_topic_0000001127284836_a7d930786d83a4f9f92a4ba4e6cbb9db0"></a>boolean</p>
584</td>
585<td class="cellrowborder" valign="top" width="24.000000000000004%" headers="mcps1.2.6.1.3 "><p id="zh-cn_topic_0000001127284836_a643ff67584184620885e6ee1fddee8cb"><a name="zh-cn_topic_0000001127284836_a643ff67584184620885e6ee1fddee8cb"></a><a name="zh-cn_topic_0000001127284836_a643ff67584184620885e6ee1fddee8cb"></a>否</p>
586</td>
587<td class="cellrowborder" valign="top" width="21.000000000000004%" headers="mcps1.2.6.1.4 "><p id="zh-cn_topic_0000001127284836_ac86052e652c54edead6588ad0932a118"><a name="zh-cn_topic_0000001127284836_ac86052e652c54edead6588ad0932a118"></a><a name="zh-cn_topic_0000001127284836_ac86052e652c54edead6588ad0932a118"></a>true</p>
588</td>
589<td class="cellrowborder" valign="top" width="21.000000000000004%" headers="mcps1.2.6.1.5 "><p id="zh-cn_topic_0000001127284836_a1a8906b49d5e48f98a068f339df880e9"><a name="zh-cn_topic_0000001127284836_a1a8906b49d5e48f98a068f339df880e9"></a><a name="zh-cn_topic_0000001127284836_a1a8906b49d5e48f98a068f339df880e9"></a>列表位置跳转时是否有滑动动画。</p>
590</td>
591</tr>
592</tbody>
593</table>
594
595**表 2**  currentOffset返回对象属性说明
596
597<a name="zh-cn_topic_0000001127284836_table1145513617576"></a>
598<table><thead align="left"><tr id="zh-cn_topic_0000001127284836_row1445543665717"><th class="cellrowborder" valign="top" width="21.82%" id="mcps1.2.4.1.1"><p id="zh-cn_topic_0000001127284836_p0455183695711"><a name="zh-cn_topic_0000001127284836_p0455183695711"></a><a name="zh-cn_topic_0000001127284836_p0455183695711"></a>名称</p>
599</th>
600<th class="cellrowborder" valign="top" width="40%" id="mcps1.2.4.1.2"><p id="zh-cn_topic_0000001127284836_p2045533685711"><a name="zh-cn_topic_0000001127284836_p2045533685711"></a><a name="zh-cn_topic_0000001127284836_p2045533685711"></a>类型</p>
601</th>
602<th class="cellrowborder" valign="top" width="38.18%" id="mcps1.2.4.1.3"><p id="zh-cn_topic_0000001127284836_p144557363572"><a name="zh-cn_topic_0000001127284836_p144557363572"></a><a name="zh-cn_topic_0000001127284836_p144557363572"></a>备注</p>
603</th>
604</tr>
605</thead>
606<tbody><tr id="zh-cn_topic_0000001127284836_row545516365576"><td class="cellrowborder" valign="top" width="21.82%" headers="mcps1.2.4.1.1 "><p id="zh-cn_topic_0000001127284836_p6455136135712"><a name="zh-cn_topic_0000001127284836_p6455136135712"></a><a name="zh-cn_topic_0000001127284836_p6455136135712"></a>x</p>
607</td>
608<td class="cellrowborder" valign="top" width="40%" headers="mcps1.2.4.1.2 "><p id="zh-cn_topic_0000001127284836_p14456113625711"><a name="zh-cn_topic_0000001127284836_p14456113625711"></a><a name="zh-cn_topic_0000001127284836_p14456113625711"></a>number</p>
609</td>
610<td class="cellrowborder" valign="top" width="38.18%" headers="mcps1.2.4.1.3 "><p id="zh-cn_topic_0000001127284836_p19456436165717"><a name="zh-cn_topic_0000001127284836_p19456436165717"></a><a name="zh-cn_topic_0000001127284836_p19456436165717"></a>当前x轴滑动偏移量,单位为px。</p>
611</td>
612</tr>
613<tr id="zh-cn_topic_0000001127284836_row134561936125711"><td class="cellrowborder" valign="top" width="21.82%" headers="mcps1.2.4.1.1 "><p id="zh-cn_topic_0000001127284836_p194561736145714"><a name="zh-cn_topic_0000001127284836_p194561736145714"></a><a name="zh-cn_topic_0000001127284836_p194561736145714"></a>y</p>
614</td>
615<td class="cellrowborder" valign="top" width="40%" headers="mcps1.2.4.1.2 "><p id="zh-cn_topic_0000001127284836_p1345612364579"><a name="zh-cn_topic_0000001127284836_p1345612364579"></a><a name="zh-cn_topic_0000001127284836_p1345612364579"></a>number</p>
616</td>
617<td class="cellrowborder" valign="top" width="38.18%" headers="mcps1.2.4.1.3 "><p id="zh-cn_topic_0000001127284836_p1144122515599"><a name="zh-cn_topic_0000001127284836_p1144122515599"></a><a name="zh-cn_topic_0000001127284836_p1144122515599"></a>当前y轴滑动偏移量,单位为px。</p>
618</td>
619</tr>
620</tbody>
621</table>
622
623## 示例<a name="zh-cn_topic_0000001127284836_section24931424488"></a>
624
625```
626<!-- index.hml -->
627<div class="container">
628  <list class="todo-wrapper">
629    <list-item for="{{todolist}}" class="todo-item">
630      <text class="todo-title">{{$item.title}}</text>
631      <text class="todo-title">{{$item.date}}</text>
632    </list-item>
633  </list>
634</div>
635```
636
637```
638// index.js
639export default {
640  data: {
641    todolist: [{
642      title: '刷题',
643      date: '2021-12-31 10:00:00',
644    }, {
645      title: '看电影',
646      date: '2021-12-31 20:00:00',
647    }],
648  },
649}
650```
651
652```
653/* index.css */
654.container {
655  display: flex;
656  justify-content: center;
657  align-items: center;
658  left: 0px;
659  top: 0px;
660  width: 454px;
661  height: 454px;
662}
663.todo-wrapper {
664  width: 454px;
665  height: 300px;
666}
667.todo-item {
668  width: 454px;
669  height: 80px;
670  flex-direction: column;
671}
672.todo-title {
673  width: 454px;
674  height: 40px;
675  text-align: center;
676}
677```
678
679![](figures/zh-cn_image_0000001212081517.png)
680
681