PullToRefresh 拉动刷新 APP
该方法或组件支持移动端小程序调用
PC
该方法或组件支持桌面端小程序调用

通过触发,立刻重新加载内容。

规则

  • 可以和 List 结合使用,也可以单独使用。
  • 可考虑定期自动刷新, eg: 登录 App 后,自动刷新首页 List。

引入方式

数字生活小程序工程中,不需要 import,直接使用组件标签即可。

import { PullToRefresh } from '@21cnfe/vui'  
Vue.component('PullToRefresh', PullToRefresh)

代码演示

垂直方向 type 设置垂直方向,垂直方向分为上拉刷新和下拉刷新,可同时使用
<template>
<pull-to-refresh :indicator="indicator" :direction="direction" :isFinished.sync="isFinished" @onRefresh="refresh">
<div v-for="(item, index) in Data" :key="index">{{item.text}}</div>
</pull-to-refresh>
</template>
<script>
export default {
data() {
return {
Data: [],
isFinished: false,
direction: ['top', 'bottom'],
indicator: {
activate: '松开即可刷新',
deactivate: '下拉可以刷新',
release: '加载中...',
finish: '刷新成功'
}
}
},
mounted () {
this.setData()
},
methods: {
setData () {
this.Data = Array.from(new Array(10)).map((_val, i) => ({text: `${i}`}))
},
refresh () {
setTimeout(() => {
this.isFinished = true
this.Data.push({text: 10})
}, 1500)
}
}
}
</script>
水平方向 type 设置水平方向,垂直方向分为左拉刷新和右拉刷新,可同时使用
<template>
<pull-to-refresh :direction="direction" type="horizon" :isFinished.sync="isFinished" @onRefresh="refresh">
<div v-for="(item, index) in Data" :key="index">{{item.text}}</div>
</pull-to-refresh>
</template>
<script>
export default {
data() {
return {
Data: [],
isFinished: false,
direction: ['left', 'right'],
}
},
mounted () {
this.setData()
},
methods: {
setData () {
this.Data = Array.from(new Array(10)).map((_val, i) => ({text: `${i}`}))
},
refresh () {
setTimeout(() => {
this.isFinished = true
this.Data.push({text: 10})
}, 1500)
}
}
}
</script>

API

属性 说明 类型 默认值
type 刷新类型,可选值[vertical,horizon] String vertical
direction 拉动刷新方向,垂直类型可选值[top,bottom],水平类型可选值[left,right],数组值可填一个以在单个方向上拉动刷新 String top
indicator 指示器配置{ activate: '', deactivate: '', release: '', finish: '' } Object --
isFinished 刷新的状态 Boolean false
distanceToRefresh 刷新距离 Number 25
damping 拉动距离限制, 建议小于 200 Number 100
isStoped 是否停止加载 Boolean false

Event

事件名称 说明 回调参数
onRefresh 必选, 刷新回调函数 --

Slot

插槽名称 说明
匿名插槽 嵌入内容
  1. 1. PullToRefresh 拉动刷新 APP 该方法或组件支持移动端小程序调用 PC 该方法或组件支持桌面端小程序调用
    1. 1.1. 规则
    2. 1.2. 引入方式
    3. 1.3. 代码演示
    4. 1.4. API
    5. 1.5. Event
    6. 1.6. Slot