Skip to content

FxProTable 表格

基于 @fx/componentsFxTable 封装的配置式业务表格,通过 columns 配置列,支持插槽自定义内容与表头、隐藏列、多选/序号/展开行。

FxProTable 属于 @fx/pro(业务级组件,UI 框架无关);底层渲染基于 @fx/componentsFxTable / FxTableColumn,不再直接依赖 Element Plus。

引入方式

ts
import { FxProTable } from "@fx/pro"
import type { FxProTableColumnType } from "@fx/pro"

Props

属性类型默认值说明
columnsFxProTableColumnType[][]列配置
dataRecord<string, unknown>[][]表格数据
loadingbooleanfalse加载状态
stripebooleantrue斑马纹

其余 FxTable 的属性和事件通过 $attrs 直接透传(border / height / row-key / @selection-change / @sort-change 等,完整列表见 FxTable)。

FxProTableColumnType

属性类型说明
type'selection' | 'index' | 'expand'特殊列类型
propstring字段名
labelstring列标题
width / minWidthstring | number列宽
fixedboolean | 'left' | 'right'固定列
align'left' | 'center' | 'right'对齐
sortableboolean | 'custom'是否可排序
showOverflowTooltipboolean溢出时显示 tooltip
slotstring自定义内容插槽名
headerSlotstring自定义表头插槽名
hiddenboolean是否隐藏该列

同时支持 FxTableColumn 的所有其他属性。

插槽

插槽名说明
default默认插槽,支持混用 columns + FxTableColumn
列的 slot自定义列内容,参数 { row, column, $index }
列的 headerSlot自定义列标题,参数 { column, $index }
expand展开行内容(type: 'expand' 时),参数 { row }

Methods

通过 ref 调用,内部暴露 FxTable 实例:

ts
const tableRef = ref()
tableRef.value.ref // FxTable 实例(可调用 clearSelection / toggleRowSelection 等)