跳至主内容
版本:0.79

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
​

是否启用下拉刷新功能。

TypeDefault
booleantrue

onRefresh​

当视图开始刷新时调用。

Type
function

progressBackgroundColor
Android
​

刷新指示器的背景颜色。

Type
color

progressViewOffset​

进度视图的顶部偏移量。

TypeDefault
number0

size
Android
​

刷新指示器的尺寸大小。

TypeDefault
enum('default', 'large')'default'

tintColor
iOS
​

刷新指示器的颜色。

Type
color

title
iOS
​

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

Type
string

titleColor
iOS
​

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

Type
color