反馈组件
下拉刷新 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>🌶️ 兼容性
平台兼容
| H5 | uniAPP | 小程序 | version |
|---|---|---|---|
| ☑️ | ☑️ | ☑️ | ☑️ |
🌱 参数
| 参数名 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| height | string | '100%' | 高,可以是百分比,px,rpx等单位数字或者字符串。 |
| pullHeight | number | 60 | 下拉区域触发刷新的高度 |
| color | string | "" | 图标颜色,空值时,取全局主题色。 |
| textColor | string | "" | 文字颜色,空值时,取全局主题色。 |
| showScrollbar | boolean | true | 是否显示滚动条 |
| disabledPull | boolean | false | 是否禁用下拉刷新 |
| disabledBottom | boolean | false | 是否禁用触底刷新 |
| fristLoad | boolean | false | 是否进入就刷新数据 |
| 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元素 |
