• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# SwipeRefresher
2<!--Kit: ArkUI-->
3<!--Subsystem: ArkUI-->
4<!--Owner: @fengluochenai-->
5<!--Designer: @YanSanzo-->
6<!--Tester: @tinygreyy-->
7<!--Adviser: @HelloCrease-->
8
9
10内容加载指获取内容并加载出来,常用于衔接展示下拉加载的内容。
11
12> **说明:**
13>
14> 该组件及其子组件从 API version 10 开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
15>
16
17
18## 导入模块
19
20```
21import { SwipeRefresher } from '@kit.ArkUI';
22```
23
24
25## 子组件
26
2728
29## 属性
30不支持[通用属性](ts-component-general-attributes.md)。
31
32
33## SwipeRefresher
34
35SwipeRefresher ({content?: ResourceStr, isLoading: boolean})
36
37**装饰器类型:**\@Component
38
39**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
40
41**系统能力:** SystemCapability.ArkUI.ArkUI.Full
42
43**设备行为差异:** 该接口在Wearable设备上使用时,应用程序运行异常, 异常信息中提示接口未定义,在其他设备中可正常调用。
44
45**参数:**
46
47| 名称 | 类型 | 必填 | 装饰器类型 | 说明                                                                 |
48| -------- | -------- | -------- | -------- |--------------------------------------------------------------------|
49| content | [ResourceStr](ts-types.md#resourcestr) | 否 | @Prop | 内容加载时显示的文本。<br/>默认值:空字符串。<br/>**说明**:如果文本大于列宽时,文本被截断。从API version 20开始,支持Resource类型。   |
50| isLoading | boolean | 是 | \@Prop | 当前是否正在加载。<br> isLoading为true时,表示正在加载。<br> isLoading为false时,表示未在加载。 |
51
52## 事件
53不支持[通用事件](ts-component-general-events.md)。
54
55## 示例
56展示设置属性content为空字串及不为空、isLoading为true和false的不同加载效果。
57```ts
58import { SwipeRefresher } from '@kit.ArkUI';
59
60@Entry
61@Component
62struct Index {
63  build() {
64    Column() {
65      SwipeRefresher({
66        content: '正在加载中',
67        isLoading: true
68      })
69      SwipeRefresher({
70        content: '',
71        isLoading: true
72      })
73      SwipeRefresher({
74        content: '正在加载中',
75        isLoading: false
76      })
77    }
78  }
79}
80```
81
82![Snipaste_2023-07-24_11-35-40](figures/Snipaste_2023-07-24_11-35-40.gif)
83