refresh

HarmonyOS Next 不支持

app端nvue专用组件。

<refresh> 为容器提供下拉刷新功能。在nvue上，可通过此组件实现灵活的、自定义的、高性能的下拉刷新。

注意

• <refresh> 是 <scroll-view>、<list>、<waterfall> 的子组件，只能在被它们包含时才能被正确渲染。

<scroll-view>
  <refresh>
    <text>Refreshing...</text>
  </refresh>
  <view v-for="num in lists">
    <text>{{num}}</text>
  </view>
</scroll-view>

子组件

• 诸如 <text>、<image> 之类的任何组件，都可以放到 <loading> 进行渲染。
• 特殊子组件 <loading-indicator>: 只能作为 <refresh> 和 <loading> 的子组件使用，拥有默认的动画效果实现。

<refresh>
  <text>Refreshing</text>
  <loading-indicator></loading-indicator>
</refresh>

属性

display 控制 <refresh> 组件显示、隐藏。display 的设置必须成对出现，即设置 display="show", 必须有对应的 display="hide"。可选值为 show / hide，默认值为 show。

事件

• refresh 事件：当 <scroll-view>、<list>、<waterfall> 被下拉完成时触发。
• pullingdown 事件：当 <scroll-view>、<list>、<waterfall> 被下拉时触发。 可以从 event 参数对象中获取以下数据：
  • dy: 前后两次回调滑动距离的差值
  • pullingDistance: 下拉的距离
  • viewHeight: refresh 组件高度
  • type: “pullingdown” 常数字符串

<refresh @refresh="onrefresh" @pullingdown="onpullingdown" :display="refreshing ? 'show' : 'hide'">
  <text>Refreshing ...</text>
  <loading-indicator></loading-indicator>
</refresh>