vant做表格_VantList列表
介绍
瀑布流滚动加载,⽤于展⽰长列表,当列表即将滚动到底部时,会触发事件并加载更多列表项。
引⼊import Vue from 'vue';
import { List } from 'vant';
Vue.use(List);
代码演⽰
基础⽤法
List 组件通过loading和finished两个变量控制加载状态,当组件滚动到底部时,会触发load事件并将loading设置成true。此时可以发起异步操作并更新数据,数据更新完毕后,将loading设置成false即可。若数据已全部加载完毕,则直接将finished设置成true即可。
v-model="loading"
:finished="finished"
finished-text="没有更多了"
@load="onLoad"
>
export default {
data() {
return {
list: [],
loading: false,
finished: false
};
},
methods: {
onLoad() {
// 异步更新数据
// setTimeout 仅做⽰例,真实场景中⼀般为 ajax 请求
setTimeout(() => {
for (let i = 0; i < 10; i++) {
this.list.push(this.list.length + 1);
}
// 加载状态结束
this.loading = false;
/
/ 数据全部加载完成
if (this.list.length >= 40) {
this.finished = true;
}
}, 1000);
}
}
相当于怎么造句}
错误提⽰
若列表数据加载失败,将error设置成true即可显⽰错误提⽰,⽤户点击错误提⽰后会重新触发 load 事件。v-model="loading"
:error.sync="error"
error-text="请求失败,点击重新加载"
@load="onLoad"
>
export default {
data() {
return {
list: [],
error: false,
loading: false
};
},
methods: {
onLoad() {
fetchSomeThing().catch(() => {
< = true;
})
}
中国十大名校排名
}
}
下拉刷新
List 组件可以与 PullRefresh 组件结合使⽤,实现下拉刷新的效果
v-model="loading"
:
finished="finished"
finished-text="没有更多了"
@load="onLoad"
>
export default {
data() {新能源科学与工程
return {
list: [],
loading: false,
finished: false,
refreshing: false
};
},
methods: {
onLoad() {
军训感悟800字setTimeout(() => {
if (freshing) {
this.list = [];
}
for (let i = 0; i < 10; i++) {
this.list.push(this.list.length + 1);
}
this.loading = false;
if (this.list.length >= 40) {
this.finished = true;
}
}, 1000);
},
onRefresh() {
// 清空列表数据
this.finished = false;
// 重新加载数据
/
/ 将 loading 设置为 true,表⽰处于加载状态this.loading = true;
}
}
}
API
Props参数说明类型默认值v-model是否处于加载状态,加载过程中不触发load事件booleanfalse
finished是否已加载完成,加载完成后不再触发load事件booleanfalse
好名
error是否加载失败,加载失败后点击错误提⽰可以重新
触发load事件,必须使⽤sync修饰符booleanfalse
offset滚动条与底部距离⼩于 offset 时触发load事件number | string300
wps云文档
loading-text加载过程中的提⽰⽂案string加载中...
finished-text加载完成后的提⽰⽂案string-
error-text加载失败后的提⽰⽂案string-
immediate-check是否在初始化时⽴即执⾏滚动位置检查booleantrue
direction滚动触发加载的⽅向,可选值为upstringdown
Events事件名说明回调参数load滚动条与底部距离⼩于 offset 时触发-
⽅法
通过 ref 可以获取到 List 实例并调⽤实例⽅法,详见 组件实例⽅法⽅法名说明参数返回值check检查当前的滚动位置,若已滚动⾄底部,则会触发 load 事件--
Slots名称说明default列表内容
loading⾃定义底部加载中提⽰
finished⾃定义加载完成后的提⽰⽂案
error⾃定义加载失败后的提⽰⽂案
常见问题
List 的运⾏机制是什么?
List 会监听浏览器的滚动事件并计算列表的位置,当列表底部与可视区域的距离⼩于offset时,List 会触发⼀次 load 事件。
为什么 List 初始化后会⽴即触发 load 事件?
List 初始化后会触发⼀次 load 事件,⽤于加载第⼀屏的数据,这个特性可以通过immediate-check属性关闭。
为什么会连续触发 load 事件?
如果⼀次请求加载的数据条数较少,导致列表内容⽆法铺满当前屏幕,List 会继续触发 load 事件,直到内容铺满屏幕或数据全部加载完成。因此你需要调整每次获取的数据条数,理想情况下每次请求获取的数据条数应能够填满⼀屏⾼度。
loading 和 finished 分别是什么含义?
List有以下三种状态,理解这些状态有助于你正确地使⽤List组件:⾮加载中,loading为false,此时会根据列表滚动位置判断是否触发load事件(列表内容不⾜⼀屏幕时,会直接触发)
加载中,loading为true,表⽰正在发送异步请求,此时不会触发load事件
加载完成,finished为true,此时不会触发load事件
在每次请求完毕后,需要⼿动将loading设置为false,表⽰加载结束
使⽤ float 布局后⼀直触发加载?
若 List 的内容使⽤了 float 布局,可以在容器上添加van-clearfix类名来清除浮动,使得 List 能正确判断元素位置
在 html、body 上设置 overflow 后⼀直触发加载?
如果在 html 和 body 标签上设置了overflow-x: hidden样式,会导致 List ⼀直触发加载。html,
body {
overflow-x: hidden;
}
这个问题的原因是当元素设置了overflow-x: hidden样式时,该元素的overflow-y会被浏览器设置为auto,⽽不是默认值visible,导致List ⽆法正确地判断滚动容器。解决⽅法是去除该样式,或者在 html 和 body 标签上添加height: 100%样式。