Skip to content
# t-refresher

Refresher 下拉刷新

t-refresher 组件介绍 ​

t-refresher 是下拉刷新组件,用于配合列表组件实现下拉刷新和上拉加载功能。

t-refresher 平台兼容 ​

HarmonyH5AndroidiOS小程序UTS
✅✅✅✅✅✅

t-refresher 基础用法 ​

基础用法参考 demo/refresher/refresher.uvue,配合列表组件使用,支持状态与布局方向配置。

vue
<template>
	<view class='p-15'>
		<tui-theme-switch></tui-theme-switch>
		<t-card title="Refresher 刷新-加载"
				class="mb-15"
				sub-title="下拉刷新 和 上拉加载"></t-card>
		<t-section title="基础功能+主题展示"
				   class="mb-15"></t-section>
		<view :class="[`fc r-10 tvg p-10 mb-15`]">
			<t-refresher type="primary"
						 default-icon-class="mr-2 s-17"></t-refresher>
		</view>
		<view :class="[`fc r-10 tvg p-10 mb-15`]">
			<t-refresher type="error"
						 default-icon-class="mr-2-s-17"></t-refresher>
		</view>
		<t-section title="布局方向调整"
				   class="mb-15"></t-section>
		<view :class="[`fc r-10 tvg p-10 mb-15`]">
			<t-refresher type="primary"
						 :vertical="false"></t-refresher>
		</view>
		<view :class="[`fc r-10 tvg p-10 mb-15`]">
			<t-refresher type="error"
						 :vertical="false"></t-refresher>
		</view>

		<t-section title="状态"
				   class="mb-15"></t-section>
		<view :class="[`fc r-10 tvg p-10 mb-15`]">
			<t-refresher type="primary"
						 :state="0"></t-refresher>
		</view>
		<view :class="[`fc r-10 tvg p-10 mb-15`]">
			<t-refresher type="primary"
						 :state="1"></t-refresher>
		</view>
		<view :class="[`fc r-10 tvg p-10 mb-15`]">
			<t-refresher type="primary"
						 :state="2"></t-refresher>
		</view>
		<view :class="[`fc r-10 tvg p-10 mb-15`]">
			<t-refresher type="primary"
						 :state="3"></t-refresher>
		</view>
	</view>
</template>

t-refresher Props ​

属性名说明类型默认值
state当前刷新状态number1
vertical是否纵向排列booleantrue
defaultIcon默认状态时的图标string'arrow-down-circle'
pullingIcon下拉刷新时的图标string'arrow-up-circle'
refreshingIcon刷新状态下的图标string'spinner'
refreshingEndIcon刷新完成状态下的图标string'checkbox-mark'
defaultText默认状态下的文本string'继续下拉刷新'
pullingText下拉状态下的文本string'松开立即刷新'
refreshingText刷新状态下的文本string'正在刷新'
refreshingEndText刷新完成状态下的文本string'刷新成功'
iconClass图标样式string-
textClass文本的样式string-
path点击组件后跳转的页面路径string''
hover是否启用点击效果booleanfalse
type组件主题类型string''
disabled是否禁用booleanfalse
effect组件显示主题string'normal'
size组件尺寸string'mini'

state 状态值 ​

值说明
0默认状态
1下拉时候的状态
2下拉到设置的距离后的状态
3松开时的状态
4松开后执行操作成功状态