刷新动效的容器组件

2024-01-22 17:55 更新

可以进行页面下拉操作并显示刷新动效的容器组件。

说明

该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

子组件

支持单个子组件。

接口

Refresh(value: { refreshing: boolean, offset?: number | string , friction?: number | string })

参数:

参数

参数名

必填

参数描述

refreshing

boolean

当前组件是否正在刷新。

该参数支持$$双向绑定变量。

offset

string | number

下拉起点距离组件顶部的距离。

默认值:16

单位:vp

取值范围:[0vp,64vp],大于64vp按照64vp处理。

说明

不支持百分比,不支持负数。

friction

number | string

下拉摩擦系数,取值范围为0到100。

默认值:62

- 0表示下拉刷新容器不跟随手势下拉而下拉。

- 100表示下拉刷新容器紧紧跟随手势下拉而下拉。

- 数值越大,下拉刷新容器跟随手势下拉的反应越灵敏。

属性

支持通用属性

事件

除支持通用事件外,还支持以下事件:

名称

描述

onStateChange(callback: (state: RefreshStatus) => void)

当前刷新状态变更时,触发回调。

- state:刷新状态。

onRefreshing(callback: () => void)

进入刷新状态时触发回调。

RefreshStatus枚举说明

名称

描述

Inactive

默认为下拉状态。

Drag

下拉中,下拉距离小于刷新距离。

OverDrag

下拉中,下拉距离超过刷新距离。

Refresh

下拉结束,回弹至刷新距离,进入刷新状态。

Done

刷新结束,返回初始状态(顶部)。

示例

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct RefreshExample {
  5. @State isRefreshing: boolean = false
  6. @State counter: number = 0
  7. build() {
  8. Column() {
  9. Refresh({ refreshing: $$this.isRefreshing, offset: 120, friction: 100 }) {
  10. Text('Pull Down and refresh: ' + this.counter)
  11. .fontSize(30)
  12. .margin(10)
  13. }
  14. .onStateChange((refreshStatus: RefreshStatus) => {
  15. console.info('Refresh onStatueChange state is ' + refreshStatus)
  16. })
  17. .onRefreshing(() => {
  18. setTimeout(() => {
  19. this.counter++
  20. this.isRefreshing = false
  21. }, 1000)
  22. console.log('onRefreshing test')
  23. })
  24. }
  25. }
  26. }

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号