主题
List 列表
使用
import { KList } from "@ksware/ksw-ux";用于处理长列表数据的组件。
基础用法
数据加载错误场景
API
Props
| 参数名 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| v-model:loading / loading | 是否显示加载中状态 | boolean | false |
| v-model:error / error | 是否显示错误状态 | boolean | false |
| finished | 是否显示已完成状态 | boolean | false |
| offset | 列表的偏移量,当滚动条离列表底部的距离小于 offset 时会触发 load 事件 | number | 0 |
| loadingText | 加载中状态的文字提示 | string | - |
| errorText | 错误状态的文字提示 | string | - |
| finishedText | 已完成状态的文字提示 | string | - |
| disabled | 是否禁用列表, disabled 时不会触发 load 事件 | boolean | false |
| scroller | 滚动区域的元素,默认为列表的最近的overflow: auto/scroll的祖先元素或者当前窗口滚动区域 | Element | - |
| immediate | 首次加载时是否判断滚动条是否触发 load 事件 | boolean | false |
Events
| 事件名 | 描述 | 类型 |
|---|---|---|
| load | 滚动条触底时触发的回调函数 | Function |
Methods
| 方法名 | 描述 | 类型 |
|---|---|---|
| check | 检查列表滚动条是否触底,如果触底,则触发 load 事件 | Function |
Slots
| 插槽名 | 描述 | 参数 |
|---|---|---|
| default | 列表的内容 | - |