Skip to content

表格基础

基础用法

传入 columnsdata 即可快速构建一个表格。

多级显示

columns 的 prop 支持 x.y.z 形式的 多(无限)级数据形式。

警告

数据级不宜过多,可能会影响性能。

options 字典

columns 中配置 options 时,Teek 会将当前 dataoptionsvalue 进行比对,如果相等则取出 optionslabel 作为单元格的显示内容。

匹配失败逻辑:如果 optionsvalue 都无法匹配到 data,则显示 --,如果您希望匹配不上时,显示 data,则使用 ignoreOptionIfAbsent: true 配置项。

自定义匹配逻辑:可以通过 transformOption 配置项自定义 options 的遍历和匹配逻辑(返回一个 option),当 transformOption 返回 undefined 时,则走匹配失败逻辑。

忽略 options 功能:当传入了 options,但是又希望单元格数据不走 options 匹配逻辑,而是直接渲染传入的 data 时,使用 isFilterOptions: false 配置项。

使用已有 options:通过 optionsProp 配置项指定使用某个 prop 已有的 options

options 字典配置

如果 options 的 key 不是 labelvalue,则通过 optionField 指定 labelvalue 的字段。

如果 elel-tag 或者 point-tag,则可以通过 options 指定 props 配置项,以 tagXxx 的形式传入。

多选列

columns 中配置 type: 'selection' 添加多选列,并且通过 selection-change 监听多选事件。

单选列

columns 中配置 type: 'radio' 添加索引单选列,并且通过 selection-change 监听索引事件。

通过使用 selectedRadio 配置项传入 ProTable 来指定默认单选行,值为 rowKey 对应的值

序号列

columns 中配置 type: 'index' 添加序号列。

拖拽列

columns 中配置 type: 'sort' 添加拖拽列。

展开行

columns 中配置 type: 'expand' 添加展开行,并搭配插槽 expand 使用。

{}

树形结构

配置 tree-props 树形为 children: 'children',数据结构中有 children 即可。 树形懒加载表格还需设置 lazyload

警告

数据中 children 中的 id 和表格 id 不能重复。row-key 默认为 id。

树形表格
notData
暂无数据
树形懒加载表格
notData
暂无数据

多级表头

通过在 columns 新增 children 配置,实现多级表头。

分页栏

通过 pageScope 开启分页栏,通过 pageInfo 配置分页信息,通过 paginationProps 配置 ElPagination 组件的 Props 属性。

pageScope 默认为前端分页,可以将 pageScope 设置为 server,并搭配 paginationChange 事件开启后端分页。

前端分页
共 6 条
  • 1
  • 2
前往
后端分页
notData
暂无数据
共 0 条
  • 1
前往

插槽自定义 icon

Teek 提供了一些 icon 插槽来自定义图标:

  • operation-more-icon: 操作栏更多旁边的 icon
  • drag-sort-icon: 表格拖拽行 icon
  • tooltip-icon:表格表头 tooltip icon
  • refresh-icon:表格顶部刷新按钮 icon
  • size-icon:表格顶部密度按钮 icon
  • export-icon:表格顶部导出按钮 icon
  • column-setting-icon:表格顶部列配置 icon
  • base-setting-icon:表格顶部基础设置 icon