$ui/components/my-list

列表组件

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>

请求响应数据