列表组件
- Source:
Members
(inner) props
- Source:
Properties:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
data |
Array |
<optional> |
静态数据 |
|
loader |
function |
<optional> |
加载数据回调函数,参数:page 页码,pageSize 页大小,必须返回Promise,数据格式:{list, total} |
|
显示列数,支持响应式,响应式设置对象 |
Number | Object | {xxl,xl,lg,md,sm,xs} |
||
fixColumns |
boolean |
<optional> |
修正不够一行的列, columns > 1 才有效 |
|
border |
boolean |
<optional> |
显示边框 |
|
split |
boolean |
<optional> |
显示分隔线 |
|
stripe |
boolean |
<optional> |
斑马条纹 |
|
size |
boolean |
<optional> |
尺寸, 可选 'large', 'small', 'mini', '' |
|
headerStyle |
Object |
<optional> |
头部样式 |
|
footerStyle |
Object |
<optional> |
底部样式 |
|
spin |
Object |
<optional> |
分页模式的加载中组件配置 {tip, size},参考MySpin组件 |
|
loading |
Boolean |
<optional> |
显示 加载中 |
|
mode |
string |
<optional> |
pager
|
列表模式,支持页码分页、滚动分页、虚拟列表,可选值:'pager', 'scroll', 'virtual' |
page |
number |
<optional> |
1
|
初始加载页码, 从1开始 |
pageSize |
number |
<optional> |
10
|
每页显示几条 |
total |
number |
<optional> |
0
|
数据条数 |
pagination |
Object |
<optional> |
分页其他配置, 如 {layout, background, small},参考ElPagination组件 |
|
auto |
boolean |
<optional> |
true
|
初始化完成后调用loader |
error |
boolean |
<optional> |
显示请求错误 |
|
scrollDelay |
number |
<optional> |
200
|
节流时延,单位为ms, 对滚动加载模式有效 |
scrollDistance |
number |
<optional> |
0
|
触发加载的距离阈值,单位为px, 对滚动加载模式有效 |
skeleton |
object |
<optional> |
加载中提示,对滚动加载模式有效 |
|
fit |
boolean |
<optional> |
适配父容器,虚拟列表默认自动要设置true |
|
itemHeight |
number |
<optional> |
列表项高度,虚拟列表必须要设置 |
属性参数
(inner) slots
- Source:
Properties:
Name | Type | Description |
---|---|---|
default |
string | 默认作用域插槽,参数:item 列表, index 数据索引, page 当前页码,pageSize 页面大小,total 数据总数 |
header |
string | 定义头部 |
footer |
string | 定义底部 |
skeleton |
string | 定义骨架加载效果,对滚动加载模式有效 |
empty |
string | 定义无数据显示效果 |
error |
string | 定义异常显示效果,参数error为true才有效 |
complete |
string | 定义滚动加载到底时显示内容 |
插槽
Methods
(inner) load()
- Source:
调用loader加载数据
(inner) refresh(pageopt)
- Source:
刷新列表
Parameters:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
page |
number |
<optional> |
1
|
刷新的页码 |
(inner) reset()
- Source:
重置滚动条,当元素隐藏后再显示,滚动条位置会丢失,可以调用该方法重置
(inner) scrollTop()
- Source:
滚到到顶部,fit=true 或 mode=virtual时有效
Events
error
- Source:
请求失败时触发
Parameters:
Name | Type | Description |
---|---|---|
e |
* | 错误信息 |
success
- Source:
请求成功时触发
Parameters:
Name | Type | Attributes | Description |
---|---|---|---|
res |
object |
<optional> |
请求响应数据 |