• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# refresh<a name="ZH-CN_TOPIC_0000001209210699"></a>
2
3下拉刷新容器。
4
5## 权限列表<a name="zh-cn_topic_0000001173164669_section11257113618419"></a>
6
78
9## 子组件<a name="zh-cn_topic_0000001173164669_section9288143101012"></a>
10
11支持。
12
13## 属性<a name="zh-cn_topic_0000001173164669_section2907183951110"></a>
14
15除支持[通用属性](js-components-common-attributes.md)外,还支持如下属性:
16
17<a name="zh-cn_topic_0000001173164669_table20633101642315"></a>
18<table><thead align="left"><tr id="zh-cn_topic_0000001173164669_row663331618238"><th class="cellrowborder" valign="top" width="23.119999999999997%" id="mcps1.1.6.1.1"><p id="zh-cn_topic_0000001173164669_aa872998ac2d84843a3c5161889afffef"><a name="zh-cn_topic_0000001173164669_aa872998ac2d84843a3c5161889afffef"></a><a name="zh-cn_topic_0000001173164669_aa872998ac2d84843a3c5161889afffef"></a>名称</p>
19</th>
20<th class="cellrowborder" valign="top" width="23.119999999999997%" id="mcps1.1.6.1.2"><p id="zh-cn_topic_0000001173164669_ab2111648ee0e4f6d881be8954e7acaab"><a name="zh-cn_topic_0000001173164669_ab2111648ee0e4f6d881be8954e7acaab"></a><a name="zh-cn_topic_0000001173164669_ab2111648ee0e4f6d881be8954e7acaab"></a>类型</p>
21</th>
22<th class="cellrowborder" valign="top" width="10.48%" id="mcps1.1.6.1.3"><p id="zh-cn_topic_0000001173164669_ab377d1c90900478ea4ecab51e9a058af"><a name="zh-cn_topic_0000001173164669_ab377d1c90900478ea4ecab51e9a058af"></a><a name="zh-cn_topic_0000001173164669_ab377d1c90900478ea4ecab51e9a058af"></a>默认值</p>
23</th>
24<th class="cellrowborder" valign="top" width="7.5200000000000005%" id="mcps1.1.6.1.4"><p id="zh-cn_topic_0000001173164669_p824610360217"><a name="zh-cn_topic_0000001173164669_p824610360217"></a><a name="zh-cn_topic_0000001173164669_p824610360217"></a>必填</p>
25</th>
26<th class="cellrowborder" valign="top" width="35.76%" id="mcps1.1.6.1.5"><p id="zh-cn_topic_0000001173164669_a1d574a0044ed42ec8a2603bc82734232"><a name="zh-cn_topic_0000001173164669_a1d574a0044ed42ec8a2603bc82734232"></a><a name="zh-cn_topic_0000001173164669_a1d574a0044ed42ec8a2603bc82734232"></a>描述</p>
27</th>
28</tr>
29</thead>
30<tbody><tr id="zh-cn_topic_0000001173164669_row9157554193514"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173164669_p178012583610"><a name="zh-cn_topic_0000001173164669_p178012583610"></a><a name="zh-cn_topic_0000001173164669_p178012583610"></a>offset</p>
31</td>
32<td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173164669_p1880112512360"><a name="zh-cn_topic_0000001173164669_p1880112512360"></a><a name="zh-cn_topic_0000001173164669_p1880112512360"></a>&lt;length&gt;</p>
33</td>
34<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173164669_p4801551360"><a name="zh-cn_topic_0000001173164669_p4801551360"></a><a name="zh-cn_topic_0000001173164669_p4801551360"></a>-</p>
35</td>
36<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173164669_p880112519366"><a name="zh-cn_topic_0000001173164669_p880112519366"></a><a name="zh-cn_topic_0000001173164669_p880112519366"></a>否</p>
37</td>
38<td class="cellrowborder" valign="top" width="35.76%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173164669_p380114563617"><a name="zh-cn_topic_0000001173164669_p380114563617"></a><a name="zh-cn_topic_0000001173164669_p380114563617"></a>刷新组件静止时距离父组件顶部的距离。</p>
39</td>
40</tr>
41<tr id="zh-cn_topic_0000001173164669_row125231450153511"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173164669_p1380145163611"><a name="zh-cn_topic_0000001173164669_p1380145163611"></a><a name="zh-cn_topic_0000001173164669_p1380145163611"></a>refreshing</p>
42</td>
43<td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173164669_p108011457365"><a name="zh-cn_topic_0000001173164669_p108011457365"></a><a name="zh-cn_topic_0000001173164669_p108011457365"></a><span>boolean</span></p>
44</td>
45<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173164669_p128011554364"><a name="zh-cn_topic_0000001173164669_p128011554364"></a><a name="zh-cn_topic_0000001173164669_p128011554364"></a>false</p>
46</td>
47<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173164669_p480119563613"><a name="zh-cn_topic_0000001173164669_p480119563613"></a><a name="zh-cn_topic_0000001173164669_p480119563613"></a>否</p>
48</td>
49<td class="cellrowborder" valign="top" width="35.76%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173164669_p28011856362"><a name="zh-cn_topic_0000001173164669_p28011856362"></a><a name="zh-cn_topic_0000001173164669_p28011856362"></a>用于标识刷新组件当前是否正在刷新。</p>
50</td>
51</tr>
52<tr id="zh-cn_topic_0000001173164669_row1752375015356"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173164669_p1480116513611"><a name="zh-cn_topic_0000001173164669_p1480116513611"></a><a name="zh-cn_topic_0000001173164669_p1480116513611"></a>type</p>
53</td>
54<td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173164669_p11801105143616"><a name="zh-cn_topic_0000001173164669_p11801105143616"></a><a name="zh-cn_topic_0000001173164669_p11801105143616"></a><span>string</span></p>
55</td>
56<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173164669_p198028518361"><a name="zh-cn_topic_0000001173164669_p198028518361"></a><a name="zh-cn_topic_0000001173164669_p198028518361"></a>auto</p>
57</td>
58<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173164669_p680275173619"><a name="zh-cn_topic_0000001173164669_p680275173619"></a><a name="zh-cn_topic_0000001173164669_p680275173619"></a>否</p>
59</td>
60<td class="cellrowborder" valign="top" width="35.76%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173164669_p9802205183619"><a name="zh-cn_topic_0000001173164669_p9802205183619"></a><a name="zh-cn_topic_0000001173164669_p9802205183619"></a>设置组件刷新时的动效。两个可选值,不支持动态修改。</p>
61<a name="zh-cn_topic_0000001173164669_ul0802951367"></a><a name="zh-cn_topic_0000001173164669_ul0802951367"></a><ul id="zh-cn_topic_0000001173164669_ul0802951367"><li>auto: 默认效果,列表界面拉到顶后,列表不移动,下拉后有转圈弹出。</li><li>pulldown: 列表界面拉到顶后,可以继续往下滑动一段距离触发刷新,刷新完成后有回弹效果(如果子组件含有list,防止下拉效果冲突,需将list的scrolleffect设置为no)。</li></ul>
62</td>
63</tr>
64<tr id="zh-cn_topic_0000001173164669_row2303174523514"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173164669_p17802951363"><a name="zh-cn_topic_0000001173164669_p17802951363"></a><a name="zh-cn_topic_0000001173164669_p17802951363"></a>lasttime</p>
65</td>
66<td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173164669_p580235153616"><a name="zh-cn_topic_0000001173164669_p580235153616"></a><a name="zh-cn_topic_0000001173164669_p580235153616"></a>boolean</p>
67</td>
68<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173164669_p198026510362"><a name="zh-cn_topic_0000001173164669_p198026510362"></a><a name="zh-cn_topic_0000001173164669_p198026510362"></a>false</p>
69</td>
70<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173164669_p118029511366"><a name="zh-cn_topic_0000001173164669_p118029511366"></a><a name="zh-cn_topic_0000001173164669_p118029511366"></a>否</p>
71</td>
72<td class="cellrowborder" valign="top" width="35.76%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173164669_p1880211583612"><a name="zh-cn_topic_0000001173164669_p1880211583612"></a><a name="zh-cn_topic_0000001173164669_p1880211583612"></a>是否显示上次更新时间,字符串格式为:“上次更新时间:XXXX ”,XXXX 按照时间日期显示规范显示,不可动态修改(建议type为pulldown时使用,固定距离位于内容下拉区域底部,使用时注意offset属性设置,防止出现重叠)。</p>
73</td>
74</tr>
75<tr id="zh-cn_topic_0000001173164669_row119861446131017"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173164669_p1098734616104"><a name="zh-cn_topic_0000001173164669_p1098734616104"></a><a name="zh-cn_topic_0000001173164669_p1098734616104"></a>timeoffset<sup id="zh-cn_topic_0000001173164669_sup2158132916489"><a name="zh-cn_topic_0000001173164669_sup2158132916489"></a><a name="zh-cn_topic_0000001173164669_sup2158132916489"></a><span>6+</span></sup></p>
76</td>
77<td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173164669_p59872046111017"><a name="zh-cn_topic_0000001173164669_p59872046111017"></a><a name="zh-cn_topic_0000001173164669_p59872046111017"></a>&lt;length&gt;</p>
78</td>
79<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173164669_p1198724661014"><a name="zh-cn_topic_0000001173164669_p1198724661014"></a><a name="zh-cn_topic_0000001173164669_p1198724661014"></a>-</p>
80</td>
81<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173164669_p298764616106"><a name="zh-cn_topic_0000001173164669_p298764616106"></a><a name="zh-cn_topic_0000001173164669_p298764616106"></a>否</p>
82</td>
83<td class="cellrowborder" valign="top" width="35.76%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173164669_p12987154619106"><a name="zh-cn_topic_0000001173164669_p12987154619106"></a><a name="zh-cn_topic_0000001173164669_p12987154619106"></a>设置更新时间距离父组件顶部的距离。</p>
84</td>
85</tr>
86<tr id="zh-cn_topic_0000001173164669_row08492042113518"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173164669_p11802105143616"><a name="zh-cn_topic_0000001173164669_p11802105143616"></a><a name="zh-cn_topic_0000001173164669_p11802105143616"></a>friction</p>
87</td>
88<td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173164669_p1180265153613"><a name="zh-cn_topic_0000001173164669_p1180265153613"></a><a name="zh-cn_topic_0000001173164669_p1180265153613"></a>number</p>
89</td>
90<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173164669_p128026563620"><a name="zh-cn_topic_0000001173164669_p128026563620"></a><a name="zh-cn_topic_0000001173164669_p128026563620"></a>42</p>
91</td>
92<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173164669_p11802185153615"><a name="zh-cn_topic_0000001173164669_p11802185153615"></a><a name="zh-cn_topic_0000001173164669_p11802185153615"></a>否</p>
93</td>
94<td class="cellrowborder" valign="top" width="35.76%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173164669_p118021351362"><a name="zh-cn_topic_0000001173164669_p118021351362"></a><a name="zh-cn_topic_0000001173164669_p118021351362"></a>下拉摩擦系数,取值范围:0-100,数值越大refresh组件跟手性高,数值越小refresh跟手性低。</p>
95<div class="note" id="zh-cn_topic_0000001173164669_note204304260349"><a name="zh-cn_topic_0000001173164669_note204304260349"></a><a name="zh-cn_topic_0000001173164669_note204304260349"></a><span class="notetitle"> 说明: </span><div class="notebody"><p id="zh-cn_topic_0000001173164669_p1343012264345"><a name="zh-cn_topic_0000001173164669_p1343012264345"></a><a name="zh-cn_topic_0000001173164669_p1343012264345"></a>仅手机、平板和智能穿戴设备支持。</p>
96</div></div>
97</td>
98</tr>
99</tbody>
100</table>
101
102## 样式<a name="zh-cn_topic_0000001173164669_section1893981522413"></a>
103
104除支持[通用样式](js-components-common-styles.md)外,还支持如下样式:
105
106<a name="zh-cn_topic_0000001173164669_table1493916152248"></a>
107<table><thead align="left"><tr id="zh-cn_topic_0000001173164669_row16940141532414"><th class="cellrowborder" valign="top" width="25.03%" id="mcps1.1.6.1.1"><p id="zh-cn_topic_0000001173164669_p994031519247"><a name="zh-cn_topic_0000001173164669_p994031519247"></a><a name="zh-cn_topic_0000001173164669_p994031519247"></a>名称</p>
108</th>
109<th class="cellrowborder" valign="top" width="18.86%" id="mcps1.1.6.1.2"><p id="zh-cn_topic_0000001173164669_p179406154245"><a name="zh-cn_topic_0000001173164669_p179406154245"></a><a name="zh-cn_topic_0000001173164669_p179406154245"></a>类型</p>
110</th>
111<th class="cellrowborder" valign="top" width="10.76%" id="mcps1.1.6.1.3"><p id="zh-cn_topic_0000001173164669_p15940161517242"><a name="zh-cn_topic_0000001173164669_p15940161517242"></a><a name="zh-cn_topic_0000001173164669_p15940161517242"></a>默认值</p>
112</th>
113<th class="cellrowborder" valign="top" width="7.449999999999999%" id="mcps1.1.6.1.4"><p id="zh-cn_topic_0000001173164669_p1694061552419"><a name="zh-cn_topic_0000001173164669_p1694061552419"></a><a name="zh-cn_topic_0000001173164669_p1694061552419"></a>必填</p>
114</th>
115<th class="cellrowborder" valign="top" width="37.9%" id="mcps1.1.6.1.5"><p id="zh-cn_topic_0000001173164669_p29401815132419"><a name="zh-cn_topic_0000001173164669_p29401815132419"></a><a name="zh-cn_topic_0000001173164669_p29401815132419"></a>描述</p>
116</th>
117</tr>
118</thead>
119<tbody><tr id="zh-cn_topic_0000001173164669_row109404152249"><td class="cellrowborder" valign="top" width="25.03%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173164669_p994017159246"><a name="zh-cn_topic_0000001173164669_p994017159246"></a><a name="zh-cn_topic_0000001173164669_p994017159246"></a>background-color</p>
120</td>
121<td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173164669_p12940201582418"><a name="zh-cn_topic_0000001173164669_p12940201582418"></a><a name="zh-cn_topic_0000001173164669_p12940201582418"></a><span>&lt;</span><span>color</span><span>&gt;</span></p>
122</td>
123<td class="cellrowborder" valign="top" width="10.76%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173164669_p16940215132418"><a name="zh-cn_topic_0000001173164669_p16940215132418"></a><a name="zh-cn_topic_0000001173164669_p16940215132418"></a>white</p>
124</td>
125<td class="cellrowborder" valign="top" width="7.449999999999999%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173164669_p14940151592415"><a name="zh-cn_topic_0000001173164669_p14940151592415"></a><a name="zh-cn_topic_0000001173164669_p14940151592415"></a>否</p>
126</td>
127<td class="cellrowborder" valign="top" width="37.9%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173164669_p12940181519248"><a name="zh-cn_topic_0000001173164669_p12940181519248"></a><a name="zh-cn_topic_0000001173164669_p12940181519248"></a>用于设置刷新组件的背景颜色。</p>
128</td>
129</tr>
130<tr id="zh-cn_topic_0000001173164669_row169401315182419"><td class="cellrowborder" valign="top" width="25.03%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173164669_p69401415152410"><a name="zh-cn_topic_0000001173164669_p69401415152410"></a><a name="zh-cn_topic_0000001173164669_p69401415152410"></a>progress-color</p>
131</td>
132<td class="cellrowborder" valign="top" width="18.86%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173164669_p16940161522412"><a name="zh-cn_topic_0000001173164669_p16940161522412"></a><a name="zh-cn_topic_0000001173164669_p16940161522412"></a><span>&lt;</span><span>color</span><span>&gt;</span></p>
133</td>
134<td class="cellrowborder" valign="top" width="10.76%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173164669_p2940171518246"><a name="zh-cn_topic_0000001173164669_p2940171518246"></a><a name="zh-cn_topic_0000001173164669_p2940171518246"></a>black</p>
135</td>
136<td class="cellrowborder" valign="top" width="7.449999999999999%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173164669_p594041514245"><a name="zh-cn_topic_0000001173164669_p594041514245"></a><a name="zh-cn_topic_0000001173164669_p594041514245"></a>否</p>
137</td>
138<td class="cellrowborder" valign="top" width="37.9%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173164669_p169402151243"><a name="zh-cn_topic_0000001173164669_p169402151243"></a><a name="zh-cn_topic_0000001173164669_p169402151243"></a>用于设置刷新组件的loading颜色。</p>
139</td>
140</tr>
141</tbody>
142</table>
143
144## 事件<a name="zh-cn_topic_0000001173164669_section3892191911214"></a>
145
146仅支持如下事件:
147
148<a name="zh-cn_topic_0000001173164669_table71957715020"></a>
149<table><thead align="left"><tr id="zh-cn_topic_0000001173164669_row4224147104"><th class="cellrowborder" valign="top" width="18.459999999999997%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001173164669_p11224575017"><a name="zh-cn_topic_0000001173164669_p11224575017"></a><a name="zh-cn_topic_0000001173164669_p11224575017"></a>名称</p>
150</th>
151<th class="cellrowborder" valign="top" width="30.79%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001173164669_p13225377018"><a name="zh-cn_topic_0000001173164669_p13225377018"></a><a name="zh-cn_topic_0000001173164669_p13225377018"></a>参数</p>
152</th>
153<th class="cellrowborder" valign="top" width="50.74999999999999%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001173164669_p19225197001"><a name="zh-cn_topic_0000001173164669_p19225197001"></a><a name="zh-cn_topic_0000001173164669_p19225197001"></a>描述</p>
154</th>
155</tr>
156</thead>
157<tbody><tr id="zh-cn_topic_0000001173164669_row9225278016"><td class="cellrowborder" valign="top" width="18.459999999999997%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001173164669_p6225187706"><a name="zh-cn_topic_0000001173164669_p6225187706"></a><a name="zh-cn_topic_0000001173164669_p6225187706"></a>refresh</p>
158</td>
159<td class="cellrowborder" valign="top" width="30.79%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001173164669_p1422514714013"><a name="zh-cn_topic_0000001173164669_p1422514714013"></a><a name="zh-cn_topic_0000001173164669_p1422514714013"></a>{ refreshing: refreshingValue }</p>
160</td>
161<td class="cellrowborder" valign="top" width="50.74999999999999%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001173164669_p15225575017"><a name="zh-cn_topic_0000001173164669_p15225575017"></a><a name="zh-cn_topic_0000001173164669_p15225575017"></a>下拉刷新状态变化时触发。可能值:</p>
162<a name="zh-cn_topic_0000001173164669_ul96951626943"></a><a name="zh-cn_topic_0000001173164669_ul96951626943"></a><ul id="zh-cn_topic_0000001173164669_ul96951626943"><li>false:当前处于下拉刷新过程中。</li><li>true:当前未处于下拉刷新过程中。</li></ul>
163</td>
164</tr>
165<tr id="zh-cn_topic_0000001173164669_row13275847193920"><td class="cellrowborder" valign="top" width="18.459999999999997%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001173164669_p42761147173920"><a name="zh-cn_topic_0000001173164669_p42761147173920"></a><a name="zh-cn_topic_0000001173164669_p42761147173920"></a>pulldown</p>
166</td>
167<td class="cellrowborder" valign="top" width="30.79%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001173164669_p227664711392"><a name="zh-cn_topic_0000001173164669_p227664711392"></a><a name="zh-cn_topic_0000001173164669_p227664711392"></a>{ state: string }</p>
168</td>
169<td class="cellrowborder" valign="top" width="50.74999999999999%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001173164669_p527644753917"><a name="zh-cn_topic_0000001173164669_p527644753917"></a><a name="zh-cn_topic_0000001173164669_p527644753917"></a>下拉开始和松手时触发。可能值:</p>
170<a name="zh-cn_topic_0000001173164669_ul225113709"></a><a name="zh-cn_topic_0000001173164669_ul225113709"></a><ul id="zh-cn_topic_0000001173164669_ul225113709"><li>start:表示开始下拉。</li><li>end:表示结束下拉。</li></ul>
171</td>
172</tr>
173</tbody>
174</table>
175
176## 方法<a name="zh-cn_topic_0000001173164669_section2279124532420"></a>
177
178不支持[通用方法](js-components-common-methods.md)。
179
180## 示例<a name="zh-cn_topic_0000001173164669_section1050103282219"></a>
181
182```
183<!-- xxx.hml -->
184<div class="container">
185  <refresh refreshing="{{fresh}}" onrefresh="refresh">
186    <list class="list" scrolleffect="no">
187      <list-item class="listitem" for="list">
188        <div class="content">
189          <text class="text">{{$item}}</text>
190        </div>
191      </list-item>
192    </list>
193  </refresh>
194</div>
195```
196
197```
198/* xxx.css */
199.container {
200  flex-direction: column;
201  align-items: center;
202  width: 100%;
203  height: 100%;
204}
205
206.list {
207  width: 100%;
208  height: 100%;
209}
210
211.listitem {
212  width: 100%;
213  height: 150px;
214}
215
216.content {
217  width: 100%;
218  height: 100%;
219  flex-direction: column;
220  align-items: center;
221  justify-content: center;
222}
223
224.text {
225  font-size: 35px;
226  font-weight: bold;
227}
228```
229
230```
231// xxx.js
232import prompt from '@system.prompt';
233export default {
234  data: {
235    list:[],
236    fresh:false
237  },
238  onInit() {
239    this.list = [];
240    for (var i = 0; i <= 3; i++) {
241      var item = '列表元素' + i;
242      this.list.push(item);
243    }
244  },
245  refresh: function (e) {
246    prompt.showToast({
247      message: '刷新中...'
248    })
249    var that = this;
250    that.fresh = e.refreshing;
251    setTimeout(function () {
252      that.fresh = false;
253      var addItem = '更新元素';
254      that.list.unshift(addItem);
255      prompt.showToast({
256        message: '刷新完成!'
257      })
258    }, 2000)
259  }
260}
261```
262
263![](figures/zh-cn_image_0000001212440059.gif)
264
265