RefreshControl

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

该组件用于 ScrollView 或 ListView 内部，用于添加下拉刷新功能。当 ScrollView 处于 scrollY: 0 位置时，向下滑动会触发 onRefresh 事件。

示例

备注

refreshing 是一个受控属性，因此必须在 onRefresh 函数中将其设置为 true，否则刷新指示器会立即停止。

---

参考

属性

View 属性

继承 View 属性。

---

Required

refreshing

视图是否应显示正在刷新的状态指示。

Type
boolean

---

colors

Android

用于绘制刷新指示器的颜色（至少需要一种颜色）。

Type
array of colors

---

enabled

Android

是否启用下拉刷新功能。

Type	Default
boolean	true

---

onRefresh

当视图开始刷新时调用。

Type
function

---

progressBackgroundColor

Android

刷新指示器的背景颜色。

Type
color

---

progressViewOffset

进度视图的顶部偏移量。

Type	Default
number	0

---

size

Android

刷新指示器的尺寸大小。

Type	Default
enum('default', 'large')	'default'

---

tintColor

iOS

刷新指示器的颜色。

Type
color

---

title

iOS

刷新指示器下方显示的标题文本。

Type
string

---

titleColor

iOS

刷新指示器标题文本的颜色。

Type
color