# 数据列表
用于展示大量结构化的数据。
# 概念说明
# 属性
组件通用属性请参见组件通用说明。
# 数据列表
# 数据属性
数据源:列表展示的数据。数据源可以绑定变量或者逻辑。变量或逻辑的返回值可以是数组,也可以是对象。对象格式为{list:[], total:10}。
数据类型:列表每一行的数据类型。该属性为展示属性,由数据源推倒得到,无需填写。
初始加载:是否在列表出现时立即加载数据,默认开启。
可分页:是否展示分页组件,数据源调用接口是否加入分页参数。默认开启。
每页数据条数:每页的数据条数。默认50条。在"可分页"属性开启时有效。
当前页数:当前加载的列表页。默认1。在"可分页"属性开启时有效。
分页大小选项:每页显示数据条数的选择列表,需设置数组,如[10,20,30,40,50]。在"可分页"属性开启时有效。
显示总条目数:分页组件处是否显示列表总数。默认关闭。在"可分页"属性开启时有效。
显示分页大小:是否展示数据条数的选择列表。默认开启。在"可分页"属性开启时有效。
显示跳转输入:分页组件处是否展示跳转到某一页的输入框。默认关闭。在"可分页"属性开启时有效。
可筛选:是否展示可筛选的输入框。默认关闭。
后端分页:表示数据列表的分页由接口处理。分页参数传入后端接口,由后端接口返回相应的数据。默认开始。关闭后,如果"可分页"属性开启,分页将由列表组件处理,不会发送后端接口。
匹配方式:筛选时的匹配方法。可写值"="、"=="、"eq"、"!="、"neq"、"<","lt","<=","lte",">","gt",">=","gte","includes","startsWith","endsWith"。也可传入处理函数。当"可筛选"属性开启时有效。
大小写敏感:表示筛选时是否大小写敏感。当"可筛选"属性开启时有效。
# 状态属性
- 加载中文字:当数据正在加载时展示的文字,默认为"加载中..."。
- 是否加载失败:控制表格加载失败的展示时机。默认关闭。
- 加载失败文字:加载失败的提示文字。默认"加载失败,请重试"。
- 暂无数据文字:当列表为空时的提示文字。默认"暂无数据"。
- 搜索框占位符:搜索框为空时提示文本,默认"请输入"。当"可筛选"属性开启时有效。
# 选择属性
- 值:在列表开启可多选时,指定数据唯一值的字段。
- 文本字段名:当开启可多选时,显示的选项文本字段名。
- 值字段名:当开启可多选时,选项值的字段名。当"可多选"属性开启时有效。
- 可取消:与"可多选"属性对应,表示选中的行再点击时是否可以取消选中。默认关闭。
- 可多选:列表的行是否可选中。默认关闭。
- repeat:每行排列几项。默认为5。
- 筛选清除按钮:搜索框是否有清除按钮,默认关闭。当"可筛选"属性开启时有效。
- 只读:正常显示,但禁止选择或输入。
- 禁用:置灰显示,且禁止任何交互(焦点、点击、选择、输入等)。
# 样式属性
- 显示头部:是否显示列表头。默认关闭。
- 列表标题:列表头部的标题信息。当"显示头部"属性开启时有效。
- 显示底部:显示列表底部,包括分页组件。默认开启。
- 显示边框:列表是否展示边框。默认关闭。
- 宽度:数据列表宽度。默认自适应。
- 高度:数据列表高度。默认正常。
- 字体颜色:动态设置列表列字体颜色。只可绑定变量或表达式。
- 背景颜色:动态设置列表背景颜色。只可绑定变量或表达式。
- 背景图片:动态设置列表背景图片。只可绑定变量或表达式。
# 事件
支持选择前、选择时、选择后、改变后、加载前、加载后事件。
# 样式
样式说明请参见组件通用说明。
# 列表内置逻辑
- load:带缓存加载数据。
- reload:清除缓存,重新加载数据。
在新增、修改、删除数据等操作后,一般调用reload逻辑重新加载列表数据,用户修改信息后会即时呈现数据。
# 示例
放置实体到数据列表组件中,即可生成一个数据列表展示: