# 数据列表

用于展示大量结构化的数据。

# 概念说明

# 属性

组件通用属性请参见组件通用说明

# 数据列表

# 数据属性
  • 数据源:列表展示的数据。数据源可以绑定变量或者逻辑。变量或逻辑的返回值可以是数组,也可以是对象。对象格式为{list:[], total:10}。

  • 数据类型:列表每一行的数据类型。该属性为展示属性,由数据源推倒得到,无需填写。

  • 初始加载:是否在列表出现时立即加载数据,默认开启。

  • 可分页:是否展示分页组件,数据源调用接口是否加入分页参数。默认开启。

  • 每页数据条数:每页的数据条数。默认50条。在"可分页"属性开启时有效。

  • 当前页数:当前加载的列表页。默认1。在"可分页"属性开启时有效。

  • 分页大小选项:每页显示数据条数的选择列表,需设置数组,如[10,20,30,40,50]。在"可分页"属性开启时有效。

  • 显示总条目数:分页组件处是否显示列表总数。默认关闭。在"可分页"属性开启时有效。

  • 显示分页大小:是否展示数据条数的选择列表。默认开启。在"可分页"属性开启时有效。

  • 显示跳转输入:分页组件处是否展示跳转到某一页的输入框。默认关闭。在"可分页"属性开启时有效。

  • 可筛选:是否展示可筛选的输入框。默认关闭。

  • 后端分页:表示数据列表的分页由接口处理。分页参数传入后端接口,由后端接口返回相应的数据。默认开始。关闭后,如果"可分页"属性开启,分页将由列表组件处理,不会发送后端接口。

  • 匹配方式:筛选时的匹配方法。可写值"="、"=="、"eq"、"!="、"neq"、"<","lt","<=","lte",">","gt",">=","gte","includes","startsWith","endsWith"。也可传入处理函数。当"可筛选"属性开启时有效。

  • 大小写敏感:表示筛选时是否大小写敏感。当"可筛选"属性开启时有效。

# 状态属性
  • 加载中文字:当数据正在加载时展示的文字,默认为"加载中..."。
  • 是否加载失败:控制表格加载失败的展示时机。默认关闭。
  • 加载失败文字:加载失败的提示文字。默认"加载失败,请重试"。
  • 暂无数据文字:当列表为空时的提示文字。默认"暂无数据"。
  • 搜索框占位符:搜索框为空时提示文本,默认"请输入"。当"可筛选"属性开启时有效。
# 选择属性
  • 值:在列表开启可多选时,指定数据唯一值的字段。
  • 文本字段名:当开启可多选时,显示的选项文本字段名。
  • 值字段名:当开启可多选时,选项值的字段名。当"可多选"属性开启时有效。
  • 可取消:与"可多选"属性对应,表示选中的行再点击时是否可以取消选中。默认关闭。
  • 可多选:列表的行是否可选中。默认关闭。
  • repeat:每行排列几项。默认为5。
  • 筛选清除按钮:搜索框是否有清除按钮,默认关闭。当"可筛选"属性开启时有效。
  • 只读:正常显示,但禁止选择或输入。
  • 禁用:置灰显示,且禁止任何交互(焦点、点击、选择、输入等)。
# 样式属性
  • 显示头部:是否显示列表头。默认关闭。
  • 列表标题:列表头部的标题信息。当"显示头部"属性开启时有效。
  • 显示底部:显示列表底部,包括分页组件。默认开启。
  • 显示边框:列表是否展示边框。默认关闭。
  • 宽度:数据列表宽度。默认自适应。
  • 高度:数据列表高度。默认正常。
  • 字体颜色:动态设置列表列字体颜色。只可绑定变量或表达式。
  • 背景颜色:动态设置列表背景颜色。只可绑定变量或表达式。
  • 背景图片:动态设置列表背景图片。只可绑定变量或表达式。

# 事件

支持选择前、选择时、选择后、改变后、加载前、加载后事件。

# 样式

样式说明请参见组件通用说明

# 列表内置逻辑

  • load:带缓存加载数据。
  • reload:清除缓存,重新加载数据。

在新增、修改、删除数据等操作后,一般调用reload逻辑重新加载列表数据,用户修改信息后会即时呈现数据。

# 示例

放置实体到数据列表组件中,即可生成一个数据列表展示:

image-20230607105700030

上次更新: 2023年06月15日