# 数据网格

以网格方式展示数据,每一个网格对应数据表中的一行数据。

# 概念说明

# 属性

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

# 数据属性

组件数据源、数据类型、初始加载属性请参见组件数据源说明

  • 可分页:是否需要数据分页展示,默认关闭。

    • 开启:展示分页内容,调用数据源逻辑时会将分页信息作为入参传入。
    • 关闭:不展示分页内容。
  • 分页大小:每页的数据条数,默认 50。

  • 分页大小选项:每页显示数据条数的选择列表,需设置数组,如 [10,20,50]。

    分页大小

  • 当前页数:可设置加载出的网格处于第几页的位置。

  • 显示总条目数:开启时显示列表所有行数,默认关闭。

    • 开启:展示分页内容,调用数据源时会将数据源作为入参传入。
    • 关闭:不展示分页内容。
  • 显示分页大小:开启时显示分页大小选项,可选择每页显示条数,默认关闭。

  • 显示跳转输入:开启时可直接输入要跳转的页数,默认关闭。

    分页信息

  • 后端分页:数据网格内容展示,完全由数据源返回值控制,比如总条目数、数据展示条数等。默认开启。

# 状态属性

  • 加载中文字:加载中显示的文字,仅在使用分页加载时出现,默认正在加载中。

    加载中

  • 是否加载失败:开启后所有数据均不展示,仅展示加载失败文字,常用在数据源不是逻辑的时候,由外部触发组件的加载失败状态,默认关闭。

  • 加载失败文字:数据网格加载失败时展示的文字,加载失败,请重试。

    加载失败

  • 暂无数据文字:数据网格数据源返回值为空时展示的文字,默认暂无数据。

    暂无数据

# 选择属性

  • 只读:正常显示,但禁止选择或输入。
  • 禁用:置灰显示,且禁止任何交互(焦点、点击、选择、输入等)。

# 样式属性

  • 网格数:每行排列多少个网格。

  • 显示头部:显示数据网格列表标题,默认关闭。

  • 头部标题:数据网格列表标题,在开始显示头部功能后显示。

  • 显示底部:显示数据网格底部选项,如分页大小,跳转输入等,默认开启。

    样式属性

# 事件

数据网格包含数据源组件通用事件,请参见组件数据源说明

  • 选择前:选择某一项前触发。
  • 选择时:选择某一项时触发。
  • 选择后:选择某一项后触发。
  • 改变后:选择值改变时触发。

选择前、选择时、选择后、改变后,入参定义如下图。

参数说明

# 内置逻辑

数据网格包含数据源组件通用内置逻辑,请参见组件数据源说明

# 样式

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

上次更新: 2023年06月27日