Skip to content
你当前查看的文档是tmui3.2.0(已不再支持NVUE)
[tmui3.1.x nvue点我] [tmui4.x uniappx原生开发代替nvue]

反馈组件

下拉刷新 tmPullRefresh

下拉刷新组件,支持自定义下拉和触底刷新的内容。

🌶️ 示例

查看模拟效果
示例模板
vue
<template>
    <view style="height: calc(100vh - 44px);" class="flex flex-col">
        <tm-pull-refresh :frist-load="false" style="height: 100%;"
        :pull-refresh="handleRefresh" 
        :bottom-refresh="bootmHandleRefresh" >
            <tm-sheet>
                <tm-text font-size="36" class="text-weight-b mb-16 d-block">下拉刷新</tm-text>
                <view>
                    <tm-text>请拖拉下拉刷新</tm-text>
                </view>
            </tm-sheet>
            <tm-sheet height="800px">
                <tm-text font-size="36" class="text-weight-b mb-16 d-block">触底刷新</tm-text>
                <view>
                    <tm-text>上拖触底刷新</tm-text>
                </view>
            </tm-sheet>
        </tm-pull-refresh>
    </view>
</template>
<script setup lang="ts">
const handleRefresh = ():Promise<boolean> => {
    console.log('刷新');
    return new Promise((resolve, reject) => {
        setTimeout(() => {
            console.log('完成');
            resolve(true);
        }, 3*1000);
    })
}
const bootmHandleRefresh = async ():Promise<boolean> => {
    console.log('刷新');
    return new Promise((resolve, reject) => {
        setTimeout(() => {
            console.log('完成');
            resolve(true);
        }, 3000);
    })
}
</script>
<style lang="scss"></style>

🌶️ 兼容性

平台兼容

H5uniAPP小程序version
☑️☑️☑️☑️

🌱 参数

参数名类型默认值描述
heightstring'100%'高,可以是百分比,px,rpx等单位数字或者字符串。
pullHeightnumber60下拉区域触发刷新的高度
colorstring""图标颜色,空值时,取全局主题色。
textColorstring""文字颜色,空值时,取全局主题色。
showScrollbarbooleantrue是否显示滚动条
disabledPullbooleanfalse是否禁用下拉刷新
disabledBottombooleanfalse是否禁用触底刷新
fristLoadbooleanfalse是否进入就刷新数据
pullRefresh() => Promise<boolean>()=>(()=>Promise.resolve(true))触下拉刷新时执行本事件,返回true成功,false失败
bottomRefresh() => Promise<boolean>()=>(()=>Promise.resolve(true))触底刷新时执行本事件,返回true成功,false失败

🌹 事件

事件名参数返回数据描述
scroll名称:evt,滚动事件参数,-滚动的时候触发
scrollDirection名称:type,当前的滚动方向up表示往下拉,内容向上滚动,down表示往上拉,内容向下滚动,-滚动的时候触发

🌽 slot插槽

插槽名数据描述
pull名称:binding,status 类型:-
-
default--
bottom名称:binding,status 类型:-
-

🥗 ref方法

方法名参数返回值描述
setScrollTop--滚动到指定位置
setScrollIntoView--滚动到指定id元素
如果需投广告联系我?
TMUI4x

TMUI4x UniAppx

纯正原生开发版本,全平台原生组件,兼容鸿蒙Next原生

了解最新技术