city-casereport/miniprogram_npm/tdesign-miniprogram/pull-down-refresh/README.md

title	description	spline	isComponent
PullDownRefresh 下拉刷新	用于快速刷新页面信息，刷新可以是整页刷新也可以是页面的局部刷新。	message	true

引入

全局引入，在 miniprogram 根目录下的app.json中配置，局部引入，在需要引入的页面或组件的index.json中配置。

"usingComponents": {
  "t-pull-down-refresh": "tdesign-miniprogram/pull-down-refresh/pull-down-refresh"
}

代码演示

顶部下拉刷新

由于组件内无法监听页面滚动，需要由页面获取组件实例，并将页面滚动事件传递到组件。

{{ base }}

在使用 pull-down-refresh 组件的页面，建议开启 disableScroll: true

API

PullDownRefresh Props

名称	类型	默认值	说明	必传
enable-back-to-top	Boolean	true	1.1.5。iOS点击顶部状态栏、安卓双击标题栏时，滚动条返回顶部，只支持竖向。自 2.27.3 版本开始，若非显式设置为 false，则在显示尺寸大于屏幕 90% 时自动开启	N
enable-passive	Boolean	false	1.1.5。开启 passive 特性，能优化一定的滚动性能	N
loading-bar-height	String / Number	50	加载中下拉高度，如果值为数字则单位是：'px'	N
loading-props	Object	-	加载loading样式。TS 类型：LoadingProps，Loading API Documents。详细类型定义	N
loading-texts	Array	[]	提示语，组件内部默认值为 ['下拉刷新', '松手刷新', '正在刷新', '刷新完成']。TS 类型：string[]	N
lower-threshold	String / Number	50	1.1.5。距底部/右边多远时，触发 scrolltolower 事件	N
max-bar-height	String / Number	80	最大下拉高度，如果值为数字则单位是：'px'	N
refresh-timeout	Number	3000	刷新超时时间	N
scroll-into-view	String	-	1.1.5。值应为某子元素id（id不能以数字开头）。设置哪个方向可滚动，则在哪个方向滚动到该元素	N
show-scrollbar	Boolean	true	滚动条显隐控制 (同时开启 enhanced 属性后生效)	N
upper-threshold	String / Number	50	1.1.5。距顶部/左边多远时，触发 scrolltoupper 事件	N
value	Boolean	false	组件状态，值为 true 表示下拉状态，值为 false 表示收起状态	N
default-value	Boolean	undefined	组件状态，值为 true 表示下拉状态，值为 false 表示收起状态。非受控属性	N

PullDownRefresh Events

名称	参数	描述
change	(value: boolean)	下拉或收起时触发，用户手势往下滑动触发下拉状态，手势松开触发收起状态
refresh	-	结束下拉时触发
timeout	-	刷新超时触发

PullDownRefresh 外部样式类

类名	说明
t-class	根节点样式类
t-class-loading	加载样式类
t-class-text	文本样式类
t-class-indicator	指示样式类

CSS 变量

组件提供了下列 CSS 变量，可用于自定义样式。

名称	默认值	描述
--td-pull-down-refresh-color	@font-gray-3	-