# 下拉刷新配置

参数 说明 类型 默认值 可选值
refresher-enabled 是否开启下拉刷新 Boolean true false
refresher-threshold 设置自定义下拉刷新阈值,默认单位为px。

(支持传100、"100px"或"100rpx")(nvue无效)

Number|String 80rpx -
refresher-only 1.6.6 是否只使用下拉刷新,设置为true后将关闭mounted自动请求数据、关闭滚动到底部加载更多,强制隐藏空数据图。

若只想关闭滚动到底部加载更多,请点击这里

Boolean false true
use-custom-refresher 是否使用自定义的下拉刷新,默认为是,即使用z-paging的下拉刷新。设置为false即代表使用uni scroll-view自带的下拉刷新,h5、App、微信小程序以外的平台不支持uni scroll-view自带的下拉刷新 Boolean true h5、App、微信小程序以外的平台设置为false时,无法使用下拉刷新
show-refresher-when-reload 1.7.2 调用reload方法时自动显示下拉刷新view Boolean false true
refresher-theme-style 下拉刷新的主题样式,支持black,white String black white
refresher-img-style 2.0.2 自定义下拉刷新中左侧图标的样式 Object {} -
refresher-title-style 2.0.2 自定义下拉刷新中右侧状态描述文字的样式 Object {} -
refresher-update-time-style 2.0.2 自定义下拉刷新中右侧最后更新时间文字的样式

(show-refresher-update-time为true时有效)

Object {} -
show-refresher-update-time 1.6.7 是否显示最后更新时间 Boolean false true
refresher-update-time-key 1.6.7 如果需要区别不同页面的最后更新时间,请为不同页面的z-paging的refresher-update-time-key设置不同的字符串 String default -
refresher-default-text 自定义下拉刷新默认状态下的文字

(支持直接传字符串或形如:{'en':'英文配置':'zh-cn':'中文配置'}的i18n配置)

String|Object 继续下拉刷新 -
refresher-pulling-text 自定义下拉刷新松手立即刷新状态下的文字

(支持直接传字符串或形如:{'en':'英文配置':'zh-cn':'中文配置'}的i18n配置)

String|Object 松开立即刷新 -
refresher-refreshing-text 自定义下拉刷新刷新中状态下的文字

(支持直接传字符串或形如:{'en':'英文配置':'zh-cn':'中文配置'}的i18n配置)

String|Object 正在刷新... -
refresher-complete-text 2.0.6 自定义下拉刷新刷新结束状态下的文字

(支持直接传字符串或形如:{'en':'英文配置':'zh-cn':'中文配置'}的i18n配置)

String|Object 刷新成功 -
refresher-end-bounce-enabled 是否开启自定义下拉刷新刷新结束回弹效果 Boolean true false
refresher-default-style 设置系统下拉刷新默认样式,支持设置 black,white,none,none 表示不使用默认样式 String black white、none
refresher-background 设置自定义下拉刷新区域背景颜色 String #FFFFFF00(透明) -
refresher-fixed-background 设置固定的自定义下拉刷新区域背景颜色 String #FFFFFF00(透明) -
refresher-fixed-bac-height 设置固定的自定义下拉刷新区域高度 Number|String 0 -
refresher-complete-delay 2.0.6 自定义下拉刷新结束以后延迟回弹的时间,单位为毫秒 Number|String 0 -
refresher-complete-duration 2.0.6 自定义下拉刷新结束回弹动画时间,单位为毫秒(refresher-end-bounce-enabled为false时,refresher-complete-duration为设定值的1/3)

(nvue无效)

Number|String 300 -
refresher-out-rate 设置自定义下拉刷新下拉超出阈值后继续下拉位移衰减的比例,范围0-1,值越大代表衰减越多。

(nvue无效)

Number 0.7 -
refresher-fps 自定义下拉刷新下拉帧率,默认为40,过高可能会出现抖动问题 Number|String 40 -
refresher-max-angle 自定义下拉刷新允许触发的最大下拉角度,默认为40度,当下拉角度小于设定值时,自定义下拉刷新动画不会被触发。

(值小于0或大于90时,代表不受角度限制)

Number|String 40 0-90
refresher-angle-enable-change-continued 自定义下拉刷新的角度由未达到最大角度变到达到最大角度时,是否继续下拉刷新手势 Boolean false true