x-next 1.12.0 → 1.14.0

package/AI_USAGE/components/table-api.md

@@ -0,0 +1,2919 @@
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
+# Table 完整公开 API
+
+适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+
+从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
+
+## Table API
+
+公开声明：`dist/components/table/index.d.ts`。 类型中的 undefined 表示可省略；原始 prop 默认值不等于继承配置或服务默认值。
+
+### Props
+
+| 名称 | 用途 | 公开类型 | 必填 | 声明默认值 |
+| --- | --- | --- | --- | --- |
+| columns | 表格列配置 | undefined &#124; TableColumnData[] | 否 | [] |
+| keyboardNavigation | 启用表体单元格方向键、Home / End 导航，保留内嵌控件的键盘行为 | undefined &#124; false &#124; true | 否 | false |
+| data | 表格数据 | undefined &#124; TableData[] | 否 | [] |
+| bordered | 是否显示边框 | undefined &#124; false &#124; true &#124; TableBorder | 否 | false |
+| hoverable | 是否显示行悬浮效果 | undefined &#124; false &#124; true | 否 | true |
+| stripe | 是否显示斑马纹 | undefined &#124; false &#124; true | 否 | false |
+| size | 表格尺寸 | undefined &#124; "mini" &#124; "small" &#124; "medium" &#124; "large" | 否 | undefined |
+| tableLayoutFixed | 是否使用 fixed 表格布局 | undefined &#124; false &#124; true | 否 | false |
+| loading | 是否加载中，默认主题色圆环；object 会透传给 Spin | undefined &#124; false &#124; true &#124; { [x: string]: any; } | 否 | false |
+| rowSelection | 行选择配置 | undefined &#124; TableRowSelection | 否 | 未声明 |
+| expandable | 展开行配置 | undefined &#124; TableExpandable | 否 | 未声明 |
+| scroll | 滚动配置 | undefined &#124; { x?: number &#124; string; y?: number &#124; string; minWidth?: number &#124; string; maxHeight?: number &#124; string; } | 否 | 未声明 |
+| pagination | 分页配置，传 false 可关闭分页 | undefined &#124; false &#124; true &#124; PaginationProps | 否 | true |
+| pagePosition | 分页位置 | undefined &#124; "top" &#124; "bottom" &#124; "tl" &#124; "tr" &#124; "bl" &#124; "br" | 否 | "br" |
+| indentSize | 树形表格缩进距离 | undefined &#124; number | 否 | 16 |
+| rowKey | 表格行 key 字段 | undefined &#124; string | 否 | "key" |
+| showHeader | 是否显示表头 | undefined &#124; false &#124; true | 否 | true |
+| virtualListProps | 虚拟列表配置，传入后开启虚拟滚动 | undefined &#124; VirtualListProps | 否 | 未声明 |
+| spanMethod | 单元格合并方法 | undefined &#124; (data: { record: TableData; column: TableColumnData &#124; TableOperationColumn; rowIndex: number; columnIndex: number; }) => { rowspan?: number; colspan?: number; } &#124; void | 否 | 未声明 |
+| spanAll | 合并方法索引是否包含操作列 | undefined &#124; false &#124; true | 否 | false |
+| components | 自定义内部操作列组织方式 | undefined &#124; TableComponents | 否 | 未声明 |
+| loadMore | 树形数据懒加载函数 | undefined &#124; (record: TableData, done: (children?: TableData[]) => void) => void | 否 | 未声明 |
+| filterIconAlignLeft | 筛选图标是否左对齐 | undefined &#124; false &#124; true | 否 | false |
+| hideExpandButtonOnEmpty | 子树为空时是否隐藏展开按钮 | undefined &#124; false &#124; true | 否 | false |
+| rowClass | 行 class，支持函数 | undefined &#124; string &#124; any[] &#124; { [x: string]: any; } &#124; (record: TableData, rowIndex: number) => any | 否 | 未声明 |
+| draggable | 拖拽排序配置 | undefined &#124; TableDraggable | 否 | 未声明 |
+| columnResizable | 是否允许调整列宽 | undefined &#124; false &#124; true | 否 | false（Vue Boolean 转换） |
+| summary | 是否显示总结行，或自定义总结数据 | undefined &#124; false &#124; true &#124; (params: { columns: TableColumnData[]; data: TableData[]; }) => TableData[] | 否 | false（Vue Boolean 转换） |
+| summaryText | 默认总结行首列文字 | undefined &#124; string | 否 | undefined |
+| summarySpanMethod | 总结行单元格合并方法 | undefined &#124; (data: { record: TableData; column: TableColumnData &#124; TableOperationColumn; rowIndex: number; columnIndex: number; }) => { rowspan?: number; colspan?: number; } &#124; void | 否 | 未声明 |
+| selectedKeys | 已选择行 key，受控模式 | undefined &#124; (string &#124; number)[] | 否 | 未声明 |
+| defaultSelectedKeys | 默认已选择行 key | undefined &#124; (string &#124; number)[] | 否 | 未声明 |
+| expandedKeys | 已展开行 key，受控模式 | undefined &#124; (string &#124; number)[] | 否 | 未声明 |
+| defaultExpandedKeys | 默认展开行 key | undefined &#124; (string &#124; number)[] | 否 | 未声明 |
+| defaultExpandAllRows | 是否默认展开全部行 | undefined &#124; false &#124; true | 否 | false |
+| stickyHeader | 是否开启表头吸顶，数字表示 top 偏移 | undefined &#124; number &#124; false &#124; true | 否 | false |
+| scrollbar | 是否使用自定义滚动条，或传入 Scrollbar 配置 | undefined &#124; false &#124; true &#124; ScrollbarProps | 否 | true |
+| showEmptyTree | 是否展示空子树 | undefined &#124; false &#124; true | 否 | false |
+
+### Events
+
+| 事件 | 用途 | 监听器签名（即事件参数） |
+| --- | --- | --- |
+| update:selectedKeys | 选中行变化时触发 | undefined &#124; (rowKeys: (string &#124; number)[]) => any |
+| update:expandedKeys | 展开行变化时触发 | undefined &#124; (rowKeys: (string &#124; number)[]) => any |
+| expand | 点击展开行时触发 | undefined &#124; (rowKey: string &#124; number, record: TableData) => any |
+| expandedChange | 展开行变化时触发 | undefined &#124; (rowKeys: (string &#124; number)[]) => any |
+| select | 点击行选择器时触发 | undefined &#124; (rowKeys: (string &#124; number)[], rowKey: string &#124; number, record: TableData) => any |
+| selectAll | 点击全选选择器时触发 | undefined &#124; (checked: boolean) => any |
+| selectionChange | 已选择行变化时触发 | undefined &#124; (rowKeys: (string &#124; number)[]) => any |
+| sorterChange | 排序规则变化时触发 | undefined &#124; (dataIndex: string, direction: string) => any |
+| filterChange | 筛选项变化时触发 | undefined &#124; (dataIndex: string, filteredValues: string[]) => any |
+| pageChange | 分页页码变化时触发 | undefined &#124; (page: number) => any |
+| pageSizeChange | 每页数量变化时触发 | undefined &#124; (pageSize: number) => any |
+| change | 分页、排序、筛选、拖拽变化时触发 | undefined &#124; (data: TableData[], extra: TableChangeExtra, currentData: TableData[]) => any |
+| cellMouseEnter | 鼠标进入单元格时触发 | undefined &#124; (record: TableData, column: TableColumnData, ev: Event) => any |
+| cellMouseLeave | 鼠标离开单元格时触发 | undefined &#124; (record: TableData, column: TableColumnData, ev: Event) => any |
+| cellClick | 点击单元格时触发 | undefined &#124; (record: TableData, column: TableColumnData, ev: Event) => any |
+| rowClick | 点击行时触发 | undefined &#124; (record: TableData, ev: Event) => any |
+| headerClick | 点击表头时触发 | undefined &#124; (column: TableColumnData, ev: Event) => any |
+| columnResize | 调整列宽时触发 | undefined &#124; (dataIndex: string, width: number) => any |
+| rowDblclick | 双击行时触发 | undefined &#124; (record: TableData, ev: Event) => any |
+| cellDblclick | 双击单元格时触发 | undefined &#124; (record: TableData, column: TableColumnData, ev: Event) => any |
+| rowContextmenu | 右击行时触发 | undefined &#124; (record: TableData, ev: Event) => any |
+| cellContextmenu | 右击单元格时触发 | undefined &#124; (record: TableData, column: TableColumnData, ev: Event) => any |
+
+### Slots
+
+| 名称 | 用途 | 公开类型 |
+| --- | --- | --- |
+| default | TableColumn 声明式列，或自定义 table 内容 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| columns | TableColumn 声明式列 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| expand-icon | 自定义展开图标 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| expand-row | 展开行内容 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| footer | 表格底部内容 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| drag-handle-icon | 拖拽手柄图标 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| tbody | 自定义 tbody 元素 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| tr | 自定义 tr 元素 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| td | 自定义 td 元素 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| pagination-left | 分页器左侧内容 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| pagination-right | 分页器右侧内容 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| summary-cell | 总结行单元格 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| empty | 空态内容 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| thead | 自定义 thead 元素 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| th | 自定义 th 元素 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+
+### 实例方法 / 暴露值
+
+| 名称 | 公开类型 |
+| --- | --- |
+| selectAll | (checked?: boolean) => void |
+| select | (rowKey: string &#124; number &#124; (string &#124; number)[], checked?: boolean) => void |
+| expandAll | (checked?: boolean) => void |
+| expand | (rowKey: string &#124; number &#124; (string &#124; number)[], checked?: boolean) => void |
+| resetFilters | (dataIndex?: string &#124; string[]) => void |
+| clearFilters | (dataIndex?: string &#124; string[]) => void |
+| resetSorters | () => void |
+| clearSorters | () => void |
+
+### 关联类型定义
+
+以下摘自本组件族声明，供查阅嵌套配置；运行时和值类型均以根入口可导出项为准。
+
+```typescript-reference
+declare const TABLE_PAGE_POSITION: readonly ["tl", "top", "tr", "bl", "bottom", "br"];
+
+type TablePagePosition = (typeof TABLE_PAGE_POSITION)[number];
+
+interface TableData {
+    /**
+     * @zh 数据行的key
+     * @en The key of the data row
+     */
+    key?: string | number;
+    /**
+     * @zh 扩展行内容
+     * @en Expand row content
+     */
+    expand?: string | RenderFunction;
+    /**
+     * @zh 子数据
+     * @en Sub data
+     */
+    children?: TableData[];
+    /**
+     * @zh 是否禁用行选择器
+     * @en Whether to disable the row selector
+     */
+    disabled?: boolean;
+    /**
+     * @zh 是否是叶子节点
+     * @en Whether it is a leaf node
+     * @version 2.13.0
+     */
+    isLeaf?: boolean;
+    [name: string]: any;
+}
+
+interface TableDataWithRaw {
+    raw: TableData;
+    key: string | number;
+    disabled?: boolean;
+    expand?: string | RenderFunction;
+    children?: TableDataWithRaw[];
+    isLeaf?: boolean;
+    hasSubtree?: boolean;
+}
+
+interface TableSortable {
+    /**
+     * @zh 支持的排序方向
+     * @en Supported sort direction
+     */
+    sortDirections: ('ascend' | 'descend')[];
+    /**
+     * @zh 排序函数。设置为 `true` 可关闭内部排序。2.19.0 版本修改传出数据。
+     * @en Sorting function. Set to `true` to turn off internal sorting. Version 2.19.0 modifies outgoing data.
+     */
+    sorter?: ((a: TableData, b: TableData, extra: {
+        dataIndex: string;
+        direction: 'ascend' | 'descend';
+    }) => number) | boolean;
+    /**
+     * @zh 排序方向
+     * @en Sort direction
+     */
+    sortOrder?: 'ascend' | 'descend' | '';
+    /**
+     * @zh 默认排序方向（非受控模式）
+     * @en Default sort direction (uncontrolled mode)
+     */
+    defaultSortOrder?: 'ascend' | 'descend' | '';
+    /**
+     * @zh 多列排序优先级，数字越大越先比较；只在声明优先级的列之间保留多列排序。
+     * @en Multi-column sort priority. Higher values are compared first.
+     */
+    sortPriority?: number;
+}
+
+interface TableFilterData {
+    /**
+     * @zh 筛选数据选项的内容
+     * @en Filter the content of the data option
+     */
+    text: string | RenderFunction;
+    /**
+     * @zh 筛选数据选项的值
+     * @en Filter the value of the data option
+     */
+    value: string;
+}
+
+interface TableFilterable {
+    /**
+     * @zh 筛选数据
+     * @en Filter data
+     */
+    filters?: TableFilterData[];
+    /**
+     * @zh 筛选函数
+     * @en Filter function
+     */
+    filter: (filteredValue: string[], record: TableData) => boolean;
+    /**
+     * @zh 是否支持多选
+     * @en Whether to support multiple selection
+     */
+    multiple?: boolean;
+    /**
+     * @zh 筛选项
+     * @en Filter value
+     */
+    filteredValue?: string[];
+    /**
+     * @zh 默认筛选项
+     * @en Default filter value
+     */
+    defaultFilteredValue?: string[];
+    /**
+     * @zh 筛选框的内容
+     * @en The content of filter box
+     */
+    renderContent?: (data: {
+        filterValue: string[];
+        setFilterValue: (filterValue: string[]) => void;
+        handleFilterConfirm: (event: Event) => void;
+        handleFilterReset: (event: Event) => void;
+    }) => VNodeChild;
+    /**
+     * @zh 筛选按钮的图标
+     * @en Filter icon for button
+     */
+    icon?: RenderFunction;
+    /**
+     * @zh 筛选框的弹出框配置
+     * @en Pop-up box configuration of filter box
+     */
+    triggerProps?: TriggerProps;
+    /**
+     * @zh 筛选图标是否左对齐
+     * @en Whether the filter icon is aligned to the left
+     * @version 2.13.0
+     */
+    alignLeft?: boolean;
+    slotName?: string;
+}
+
+interface TableColumnData {
+    /**
+     * @zh 列信息的标识，对应 `TableData` 中的数据
+     * @en The identifier of the column information, corresponding to the data in `TableData`
+     */
+    dataIndex?: string;
+    /**
+     * @zh 列标题
+     * @en Column header
+     */
+    title?: string | RenderFunction;
+    /**
+     * @zh 列宽度
+     * @en Column width
+     */
+    width?: number;
+    /**
+     * @zh 最小列宽
+     * @en Minimum column width
+     */
+    minWidth?: number;
+    /**
+     * @zh 对齐方向
+     * @en Alignment direction
+     */
+    align?: 'left' | 'center' | 'right';
+    /**
+     * @zh 固定位置
+     * @en Fixed position
+     */
+    fixed?: 'left' | 'right';
+    /**
+     * @zh 是否显示省略号
+     * @en Whether to show ellipsis
+     */
+    ellipsis?: boolean;
+    /**
+     * @zh 是否在显示省略号时显示文本提示。可填入 tooltip 组件属性
+     * @en Whether to show a text hint when an ellipsis is displayed. Can be filled in tooltip component properties
+     * @version 2.26.0
+     */
+    tooltip?: boolean | Record<string, any>;
+    /**
+     * @zh 排序相关选项
+     * @en Sorting related options
+     */
+    sortable?: TableSortable;
+    /**
+     * @zh 过滤相关选项
+     * @en Filter related options
+     */
+    filterable?: TableFilterable;
+    /**
+     * @zh 表头子数据，用于表头分组
+     * @en Header sub-data, used for header grouping
+     */
+    children?: TableColumnData[];
+    /**
+     * @zh 自定义单元格类名
+     * @en Custom cell class
+     * @version 2.36.0
+     */
+    cellClass?: ClassName;
+    /**
+     * @zh 自定义表头单元格类名
+     * @en Custom header cell class
+     * @version 2.36.0
+     */
+    headerCellClass?: ClassName;
+    /**
+     * @zh 自定义内容单元格类名
+     * @en Custom body cell class
+     * @version 2.36.0
+     */
+    bodyCellClass?: ClassName | ((record: TableData) => ClassName);
+    /**
+     * @zh 自定义总结栏单元格类名
+     * @en Custom body cell class
+     * @version 2.36.0
+     */
+    summaryCellClass?: ClassName | ((record: TableData) => ClassName);
+    /**
+     * @zh 自定义单元格样式
+     * @en Custom cell style
+     * @version 2.11.0
+     */
+    cellStyle?: CSSProperties;
+    /**
+     * @zh 自定义表头单元格样式
+     * @en Custom header cell style
+     * @version 2.29.0
+     */
+    headerCellStyle?: CSSProperties;
+    /**
+     * @zh 自定义内容单元格样式
+     * @en Custom body cell style
+     * @version 2.29.0
+     */
+    bodyCellStyle?: CSSProperties | ((record: TableData) => CSSProperties);
+    /**
+     * @zh 自定义总结栏单元格样式
+     * @en Custom summary cell style
+     * @version 2.30.0
+     */
+    summaryCellStyle?: CSSProperties | ((record: TableData) => CSSProperties);
+    /**
+     * @zh 自定义列单元格的渲染
+     * @en Customize the rendering of column cells
+     */
+    render?: (data: {
+        record: TableData;
+        column: TableColumnData;
+        rowIndex: number;
+    }) => VNodeChild;
+    /**
+     * @zh 设置当前列的渲染插槽的名字。插槽参数同 #cell
+     * @en Sets the name of the render slot for the current column. Slot parameters are the same as #cell
+     * @version 2.18.0
+     */
+    slotName?: string;
+    /**
+     * @zh 设置当前列的标题的渲染插槽的名字
+     * @en Set the name of the render slot for the header of the current column
+     * @version 2.23.0
+     */
+    titleSlotName?: string;
+    slots?: Slots;
+    isLastLeftFixed?: boolean;
+    isFirstRightFixed?: boolean;
+    colSpan?: number;
+    rowSpan?: number;
+    index?: number;
+    parent?: TableColumnData;
+    _resizeWidth?: number;
+}
+
+interface TableBorder {
+    /**
+     * @zh 是否展示外边框
+     * @en TWhether to display the outer border
+     */
+    wrapper?: boolean;
+    /**
+     * @zh 是否展示单元格边框（表头+主体）
+     * @en Whether to display the cell border (header + body)
+     */
+    cell?: boolean;
+    /**
+     * @zh 是否展示表头单元格边框
+     * @en Whether to display the header cell border
+     */
+    headerCell?: boolean;
+    /**
+     * @zh 是否展示主体单元格边框
+     * @en Whether to display the body cell border
+     */
+    bodyCell?: boolean;
+}
+
+interface TableRowSelection {
+    /**
+     * @zh 行选择器的类型
+     * @en The type of row selector
+     */
+    type?: 'checkbox' | 'radio';
+    /**
+     * @zh 已选择的行（受控模式）
+     * @en Selected row (controlled mode)
+     */
+    selectedRowKeys?: BaseType[];
+    /**
+     * @zh 默认已选择的行（非受控模式）
+     * @en The selected row by default (uncontrolled mode)
+     */
+    defaultSelectedRowKeys?: BaseType[];
+    /**
+     * @zh 是否显示全选选择器
+     * @en Whether to show the select all selector
+     */
+    showCheckedAll?: boolean;
+    /**
+     * @zh 列标题
+     * @en Column title
+     */
+    title?: string;
+    /**
+     * @zh 列宽度
+     * @en Column width
+     */
+    width?: number;
+    /**
+     * @zh 是否固定
+     * @en Is it fixed
+     */
+    fixed?: boolean;
+    /**
+     * @zh 是否开启严格选择模式
+     * @en Whether to enable strict selection mode
+     * @defaultValue true
+     * @version 2.29.0
+     */
+    checkStrictly?: boolean;
+    /**
+     * @zh 是否仅展示当前页的 keys（切换分页时清空 keys）
+     * @en Whether to display only the keys of the current page (clear keys when switching paging)
+     * @version 2.32.0
+     */
+    onlyCurrent?: boolean;
+}
+
+interface TableExpandable {
+    /**
+     * @zh 显示的展开行（受控模式）
+     * @en Displayed Expanded Row (Controlled Mode)
+     */
+    expandedRowKeys?: BaseType[];
+    /**
+     * @zh 默认显示的展开行（非受控模式）
+     * @en Expand row displayed by default (Uncontrolled mode)
+     */
+    defaultExpandedRowKeys?: BaseType[];
+    /**
+     * @zh 是否默认展开所有的行
+     * @en Whether to expand all rows by default
+     */
+    defaultExpandAllRows?: boolean;
+    /**
+     * @zh 自定义展开行内容
+     * @en Customize expanded row content
+     */
+    expandedRowRender?: (record: TableData) => VNodeChild;
+    /**
+     * @zh 展开图标
+     * @en Expand icon
+     */
+    icon?: (expanded: boolean, record: TableData) => VNodeChild;
+    /**
+     * @zh 列标题
+     * @en Column title
+     */
+    title?: string;
+    /**
+     * @zh 列宽度
+     * @en Column width
+     */
+    width?: number;
+    /**
+     * @zh 是否固定
+     * @en Is it fixed
+     */
+    fixed?: boolean;
+}
+
+interface TableDraggable {
+    /**
+     * @zh 拖拽类型
+     * @en drag type
+     */
+    type?: 'row' | 'handle';
+    /**
+     * @zh 列标题
+     * @en Column title
+     */
+    title?: string;
+    /**
+     * @zh 列宽度
+     * @en Column width
+     */
+    width?: number;
+    /**
+     * @zh 是否固定
+     * @en Is it fixed
+     */
+    fixed?: boolean;
+}
+
+type OperationName = 'selection-checkbox' | 'selection-radio' | 'expand' | 'drag-handle';
+
+interface TableOperationColumn {
+    name: OperationName | string;
+    title?: string | RenderFunction;
+    width?: number;
+    fixed?: boolean;
+    render?: (record: TableData) => VNodeChild;
+    isLastLeftFixed?: boolean;
+}
+
+interface TableComponents {
+    operations: (operations: {
+        dragHandle?: TableOperationColumn;
+        expand?: TableOperationColumn;
+        selection?: TableOperationColumn;
+    }) => TableOperationColumn[];
+}
+
+interface TableChangeExtra {
+    /**
+     * @zh 触发类型
+     * @en Trigger type
+     */
+    type: 'pagination' | 'sorter' | 'filter' | 'drag';
+    /**
+     * @zh 页码
+     * @en page number
+     */
+    page?: number;
+    /**
+     * @zh 每页数据数
+     * @en number per page
+     */
+    pageSize?: number;
+    /**
+     * @zh 排序信息
+     * @en Sort information
+     */
+    sorter?: Sorter;
+    /** 按优先级排列的全部排序条件；sorter 保留首个条件以兼容已有消费方。 */
+    sorters?: Sorter[];
+    /**
+     * @zh 筛选信息
+     * @en Filter information
+     */
+    filters?: Filters;
+    /**
+     * @zh 拖拽信息
+     * @en Drag and drop information
+     */
+    dragTarget?: TableData;
+}
+
+interface TableInternalProps {
+    columns: TableColumnData[];
+    data: TableData[];
+    bordered?: boolean | TableBorder;
+    rowSelection?: TableRowSelection;
+    expandable?: TableExpandable;
+    pagination?: boolean | Data;
+    pagePosition?: string;
+}
+
+type Sorter = {
+    field: string;
+    direction: 'ascend' | 'descend';
+};
+
+type Filters = Record<string, string[]>;
+
+declare const TD_TYPES: readonly ["normal", "operation", "checkbox", "radio", "expand"];
+
+type TdTypes = (typeof TD_TYPES)[number];
+
+type TableInstance = InstanceType<typeof _Table>;
+
+type TableProps = InstanceType<typeof _Table>['$props'];
+
+type TheadInstance = InstanceType<typeof _Thead>;
+
+type TbodyInstance = InstanceType<typeof _Tbody>;
+
+type TrInstance = InstanceType<typeof _Tr>;
+
+type ThInstance = InstanceType<typeof _Th>;
+
+type TdInstance = InstanceType<typeof _Td>;
+
+type TableColumnInstance = InstanceType<typeof _TableColumn>;
+```
+
+
+## TableColumn API
+
+公开声明：`dist/components/table/index.d.ts`。 类型中的 undefined 表示可省略；原始 prop 默认值不等于继承配置或服务默认值。
+
+### Props
+
+| 名称 | 用途 | 公开类型 | 必填 | 声明默认值 |
+| --- | --- | --- | --- | --- |
+| dataIndex | 列字段名 | undefined &#124; string | 否 | 未声明 |
+| title | 列标题 | undefined &#124; string | 否 | 未声明 |
+| width | 列宽 | undefined &#124; number | 否 | 未声明 |
+| minWidth | 最小列宽 | undefined &#124; number | 否 | 未声明 |
+| align | 对齐方式 | undefined &#124; "center" &#124; "right" &#124; "left" | 否 | 未声明 |
+| fixed | 固定位置 | undefined &#124; "right" &#124; "left" | 否 | 未声明 |
+| ellipsis | 是否显示省略 | undefined &#124; false &#124; true | 否 | false |
+| sortable | 排序配置 | undefined &#124; TableSortable | 否 | undefined |
+| filterable | 筛选配置 | undefined &#124; TableFilterable | 否 | undefined |
+| cellClass | 单元格 class | undefined &#124; string &#124; { [x: string]: boolean; } &#124; (string &#124; Record<string, boolean>)[] | 否 | 未声明 |
+| headerCellClass | 表头单元格 class | undefined &#124; string &#124; { [x: string]: boolean; } &#124; (string &#124; Record<string, boolean>)[] | 否 | 未声明 |
+| bodyCellClass | 内容单元格 class | undefined &#124; string &#124; { [x: string]: boolean; } &#124; (string &#124; Record<string, boolean>)[] &#124; (record: TableData) => ClassName | 否 | 未声明 |
+| summaryCellClass | 总结单元格 class | undefined &#124; string &#124; { [x: string]: boolean; } &#124; (string &#124; Record<string, boolean>)[] &#124; (record: TableData) => ClassName | 否 | 未声明 |
+| cellStyle | 单元格样式 | undefined &#124; CSSProperties | 否 | 未声明 |
+| headerCellStyle | 表头单元格样式 | undefined &#124; CSSProperties | 否 | 未声明 |
+| bodyCellStyle | 内容单元格样式 | undefined &#124; CSSProperties &#124; (record: TableData) => CSSProperties | 否 | 未声明 |
+| summaryCellStyle | 总结单元格样式 | undefined &#124; CSSProperties &#124; (record: TableData) => CSSProperties | 否 | 未声明 |
+| index | 手动指定列序号，通常无需使用 | undefined &#124; number | 否 | 未声明 |
+| tooltip | 省略时是否显示提示，或 Tooltip 配置 | undefined &#124; false &#124; true &#124; { [x: string]: any; } | 否 | false |
+
+### Events
+
+未声明组件 emits；原生事件与包装透传按本页用法核实。
+
+### Slots
+
+| 名称 | 用途 | 公开类型 |
+| --- | --- | --- |
+| cell | 单元格内容 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| title | 表头内容 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| filter-content | 自定义筛选弹层内容 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| filter-icon | 自定义筛选图标 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+
+### 实例方法
+
+没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+
+### 关联类型定义
+
+以下摘自本组件族声明，供查阅嵌套配置；运行时和值类型均以根入口可导出项为准。
+
+```typescript-reference
+declare const TABLE_PAGE_POSITION: readonly ["tl", "top", "tr", "bl", "bottom", "br"];
+
+type TablePagePosition = (typeof TABLE_PAGE_POSITION)[number];
+
+interface TableData {
+    /**
+     * @zh 数据行的key
+     * @en The key of the data row
+     */
+    key?: string | number;
+    /**
+     * @zh 扩展行内容
+     * @en Expand row content
+     */
+    expand?: string | RenderFunction;
+    /**
+     * @zh 子数据
+     * @en Sub data
+     */
+    children?: TableData[];
+    /**
+     * @zh 是否禁用行选择器
+     * @en Whether to disable the row selector
+     */
+    disabled?: boolean;
+    /**
+     * @zh 是否是叶子节点
+     * @en Whether it is a leaf node
+     * @version 2.13.0
+     */
+    isLeaf?: boolean;
+    [name: string]: any;
+}
+
+interface TableDataWithRaw {
+    raw: TableData;
+    key: string | number;
+    disabled?: boolean;
+    expand?: string | RenderFunction;
+    children?: TableDataWithRaw[];
+    isLeaf?: boolean;
+    hasSubtree?: boolean;
+}
+
+interface TableSortable {
+    /**
+     * @zh 支持的排序方向
+     * @en Supported sort direction
+     */
+    sortDirections: ('ascend' | 'descend')[];
+    /**
+     * @zh 排序函数。设置为 `true` 可关闭内部排序。2.19.0 版本修改传出数据。
+     * @en Sorting function. Set to `true` to turn off internal sorting. Version 2.19.0 modifies outgoing data.
+     */
+    sorter?: ((a: TableData, b: TableData, extra: {
+        dataIndex: string;
+        direction: 'ascend' | 'descend';
+    }) => number) | boolean;
+    /**
+     * @zh 排序方向
+     * @en Sort direction
+     */
+    sortOrder?: 'ascend' | 'descend' | '';
+    /**
+     * @zh 默认排序方向（非受控模式）
+     * @en Default sort direction (uncontrolled mode)
+     */
+    defaultSortOrder?: 'ascend' | 'descend' | '';
+    /**
+     * @zh 多列排序优先级，数字越大越先比较；只在声明优先级的列之间保留多列排序。
+     * @en Multi-column sort priority. Higher values are compared first.
+     */
+    sortPriority?: number;
+}
+
+interface TableFilterData {
+    /**
+     * @zh 筛选数据选项的内容
+     * @en Filter the content of the data option
+     */
+    text: string | RenderFunction;
+    /**
+     * @zh 筛选数据选项的值
+     * @en Filter the value of the data option
+     */
+    value: string;
+}
+
+interface TableFilterable {
+    /**
+     * @zh 筛选数据
+     * @en Filter data
+     */
+    filters?: TableFilterData[];
+    /**
+     * @zh 筛选函数
+     * @en Filter function
+     */
+    filter: (filteredValue: string[], record: TableData) => boolean;
+    /**
+     * @zh 是否支持多选
+     * @en Whether to support multiple selection
+     */
+    multiple?: boolean;
+    /**
+     * @zh 筛选项
+     * @en Filter value
+     */
+    filteredValue?: string[];
+    /**
+     * @zh 默认筛选项
+     * @en Default filter value
+     */
+    defaultFilteredValue?: string[];
+    /**
+     * @zh 筛选框的内容
+     * @en The content of filter box
+     */
+    renderContent?: (data: {
+        filterValue: string[];
+        setFilterValue: (filterValue: string[]) => void;
+        handleFilterConfirm: (event: Event) => void;
+        handleFilterReset: (event: Event) => void;
+    }) => VNodeChild;
+    /**
+     * @zh 筛选按钮的图标
+     * @en Filter icon for button
+     */
+    icon?: RenderFunction;
+    /**
+     * @zh 筛选框的弹出框配置
+     * @en Pop-up box configuration of filter box
+     */
+    triggerProps?: TriggerProps;
+    /**
+     * @zh 筛选图标是否左对齐
+     * @en Whether the filter icon is aligned to the left
+     * @version 2.13.0
+     */
+    alignLeft?: boolean;
+    slotName?: string;
+}
+
+interface TableColumnData {
+    /**
+     * @zh 列信息的标识，对应 `TableData` 中的数据
+     * @en The identifier of the column information, corresponding to the data in `TableData`
+     */
+    dataIndex?: string;
+    /**
+     * @zh 列标题
+     * @en Column header
+     */
+    title?: string | RenderFunction;
+    /**
+     * @zh 列宽度
+     * @en Column width
+     */
+    width?: number;
+    /**
+     * @zh 最小列宽
+     * @en Minimum column width
+     */
+    minWidth?: number;
+    /**
+     * @zh 对齐方向
+     * @en Alignment direction
+     */
+    align?: 'left' | 'center' | 'right';
+    /**
+     * @zh 固定位置
+     * @en Fixed position
+     */
+    fixed?: 'left' | 'right';
+    /**
+     * @zh 是否显示省略号
+     * @en Whether to show ellipsis
+     */
+    ellipsis?: boolean;
+    /**
+     * @zh 是否在显示省略号时显示文本提示。可填入 tooltip 组件属性
+     * @en Whether to show a text hint when an ellipsis is displayed. Can be filled in tooltip component properties
+     * @version 2.26.0
+     */
+    tooltip?: boolean | Record<string, any>;
+    /**
+     * @zh 排序相关选项
+     * @en Sorting related options
+     */
+    sortable?: TableSortable;
+    /**
+     * @zh 过滤相关选项
+     * @en Filter related options
+     */
+    filterable?: TableFilterable;
+    /**
+     * @zh 表头子数据，用于表头分组
+     * @en Header sub-data, used for header grouping
+     */
+    children?: TableColumnData[];
+    /**
+     * @zh 自定义单元格类名
+     * @en Custom cell class
+     * @version 2.36.0
+     */
+    cellClass?: ClassName;
+    /**
+     * @zh 自定义表头单元格类名
+     * @en Custom header cell class
+     * @version 2.36.0
+     */
+    headerCellClass?: ClassName;
+    /**
+     * @zh 自定义内容单元格类名
+     * @en Custom body cell class
+     * @version 2.36.0
+     */
+    bodyCellClass?: ClassName | ((record: TableData) => ClassName);
+    /**
+     * @zh 自定义总结栏单元格类名
+     * @en Custom body cell class
+     * @version 2.36.0
+     */
+    summaryCellClass?: ClassName | ((record: TableData) => ClassName);
+    /**
+     * @zh 自定义单元格样式
+     * @en Custom cell style
+     * @version 2.11.0
+     */
+    cellStyle?: CSSProperties;
+    /**
+     * @zh 自定义表头单元格样式
+     * @en Custom header cell style
+     * @version 2.29.0
+     */
+    headerCellStyle?: CSSProperties;
+    /**
+     * @zh 自定义内容单元格样式
+     * @en Custom body cell style
+     * @version 2.29.0
+     */
+    bodyCellStyle?: CSSProperties | ((record: TableData) => CSSProperties);
+    /**
+     * @zh 自定义总结栏单元格样式
+     * @en Custom summary cell style
+     * @version 2.30.0
+     */
+    summaryCellStyle?: CSSProperties | ((record: TableData) => CSSProperties);
+    /**
+     * @zh 自定义列单元格的渲染
+     * @en Customize the rendering of column cells
+     */
+    render?: (data: {
+        record: TableData;
+        column: TableColumnData;
+        rowIndex: number;
+    }) => VNodeChild;
+    /**
+     * @zh 设置当前列的渲染插槽的名字。插槽参数同 #cell
+     * @en Sets the name of the render slot for the current column. Slot parameters are the same as #cell
+     * @version 2.18.0
+     */
+    slotName?: string;
+    /**
+     * @zh 设置当前列的标题的渲染插槽的名字
+     * @en Set the name of the render slot for the header of the current column
+     * @version 2.23.0
+     */
+    titleSlotName?: string;
+    slots?: Slots;
+    isLastLeftFixed?: boolean;
+    isFirstRightFixed?: boolean;
+    colSpan?: number;
+    rowSpan?: number;
+    index?: number;
+    parent?: TableColumnData;
+    _resizeWidth?: number;
+}
+
+interface TableBorder {
+    /**
+     * @zh 是否展示外边框
+     * @en TWhether to display the outer border
+     */
+    wrapper?: boolean;
+    /**
+     * @zh 是否展示单元格边框（表头+主体）
+     * @en Whether to display the cell border (header + body)
+     */
+    cell?: boolean;
+    /**
+     * @zh 是否展示表头单元格边框
+     * @en Whether to display the header cell border
+     */
+    headerCell?: boolean;
+    /**
+     * @zh 是否展示主体单元格边框
+     * @en Whether to display the body cell border
+     */
+    bodyCell?: boolean;
+}
+
+interface TableRowSelection {
+    /**
+     * @zh 行选择器的类型
+     * @en The type of row selector
+     */
+    type?: 'checkbox' | 'radio';
+    /**
+     * @zh 已选择的行（受控模式）
+     * @en Selected row (controlled mode)
+     */
+    selectedRowKeys?: BaseType[];
+    /**
+     * @zh 默认已选择的行（非受控模式）
+     * @en The selected row by default (uncontrolled mode)
+     */
+    defaultSelectedRowKeys?: BaseType[];
+    /**
+     * @zh 是否显示全选选择器
+     * @en Whether to show the select all selector
+     */
+    showCheckedAll?: boolean;
+    /**
+     * @zh 列标题
+     * @en Column title
+     */
+    title?: string;
+    /**
+     * @zh 列宽度
+     * @en Column width
+     */
+    width?: number;
+    /**
+     * @zh 是否固定
+     * @en Is it fixed
+     */
+    fixed?: boolean;
+    /**
+     * @zh 是否开启严格选择模式
+     * @en Whether to enable strict selection mode
+     * @defaultValue true
+     * @version 2.29.0
+     */
+    checkStrictly?: boolean;
+    /**
+     * @zh 是否仅展示当前页的 keys（切换分页时清空 keys）
+     * @en Whether to display only the keys of the current page (clear keys when switching paging)
+     * @version 2.32.0
+     */
+    onlyCurrent?: boolean;
+}
+
+interface TableExpandable {
+    /**
+     * @zh 显示的展开行（受控模式）
+     * @en Displayed Expanded Row (Controlled Mode)
+     */
+    expandedRowKeys?: BaseType[];
+    /**
+     * @zh 默认显示的展开行（非受控模式）
+     * @en Expand row displayed by default (Uncontrolled mode)
+     */
+    defaultExpandedRowKeys?: BaseType[];
+    /**
+     * @zh 是否默认展开所有的行
+     * @en Whether to expand all rows by default
+     */
+    defaultExpandAllRows?: boolean;
+    /**
+     * @zh 自定义展开行内容
+     * @en Customize expanded row content
+     */
+    expandedRowRender?: (record: TableData) => VNodeChild;
+    /**
+     * @zh 展开图标
+     * @en Expand icon
+     */
+    icon?: (expanded: boolean, record: TableData) => VNodeChild;
+    /**
+     * @zh 列标题
+     * @en Column title
+     */
+    title?: string;
+    /**
+     * @zh 列宽度
+     * @en Column width
+     */
+    width?: number;
+    /**
+     * @zh 是否固定
+     * @en Is it fixed
+     */
+    fixed?: boolean;
+}
+
+interface TableDraggable {
+    /**
+     * @zh 拖拽类型
+     * @en drag type
+     */
+    type?: 'row' | 'handle';
+    /**
+     * @zh 列标题
+     * @en Column title
+     */
+    title?: string;
+    /**
+     * @zh 列宽度
+     * @en Column width
+     */
+    width?: number;
+    /**
+     * @zh 是否固定
+     * @en Is it fixed
+     */
+    fixed?: boolean;
+}
+
+type OperationName = 'selection-checkbox' | 'selection-radio' | 'expand' | 'drag-handle';
+
+interface TableOperationColumn {
+    name: OperationName | string;
+    title?: string | RenderFunction;
+    width?: number;
+    fixed?: boolean;
+    render?: (record: TableData) => VNodeChild;
+    isLastLeftFixed?: boolean;
+}
+
+interface TableComponents {
+    operations: (operations: {
+        dragHandle?: TableOperationColumn;
+        expand?: TableOperationColumn;
+        selection?: TableOperationColumn;
+    }) => TableOperationColumn[];
+}
+
+interface TableChangeExtra {
+    /**
+     * @zh 触发类型
+     * @en Trigger type
+     */
+    type: 'pagination' | 'sorter' | 'filter' | 'drag';
+    /**
+     * @zh 页码
+     * @en page number
+     */
+    page?: number;
+    /**
+     * @zh 每页数据数
+     * @en number per page
+     */
+    pageSize?: number;
+    /**
+     * @zh 排序信息
+     * @en Sort information
+     */
+    sorter?: Sorter;
+    /** 按优先级排列的全部排序条件；sorter 保留首个条件以兼容已有消费方。 */
+    sorters?: Sorter[];
+    /**
+     * @zh 筛选信息
+     * @en Filter information
+     */
+    filters?: Filters;
+    /**
+     * @zh 拖拽信息
+     * @en Drag and drop information
+     */
+    dragTarget?: TableData;
+}
+
+interface TableInternalProps {
+    columns: TableColumnData[];
+    data: TableData[];
+    bordered?: boolean | TableBorder;
+    rowSelection?: TableRowSelection;
+    expandable?: TableExpandable;
+    pagination?: boolean | Data;
+    pagePosition?: string;
+}
+
+type Sorter = {
+    field: string;
+    direction: 'ascend' | 'descend';
+};
+
+type Filters = Record<string, string[]>;
+
+declare const TD_TYPES: readonly ["normal", "operation", "checkbox", "radio", "expand"];
+
+type TdTypes = (typeof TD_TYPES)[number];
+
+type TableInstance = InstanceType<typeof _Table>;
+
+type TableProps = InstanceType<typeof _Table>['$props'];
+
+type TheadInstance = InstanceType<typeof _Thead>;
+
+type TbodyInstance = InstanceType<typeof _Tbody>;
+
+type TrInstance = InstanceType<typeof _Tr>;
+
+type ThInstance = InstanceType<typeof _Th>;
+
+type TdInstance = InstanceType<typeof _Td>;
+
+type TableColumnInstance = InstanceType<typeof _TableColumn>;
+```
+
+
+## Tbody API
+
+公开声明：`dist/components/table/table-tbody.d.ts`。 类型中的 undefined 表示可省略；原始 prop 默认值不等于继承配置或服务默认值。
+
+### Props
+
+未声明自身 props；包装透传能力见本页用法。
+
+### Events
+
+未声明组件 emits；原生事件与包装透传按本页用法核实。
+
+### Slots
+
+公开类型未逐项声明插槽；本页场景说明列出实际使用的插槽，不将任意插槽视为已支持。
+
+### 实例方法
+
+没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+
+
+## Td API
+
+公开声明：`dist/components/table/table-td.d.ts`。 类型中的 undefined 表示可省略；原始 prop 默认值不等于继承配置或服务默认值。
+
+### Props
+
+| 名称 | 用途 | 公开类型 | 必填 | 声明默认值 |
+| --- | --- | --- | --- | --- |
+| tabindex | 见场景用法与类型 | undefined &#124; string &#124; number | 否 | 未声明 |
+| onClick | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void | 否 | 未声明 |
+| onDblclick | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void | 否 | 未声明 |
+| onContextmenu | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void | 否 | 未声明 |
+| onMouseenter | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void | 否 | 未声明 |
+| onMouseleave | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void | 否 | 未声明 |
+| onDragstart | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void | 否 | 未声明 |
+| onDragend | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void | 否 | 未声明 |
+| onDragenter | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void | 否 | 未声明 |
+| onDragover | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void | 否 | 未声明 |
+| onDrop | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void | 否 | 未声明 |
+| onKeydown | 见场景用法与类型 | undefined &#124; (event: KeyboardEvent) => void | 否 | 未声明 |
+| onFocus | 见场景用法与类型 | undefined &#124; (event: FocusEvent) => void | 否 | 未声明 |
+| onPointerdown | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void | 否 | 未声明 |
+| onPointermove | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void | 否 | 未声明 |
+| onPointerup | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void | 否 | 未声明 |
+| onPointercancel | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void | 否 | 未声明 |
+| rowIndex | 见场景用法与类型 | undefined &#124; number | 否 | 未声明 |
+| record | 见场景用法与类型 | undefined &#124; TableDataWithRaw | 否 | {} |
+| column | 见场景用法与类型 | undefined &#124; TableColumnData | 否 | {} |
+| type | 见场景用法与类型 | undefined &#124; "normal" &#124; "radio" &#124; "expand" &#124; "checkbox" &#124; "operation" | 否 | "normal" |
+| operations | 见场景用法与类型 | undefined &#124; TableOperationColumn[] | 否 | [] |
+| dataColumns | 见场景用法与类型 | undefined &#124; TableColumnData[] | 否 | [] |
+| colSpan | 见场景用法与类型 | undefined &#124; number | 否 | 1 |
+| rowSpan | 见场景用法与类型 | undefined &#124; number | 否 | 1 |
+| isFixedExpand | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | false |
+| containerWidth | 见场景用法与类型 | undefined &#124; number | 否 | 未声明 |
+| showExpandBtn | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | false |
+| indentSize | 见场景用法与类型 | undefined &#124; number | 否 | 0 |
+| renderExpandBtn | 见场景用法与类型 | undefined &#124; (record: TableDataWithRaw, stopPropagation?: boolean, loading?: boolean) => VNode | 否 | 未声明 |
+| summary | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | false |
+
+### Events
+
+| 事件 | 用途 | 监听器签名（即事件参数） |
+| --- | --- | --- |
+| click | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void |
+| focus | 见场景用法与类型 | undefined &#124; (event: FocusEvent) => void |
+| keydown | 见场景用法与类型 | undefined &#124; (event: KeyboardEvent) => void |
+| dblclick | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void |
+| contextmenu | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void |
+| mouseenter | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void |
+| mouseleave | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void |
+| dragstart | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void |
+| dragend | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void |
+| dragenter | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void |
+| dragover | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void |
+| drop | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void |
+| pointerdown | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void |
+| pointermove | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void |
+| pointerup | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void |
+| pointercancel | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void |
+
+### Slots
+
+公开类型未逐项声明插槽；本页场景说明列出实际使用的插槽，不将任意插槽视为已支持。
+
+### 实例方法
+
+没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+
+### 关联类型定义
+
+以下摘自本组件族声明，供查阅嵌套配置；运行时和值类型均以根入口可导出项为准。
+
+```typescript-reference
+declare const TABLE_PAGE_POSITION: readonly ["tl", "top", "tr", "bl", "bottom", "br"];
+
+type TablePagePosition = (typeof TABLE_PAGE_POSITION)[number];
+
+interface TableData {
+    /**
+     * @zh 数据行的key
+     * @en The key of the data row
+     */
+    key?: string | number;
+    /**
+     * @zh 扩展行内容
+     * @en Expand row content
+     */
+    expand?: string | RenderFunction;
+    /**
+     * @zh 子数据
+     * @en Sub data
+     */
+    children?: TableData[];
+    /**
+     * @zh 是否禁用行选择器
+     * @en Whether to disable the row selector
+     */
+    disabled?: boolean;
+    /**
+     * @zh 是否是叶子节点
+     * @en Whether it is a leaf node
+     * @version 2.13.0
+     */
+    isLeaf?: boolean;
+    [name: string]: any;
+}
+
+interface TableDataWithRaw {
+    raw: TableData;
+    key: string | number;
+    disabled?: boolean;
+    expand?: string | RenderFunction;
+    children?: TableDataWithRaw[];
+    isLeaf?: boolean;
+    hasSubtree?: boolean;
+}
+
+interface TableSortable {
+    /**
+     * @zh 支持的排序方向
+     * @en Supported sort direction
+     */
+    sortDirections: ('ascend' | 'descend')[];
+    /**
+     * @zh 排序函数。设置为 `true` 可关闭内部排序。2.19.0 版本修改传出数据。
+     * @en Sorting function. Set to `true` to turn off internal sorting. Version 2.19.0 modifies outgoing data.
+     */
+    sorter?: ((a: TableData, b: TableData, extra: {
+        dataIndex: string;
+        direction: 'ascend' | 'descend';
+    }) => number) | boolean;
+    /**
+     * @zh 排序方向
+     * @en Sort direction
+     */
+    sortOrder?: 'ascend' | 'descend' | '';
+    /**
+     * @zh 默认排序方向（非受控模式）
+     * @en Default sort direction (uncontrolled mode)
+     */
+    defaultSortOrder?: 'ascend' | 'descend' | '';
+    /**
+     * @zh 多列排序优先级，数字越大越先比较；只在声明优先级的列之间保留多列排序。
+     * @en Multi-column sort priority. Higher values are compared first.
+     */
+    sortPriority?: number;
+}
+
+interface TableFilterData {
+    /**
+     * @zh 筛选数据选项的内容
+     * @en Filter the content of the data option
+     */
+    text: string | RenderFunction;
+    /**
+     * @zh 筛选数据选项的值
+     * @en Filter the value of the data option
+     */
+    value: string;
+}
+
+interface TableFilterable {
+    /**
+     * @zh 筛选数据
+     * @en Filter data
+     */
+    filters?: TableFilterData[];
+    /**
+     * @zh 筛选函数
+     * @en Filter function
+     */
+    filter: (filteredValue: string[], record: TableData) => boolean;
+    /**
+     * @zh 是否支持多选
+     * @en Whether to support multiple selection
+     */
+    multiple?: boolean;
+    /**
+     * @zh 筛选项
+     * @en Filter value
+     */
+    filteredValue?: string[];
+    /**
+     * @zh 默认筛选项
+     * @en Default filter value
+     */
+    defaultFilteredValue?: string[];
+    /**
+     * @zh 筛选框的内容
+     * @en The content of filter box
+     */
+    renderContent?: (data: {
+        filterValue: string[];
+        setFilterValue: (filterValue: string[]) => void;
+        handleFilterConfirm: (event: Event) => void;
+        handleFilterReset: (event: Event) => void;
+    }) => VNodeChild;
+    /**
+     * @zh 筛选按钮的图标
+     * @en Filter icon for button
+     */
+    icon?: RenderFunction;
+    /**
+     * @zh 筛选框的弹出框配置
+     * @en Pop-up box configuration of filter box
+     */
+    triggerProps?: TriggerProps;
+    /**
+     * @zh 筛选图标是否左对齐
+     * @en Whether the filter icon is aligned to the left
+     * @version 2.13.0
+     */
+    alignLeft?: boolean;
+    slotName?: string;
+}
+
+interface TableColumnData {
+    /**
+     * @zh 列信息的标识，对应 `TableData` 中的数据
+     * @en The identifier of the column information, corresponding to the data in `TableData`
+     */
+    dataIndex?: string;
+    /**
+     * @zh 列标题
+     * @en Column header
+     */
+    title?: string | RenderFunction;
+    /**
+     * @zh 列宽度
+     * @en Column width
+     */
+    width?: number;
+    /**
+     * @zh 最小列宽
+     * @en Minimum column width
+     */
+    minWidth?: number;
+    /**
+     * @zh 对齐方向
+     * @en Alignment direction
+     */
+    align?: 'left' | 'center' | 'right';
+    /**
+     * @zh 固定位置
+     * @en Fixed position
+     */
+    fixed?: 'left' | 'right';
+    /**
+     * @zh 是否显示省略号
+     * @en Whether to show ellipsis
+     */
+    ellipsis?: boolean;
+    /**
+     * @zh 是否在显示省略号时显示文本提示。可填入 tooltip 组件属性
+     * @en Whether to show a text hint when an ellipsis is displayed. Can be filled in tooltip component properties
+     * @version 2.26.0
+     */
+    tooltip?: boolean | Record<string, any>;
+    /**
+     * @zh 排序相关选项
+     * @en Sorting related options
+     */
+    sortable?: TableSortable;
+    /**
+     * @zh 过滤相关选项
+     * @en Filter related options
+     */
+    filterable?: TableFilterable;
+    /**
+     * @zh 表头子数据，用于表头分组
+     * @en Header sub-data, used for header grouping
+     */
+    children?: TableColumnData[];
+    /**
+     * @zh 自定义单元格类名
+     * @en Custom cell class
+     * @version 2.36.0
+     */
+    cellClass?: ClassName;
+    /**
+     * @zh 自定义表头单元格类名
+     * @en Custom header cell class
+     * @version 2.36.0
+     */
+    headerCellClass?: ClassName;
+    /**
+     * @zh 自定义内容单元格类名
+     * @en Custom body cell class
+     * @version 2.36.0
+     */
+    bodyCellClass?: ClassName | ((record: TableData) => ClassName);
+    /**
+     * @zh 自定义总结栏单元格类名
+     * @en Custom body cell class
+     * @version 2.36.0
+     */
+    summaryCellClass?: ClassName | ((record: TableData) => ClassName);
+    /**
+     * @zh 自定义单元格样式
+     * @en Custom cell style
+     * @version 2.11.0
+     */
+    cellStyle?: CSSProperties;
+    /**
+     * @zh 自定义表头单元格样式
+     * @en Custom header cell style
+     * @version 2.29.0
+     */
+    headerCellStyle?: CSSProperties;
+    /**
+     * @zh 自定义内容单元格样式
+     * @en Custom body cell style
+     * @version 2.29.0
+     */
+    bodyCellStyle?: CSSProperties | ((record: TableData) => CSSProperties);
+    /**
+     * @zh 自定义总结栏单元格样式
+     * @en Custom summary cell style
+     * @version 2.30.0
+     */
+    summaryCellStyle?: CSSProperties | ((record: TableData) => CSSProperties);
+    /**
+     * @zh 自定义列单元格的渲染
+     * @en Customize the rendering of column cells
+     */
+    render?: (data: {
+        record: TableData;
+        column: TableColumnData;
+        rowIndex: number;
+    }) => VNodeChild;
+    /**
+     * @zh 设置当前列的渲染插槽的名字。插槽参数同 #cell
+     * @en Sets the name of the render slot for the current column. Slot parameters are the same as #cell
+     * @version 2.18.0
+     */
+    slotName?: string;
+    /**
+     * @zh 设置当前列的标题的渲染插槽的名字
+     * @en Set the name of the render slot for the header of the current column
+     * @version 2.23.0
+     */
+    titleSlotName?: string;
+    slots?: Slots;
+    isLastLeftFixed?: boolean;
+    isFirstRightFixed?: boolean;
+    colSpan?: number;
+    rowSpan?: number;
+    index?: number;
+    parent?: TableColumnData;
+    _resizeWidth?: number;
+}
+
+interface TableBorder {
+    /**
+     * @zh 是否展示外边框
+     * @en TWhether to display the outer border
+     */
+    wrapper?: boolean;
+    /**
+     * @zh 是否展示单元格边框（表头+主体）
+     * @en Whether to display the cell border (header + body)
+     */
+    cell?: boolean;
+    /**
+     * @zh 是否展示表头单元格边框
+     * @en Whether to display the header cell border
+     */
+    headerCell?: boolean;
+    /**
+     * @zh 是否展示主体单元格边框
+     * @en Whether to display the body cell border
+     */
+    bodyCell?: boolean;
+}
+
+interface TableRowSelection {
+    /**
+     * @zh 行选择器的类型
+     * @en The type of row selector
+     */
+    type?: 'checkbox' | 'radio';
+    /**
+     * @zh 已选择的行（受控模式）
+     * @en Selected row (controlled mode)
+     */
+    selectedRowKeys?: BaseType[];
+    /**
+     * @zh 默认已选择的行（非受控模式）
+     * @en The selected row by default (uncontrolled mode)
+     */
+    defaultSelectedRowKeys?: BaseType[];
+    /**
+     * @zh 是否显示全选选择器
+     * @en Whether to show the select all selector
+     */
+    showCheckedAll?: boolean;
+    /**
+     * @zh 列标题
+     * @en Column title
+     */
+    title?: string;
+    /**
+     * @zh 列宽度
+     * @en Column width
+     */
+    width?: number;
+    /**
+     * @zh 是否固定
+     * @en Is it fixed
+     */
+    fixed?: boolean;
+    /**
+     * @zh 是否开启严格选择模式
+     * @en Whether to enable strict selection mode
+     * @defaultValue true
+     * @version 2.29.0
+     */
+    checkStrictly?: boolean;
+    /**
+     * @zh 是否仅展示当前页的 keys（切换分页时清空 keys）
+     * @en Whether to display only the keys of the current page (clear keys when switching paging)
+     * @version 2.32.0
+     */
+    onlyCurrent?: boolean;
+}
+
+interface TableExpandable {
+    /**
+     * @zh 显示的展开行（受控模式）
+     * @en Displayed Expanded Row (Controlled Mode)
+     */
+    expandedRowKeys?: BaseType[];
+    /**
+     * @zh 默认显示的展开行（非受控模式）
+     * @en Expand row displayed by default (Uncontrolled mode)
+     */
+    defaultExpandedRowKeys?: BaseType[];
+    /**
+     * @zh 是否默认展开所有的行
+     * @en Whether to expand all rows by default
+     */
+    defaultExpandAllRows?: boolean;
+    /**
+     * @zh 自定义展开行内容
+     * @en Customize expanded row content
+     */
+    expandedRowRender?: (record: TableData) => VNodeChild;
+    /**
+     * @zh 展开图标
+     * @en Expand icon
+     */
+    icon?: (expanded: boolean, record: TableData) => VNodeChild;
+    /**
+     * @zh 列标题
+     * @en Column title
+     */
+    title?: string;
+    /**
+     * @zh 列宽度
+     * @en Column width
+     */
+    width?: number;
+    /**
+     * @zh 是否固定
+     * @en Is it fixed
+     */
+    fixed?: boolean;
+}
+
+interface TableDraggable {
+    /**
+     * @zh 拖拽类型
+     * @en drag type
+     */
+    type?: 'row' | 'handle';
+    /**
+     * @zh 列标题
+     * @en Column title
+     */
+    title?: string;
+    /**
+     * @zh 列宽度
+     * @en Column width
+     */
+    width?: number;
+    /**
+     * @zh 是否固定
+     * @en Is it fixed
+     */
+    fixed?: boolean;
+}
+
+type OperationName = 'selection-checkbox' | 'selection-radio' | 'expand' | 'drag-handle';
+
+interface TableOperationColumn {
+    name: OperationName | string;
+    title?: string | RenderFunction;
+    width?: number;
+    fixed?: boolean;
+    render?: (record: TableData) => VNodeChild;
+    isLastLeftFixed?: boolean;
+}
+
+interface TableComponents {
+    operations: (operations: {
+        dragHandle?: TableOperationColumn;
+        expand?: TableOperationColumn;
+        selection?: TableOperationColumn;
+    }) => TableOperationColumn[];
+}
+
+interface TableChangeExtra {
+    /**
+     * @zh 触发类型
+     * @en Trigger type
+     */
+    type: 'pagination' | 'sorter' | 'filter' | 'drag';
+    /**
+     * @zh 页码
+     * @en page number
+     */
+    page?: number;
+    /**
+     * @zh 每页数据数
+     * @en number per page
+     */
+    pageSize?: number;
+    /**
+     * @zh 排序信息
+     * @en Sort information
+     */
+    sorter?: Sorter;
+    /** 按优先级排列的全部排序条件；sorter 保留首个条件以兼容已有消费方。 */
+    sorters?: Sorter[];
+    /**
+     * @zh 筛选信息
+     * @en Filter information
+     */
+    filters?: Filters;
+    /**
+     * @zh 拖拽信息
+     * @en Drag and drop information
+     */
+    dragTarget?: TableData;
+}
+
+interface TableInternalProps {
+    columns: TableColumnData[];
+    data: TableData[];
+    bordered?: boolean | TableBorder;
+    rowSelection?: TableRowSelection;
+    expandable?: TableExpandable;
+    pagination?: boolean | Data;
+    pagePosition?: string;
+}
+
+type Sorter = {
+    field: string;
+    direction: 'ascend' | 'descend';
+};
+
+type Filters = Record<string, string[]>;
+
+declare const TD_TYPES: readonly ["normal", "operation", "checkbox", "radio", "expand"];
+
+type TdTypes = (typeof TD_TYPES)[number];
+```
+
+
+## Th API
+
+公开声明：`dist/components/table/table-th.d.ts`。 类型中的 undefined 表示可省略；原始 prop 默认值不等于继承配置或服务默认值。
+
+### Props
+
+| 名称 | 用途 | 公开类型 | 必填 | 声明默认值 |
+| --- | --- | --- | --- | --- |
+| tabindex | 见场景用法与类型 | undefined &#124; string &#124; number | 否 | 未声明 |
+| onClick | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void | 否 | 未声明 |
+| onDblclick | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void | 否 | 未声明 |
+| onContextmenu | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void | 否 | 未声明 |
+| onMouseenter | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void | 否 | 未声明 |
+| onMouseleave | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void | 否 | 未声明 |
+| onDragstart | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void | 否 | 未声明 |
+| onDragend | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void | 否 | 未声明 |
+| onDragenter | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void | 否 | 未声明 |
+| onDragover | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void | 否 | 未声明 |
+| onDrop | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void | 否 | 未声明 |
+| onKeydown | 见场景用法与类型 | undefined &#124; (event: KeyboardEvent) => void | 否 | 未声明 |
+| onFocus | 见场景用法与类型 | undefined &#124; (event: FocusEvent) => void | 否 | 未声明 |
+| onPointerdown | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void | 否 | 未声明 |
+| onPointermove | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void | 否 | 未声明 |
+| onPointerup | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void | 否 | 未声明 |
+| onPointercancel | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void | 否 | 未声明 |
+| column | 见场景用法与类型 | undefined &#124; TableColumnData | 否 | {} |
+| operations | 见场景用法与类型 | undefined &#124; TableOperationColumn[] | 否 | [] |
+| dataColumns | 见场景用法与类型 | undefined &#124; TableColumnData[] | 否 | [] |
+| resizable | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | false（Vue Boolean 转换） |
+
+### Events
+
+| 事件 | 用途 | 监听器签名（即事件参数） |
+| --- | --- | --- |
+| click | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void |
+| focus | 见场景用法与类型 | undefined &#124; (event: FocusEvent) => void |
+| keydown | 见场景用法与类型 | undefined &#124; (event: KeyboardEvent) => void |
+| dblclick | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void |
+| contextmenu | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void |
+| mouseenter | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void |
+| mouseleave | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void |
+| dragstart | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void |
+| dragend | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void |
+| dragenter | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void |
+| dragover | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void |
+| drop | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void |
+| pointerdown | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void |
+| pointermove | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void |
+| pointerup | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void |
+| pointercancel | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void |
+
+### Slots
+
+公开类型未逐项声明插槽；本页场景说明列出实际使用的插槽，不将任意插槽视为已支持。
+
+### 实例方法
+
+没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+
+### 关联类型定义
+
+以下摘自本组件族声明，供查阅嵌套配置；运行时和值类型均以根入口可导出项为准。
+
+```typescript-reference
+declare const TABLE_PAGE_POSITION: readonly ["tl", "top", "tr", "bl", "bottom", "br"];
+
+type TablePagePosition = (typeof TABLE_PAGE_POSITION)[number];
+
+interface TableData {
+    /**
+     * @zh 数据行的key
+     * @en The key of the data row
+     */
+    key?: string | number;
+    /**
+     * @zh 扩展行内容
+     * @en Expand row content
+     */
+    expand?: string | RenderFunction;
+    /**
+     * @zh 子数据
+     * @en Sub data
+     */
+    children?: TableData[];
+    /**
+     * @zh 是否禁用行选择器
+     * @en Whether to disable the row selector
+     */
+    disabled?: boolean;
+    /**
+     * @zh 是否是叶子节点
+     * @en Whether it is a leaf node
+     * @version 2.13.0
+     */
+    isLeaf?: boolean;
+    [name: string]: any;
+}
+
+interface TableDataWithRaw {
+    raw: TableData;
+    key: string | number;
+    disabled?: boolean;
+    expand?: string | RenderFunction;
+    children?: TableDataWithRaw[];
+    isLeaf?: boolean;
+    hasSubtree?: boolean;
+}
+
+interface TableSortable {
+    /**
+     * @zh 支持的排序方向
+     * @en Supported sort direction
+     */
+    sortDirections: ('ascend' | 'descend')[];
+    /**
+     * @zh 排序函数。设置为 `true` 可关闭内部排序。2.19.0 版本修改传出数据。
+     * @en Sorting function. Set to `true` to turn off internal sorting. Version 2.19.0 modifies outgoing data.
+     */
+    sorter?: ((a: TableData, b: TableData, extra: {
+        dataIndex: string;
+        direction: 'ascend' | 'descend';
+    }) => number) | boolean;
+    /**
+     * @zh 排序方向
+     * @en Sort direction
+     */
+    sortOrder?: 'ascend' | 'descend' | '';
+    /**
+     * @zh 默认排序方向（非受控模式）
+     * @en Default sort direction (uncontrolled mode)
+     */
+    defaultSortOrder?: 'ascend' | 'descend' | '';
+    /**
+     * @zh 多列排序优先级，数字越大越先比较；只在声明优先级的列之间保留多列排序。
+     * @en Multi-column sort priority. Higher values are compared first.
+     */
+    sortPriority?: number;
+}
+
+interface TableFilterData {
+    /**
+     * @zh 筛选数据选项的内容
+     * @en Filter the content of the data option
+     */
+    text: string | RenderFunction;
+    /**
+     * @zh 筛选数据选项的值
+     * @en Filter the value of the data option
+     */
+    value: string;
+}
+
+interface TableFilterable {
+    /**
+     * @zh 筛选数据
+     * @en Filter data
+     */
+    filters?: TableFilterData[];
+    /**
+     * @zh 筛选函数
+     * @en Filter function
+     */
+    filter: (filteredValue: string[], record: TableData) => boolean;
+    /**
+     * @zh 是否支持多选
+     * @en Whether to support multiple selection
+     */
+    multiple?: boolean;
+    /**
+     * @zh 筛选项
+     * @en Filter value
+     */
+    filteredValue?: string[];
+    /**
+     * @zh 默认筛选项
+     * @en Default filter value
+     */
+    defaultFilteredValue?: string[];
+    /**
+     * @zh 筛选框的内容
+     * @en The content of filter box
+     */
+    renderContent?: (data: {
+        filterValue: string[];
+        setFilterValue: (filterValue: string[]) => void;
+        handleFilterConfirm: (event: Event) => void;
+        handleFilterReset: (event: Event) => void;
+    }) => VNodeChild;
+    /**
+     * @zh 筛选按钮的图标
+     * @en Filter icon for button
+     */
+    icon?: RenderFunction;
+    /**
+     * @zh 筛选框的弹出框配置
+     * @en Pop-up box configuration of filter box
+     */
+    triggerProps?: TriggerProps;
+    /**
+     * @zh 筛选图标是否左对齐
+     * @en Whether the filter icon is aligned to the left
+     * @version 2.13.0
+     */
+    alignLeft?: boolean;
+    slotName?: string;
+}
+
+interface TableColumnData {
+    /**
+     * @zh 列信息的标识，对应 `TableData` 中的数据
+     * @en The identifier of the column information, corresponding to the data in `TableData`
+     */
+    dataIndex?: string;
+    /**
+     * @zh 列标题
+     * @en Column header
+     */
+    title?: string | RenderFunction;
+    /**
+     * @zh 列宽度
+     * @en Column width
+     */
+    width?: number;
+    /**
+     * @zh 最小列宽
+     * @en Minimum column width
+     */
+    minWidth?: number;
+    /**
+     * @zh 对齐方向
+     * @en Alignment direction
+     */
+    align?: 'left' | 'center' | 'right';
+    /**
+     * @zh 固定位置
+     * @en Fixed position
+     */
+    fixed?: 'left' | 'right';
+    /**
+     * @zh 是否显示省略号
+     * @en Whether to show ellipsis
+     */
+    ellipsis?: boolean;
+    /**
+     * @zh 是否在显示省略号时显示文本提示。可填入 tooltip 组件属性
+     * @en Whether to show a text hint when an ellipsis is displayed. Can be filled in tooltip component properties
+     * @version 2.26.0
+     */
+    tooltip?: boolean | Record<string, any>;
+    /**
+     * @zh 排序相关选项
+     * @en Sorting related options
+     */
+    sortable?: TableSortable;
+    /**
+     * @zh 过滤相关选项
+     * @en Filter related options
+     */
+    filterable?: TableFilterable;
+    /**
+     * @zh 表头子数据，用于表头分组
+     * @en Header sub-data, used for header grouping
+     */
+    children?: TableColumnData[];
+    /**
+     * @zh 自定义单元格类名
+     * @en Custom cell class
+     * @version 2.36.0
+     */
+    cellClass?: ClassName;
+    /**
+     * @zh 自定义表头单元格类名
+     * @en Custom header cell class
+     * @version 2.36.0
+     */
+    headerCellClass?: ClassName;
+    /**
+     * @zh 自定义内容单元格类名
+     * @en Custom body cell class
+     * @version 2.36.0
+     */
+    bodyCellClass?: ClassName | ((record: TableData) => ClassName);
+    /**
+     * @zh 自定义总结栏单元格类名
+     * @en Custom body cell class
+     * @version 2.36.0
+     */
+    summaryCellClass?: ClassName | ((record: TableData) => ClassName);
+    /**
+     * @zh 自定义单元格样式
+     * @en Custom cell style
+     * @version 2.11.0
+     */
+    cellStyle?: CSSProperties;
+    /**
+     * @zh 自定义表头单元格样式
+     * @en Custom header cell style
+     * @version 2.29.0
+     */
+    headerCellStyle?: CSSProperties;
+    /**
+     * @zh 自定义内容单元格样式
+     * @en Custom body cell style
+     * @version 2.29.0
+     */
+    bodyCellStyle?: CSSProperties | ((record: TableData) => CSSProperties);
+    /**
+     * @zh 自定义总结栏单元格样式
+     * @en Custom summary cell style
+     * @version 2.30.0
+     */
+    summaryCellStyle?: CSSProperties | ((record: TableData) => CSSProperties);
+    /**
+     * @zh 自定义列单元格的渲染
+     * @en Customize the rendering of column cells
+     */
+    render?: (data: {
+        record: TableData;
+        column: TableColumnData;
+        rowIndex: number;
+    }) => VNodeChild;
+    /**
+     * @zh 设置当前列的渲染插槽的名字。插槽参数同 #cell
+     * @en Sets the name of the render slot for the current column. Slot parameters are the same as #cell
+     * @version 2.18.0
+     */
+    slotName?: string;
+    /**
+     * @zh 设置当前列的标题的渲染插槽的名字
+     * @en Set the name of the render slot for the header of the current column
+     * @version 2.23.0
+     */
+    titleSlotName?: string;
+    slots?: Slots;
+    isLastLeftFixed?: boolean;
+    isFirstRightFixed?: boolean;
+    colSpan?: number;
+    rowSpan?: number;
+    index?: number;
+    parent?: TableColumnData;
+    _resizeWidth?: number;
+}
+
+interface TableBorder {
+    /**
+     * @zh 是否展示外边框
+     * @en TWhether to display the outer border
+     */
+    wrapper?: boolean;
+    /**
+     * @zh 是否展示单元格边框（表头+主体）
+     * @en Whether to display the cell border (header + body)
+     */
+    cell?: boolean;
+    /**
+     * @zh 是否展示表头单元格边框
+     * @en Whether to display the header cell border
+     */
+    headerCell?: boolean;
+    /**
+     * @zh 是否展示主体单元格边框
+     * @en Whether to display the body cell border
+     */
+    bodyCell?: boolean;
+}
+
+interface TableRowSelection {
+    /**
+     * @zh 行选择器的类型
+     * @en The type of row selector
+     */
+    type?: 'checkbox' | 'radio';
+    /**
+     * @zh 已选择的行（受控模式）
+     * @en Selected row (controlled mode)
+     */
+    selectedRowKeys?: BaseType[];
+    /**
+     * @zh 默认已选择的行（非受控模式）
+     * @en The selected row by default (uncontrolled mode)
+     */
+    defaultSelectedRowKeys?: BaseType[];
+    /**
+     * @zh 是否显示全选选择器
+     * @en Whether to show the select all selector
+     */
+    showCheckedAll?: boolean;
+    /**
+     * @zh 列标题
+     * @en Column title
+     */
+    title?: string;
+    /**
+     * @zh 列宽度
+     * @en Column width
+     */
+    width?: number;
+    /**
+     * @zh 是否固定
+     * @en Is it fixed
+     */
+    fixed?: boolean;
+    /**
+     * @zh 是否开启严格选择模式
+     * @en Whether to enable strict selection mode
+     * @defaultValue true
+     * @version 2.29.0
+     */
+    checkStrictly?: boolean;
+    /**
+     * @zh 是否仅展示当前页的 keys（切换分页时清空 keys）
+     * @en Whether to display only the keys of the current page (clear keys when switching paging)
+     * @version 2.32.0
+     */
+    onlyCurrent?: boolean;
+}
+
+interface TableExpandable {
+    /**
+     * @zh 显示的展开行（受控模式）
+     * @en Displayed Expanded Row (Controlled Mode)
+     */
+    expandedRowKeys?: BaseType[];
+    /**
+     * @zh 默认显示的展开行（非受控模式）
+     * @en Expand row displayed by default (Uncontrolled mode)
+     */
+    defaultExpandedRowKeys?: BaseType[];
+    /**
+     * @zh 是否默认展开所有的行
+     * @en Whether to expand all rows by default
+     */
+    defaultExpandAllRows?: boolean;
+    /**
+     * @zh 自定义展开行内容
+     * @en Customize expanded row content
+     */
+    expandedRowRender?: (record: TableData) => VNodeChild;
+    /**
+     * @zh 展开图标
+     * @en Expand icon
+     */
+    icon?: (expanded: boolean, record: TableData) => VNodeChild;
+    /**
+     * @zh 列标题
+     * @en Column title
+     */
+    title?: string;
+    /**
+     * @zh 列宽度
+     * @en Column width
+     */
+    width?: number;
+    /**
+     * @zh 是否固定
+     * @en Is it fixed
+     */
+    fixed?: boolean;
+}
+
+interface TableDraggable {
+    /**
+     * @zh 拖拽类型
+     * @en drag type
+     */
+    type?: 'row' | 'handle';
+    /**
+     * @zh 列标题
+     * @en Column title
+     */
+    title?: string;
+    /**
+     * @zh 列宽度
+     * @en Column width
+     */
+    width?: number;
+    /**
+     * @zh 是否固定
+     * @en Is it fixed
+     */
+    fixed?: boolean;
+}
+
+type OperationName = 'selection-checkbox' | 'selection-radio' | 'expand' | 'drag-handle';
+
+interface TableOperationColumn {
+    name: OperationName | string;
+    title?: string | RenderFunction;
+    width?: number;
+    fixed?: boolean;
+    render?: (record: TableData) => VNodeChild;
+    isLastLeftFixed?: boolean;
+}
+
+interface TableComponents {
+    operations: (operations: {
+        dragHandle?: TableOperationColumn;
+        expand?: TableOperationColumn;
+        selection?: TableOperationColumn;
+    }) => TableOperationColumn[];
+}
+
+interface TableChangeExtra {
+    /**
+     * @zh 触发类型
+     * @en Trigger type
+     */
+    type: 'pagination' | 'sorter' | 'filter' | 'drag';
+    /**
+     * @zh 页码
+     * @en page number
+     */
+    page?: number;
+    /**
+     * @zh 每页数据数
+     * @en number per page
+     */
+    pageSize?: number;
+    /**
+     * @zh 排序信息
+     * @en Sort information
+     */
+    sorter?: Sorter;
+    /** 按优先级排列的全部排序条件；sorter 保留首个条件以兼容已有消费方。 */
+    sorters?: Sorter[];
+    /**
+     * @zh 筛选信息
+     * @en Filter information
+     */
+    filters?: Filters;
+    /**
+     * @zh 拖拽信息
+     * @en Drag and drop information
+     */
+    dragTarget?: TableData;
+}
+
+interface TableInternalProps {
+    columns: TableColumnData[];
+    data: TableData[];
+    bordered?: boolean | TableBorder;
+    rowSelection?: TableRowSelection;
+    expandable?: TableExpandable;
+    pagination?: boolean | Data;
+    pagePosition?: string;
+}
+
+type Sorter = {
+    field: string;
+    direction: 'ascend' | 'descend';
+};
+
+type Filters = Record<string, string[]>;
+```
+
+
+## Thead API
+
+公开声明：`dist/components/table/table-thead.d.ts`。 类型中的 undefined 表示可省略；原始 prop 默认值不等于继承配置或服务默认值。
+
+### Props
+
+未声明自身 props；包装透传能力见本页用法。
+
+### Events
+
+未声明组件 emits；原生事件与包装透传按本页用法核实。
+
+### Slots
+
+公开类型未逐项声明插槽；本页场景说明列出实际使用的插槽，不将任意插槽视为已支持。
+
+### 实例方法
+
+没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+
+
+## Tr API
+
+公开声明：`dist/components/table/table-tr.d.ts`。 类型中的 undefined 表示可省略；原始 prop 默认值不等于继承配置或服务默认值。
+
+### Props
+
+| 名称 | 用途 | 公开类型 | 必填 | 声明默认值 |
+| --- | --- | --- | --- | --- |
+| tabindex | 见场景用法与类型 | undefined &#124; string &#124; number | 否 | 未声明 |
+| onClick | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void | 否 | 未声明 |
+| onDblclick | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void | 否 | 未声明 |
+| onContextmenu | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void | 否 | 未声明 |
+| onMouseenter | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void | 否 | 未声明 |
+| onMouseleave | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void | 否 | 未声明 |
+| onDragstart | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void | 否 | 未声明 |
+| onDragend | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void | 否 | 未声明 |
+| onDragenter | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void | 否 | 未声明 |
+| onDragover | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void | 否 | 未声明 |
+| onDrop | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void | 否 | 未声明 |
+| onKeydown | 见场景用法与类型 | undefined &#124; (event: KeyboardEvent) => void | 否 | 未声明 |
+| onFocus | 见场景用法与类型 | undefined &#124; (event: FocusEvent) => void | 否 | 未声明 |
+| onPointerdown | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void | 否 | 未声明 |
+| onPointermove | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void | 否 | 未声明 |
+| onPointerup | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void | 否 | 未声明 |
+| onPointercancel | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void | 否 | 未声明 |
+| expand | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | false（Vue Boolean 转换） |
+| empty | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | false（Vue Boolean 转换） |
+| checked | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | false（Vue Boolean 转换） |
+| rowIndex | 见场景用法与类型 | undefined &#124; number | 否 | 未声明 |
+| record | 见场景用法与类型 | undefined &#124; TableDataWithRaw | 否 | {} |
+
+### Events
+
+| 事件 | 用途 | 监听器签名（即事件参数） |
+| --- | --- | --- |
+| click | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void |
+| focus | 见场景用法与类型 | undefined &#124; (event: FocusEvent) => void |
+| keydown | 见场景用法与类型 | undefined &#124; (event: KeyboardEvent) => void |
+| dblclick | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void |
+| contextmenu | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void |
+| mouseenter | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void |
+| mouseleave | 见场景用法与类型 | undefined &#124; (event: MouseEvent) => void |
+| dragstart | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void |
+| dragend | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void |
+| dragenter | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void |
+| dragover | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void |
+| drop | 见场景用法与类型 | undefined &#124; (event: DragEvent) => void |
+| pointerdown | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void |
+| pointermove | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void |
+| pointerup | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void |
+| pointercancel | 见场景用法与类型 | undefined &#124; (event: PointerEvent) => void |
+
+### Slots
+
+公开类型未逐项声明插槽；本页场景说明列出实际使用的插槽，不将任意插槽视为已支持。
+
+### 实例方法
+
+没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+
+### 关联类型定义
+
+以下摘自本组件族声明，供查阅嵌套配置；运行时和值类型均以根入口可导出项为准。
+
+```typescript-reference
+declare const TABLE_PAGE_POSITION: readonly ["tl", "top", "tr", "bl", "bottom", "br"];
+
+type TablePagePosition = (typeof TABLE_PAGE_POSITION)[number];
+
+interface TableData {
+    /**
+     * @zh 数据行的key
+     * @en The key of the data row
+     */
+    key?: string | number;
+    /**
+     * @zh 扩展行内容
+     * @en Expand row content
+     */
+    expand?: string | RenderFunction;
+    /**
+     * @zh 子数据
+     * @en Sub data
+     */
+    children?: TableData[];
+    /**
+     * @zh 是否禁用行选择器
+     * @en Whether to disable the row selector
+     */
+    disabled?: boolean;
+    /**
+     * @zh 是否是叶子节点
+     * @en Whether it is a leaf node
+     * @version 2.13.0
+     */
+    isLeaf?: boolean;
+    [name: string]: any;
+}
+
+interface TableDataWithRaw {
+    raw: TableData;
+    key: string | number;
+    disabled?: boolean;
+    expand?: string | RenderFunction;
+    children?: TableDataWithRaw[];
+    isLeaf?: boolean;
+    hasSubtree?: boolean;
+}
+
+interface TableSortable {
+    /**
+     * @zh 支持的排序方向
+     * @en Supported sort direction
+     */
+    sortDirections: ('ascend' | 'descend')[];
+    /**
+     * @zh 排序函数。设置为 `true` 可关闭内部排序。2.19.0 版本修改传出数据。
+     * @en Sorting function. Set to `true` to turn off internal sorting. Version 2.19.0 modifies outgoing data.
+     */
+    sorter?: ((a: TableData, b: TableData, extra: {
+        dataIndex: string;
+        direction: 'ascend' | 'descend';
+    }) => number) | boolean;
+    /**
+     * @zh 排序方向
+     * @en Sort direction
+     */
+    sortOrder?: 'ascend' | 'descend' | '';
+    /**
+     * @zh 默认排序方向（非受控模式）
+     * @en Default sort direction (uncontrolled mode)
+     */
+    defaultSortOrder?: 'ascend' | 'descend' | '';
+    /**
+     * @zh 多列排序优先级，数字越大越先比较；只在声明优先级的列之间保留多列排序。
+     * @en Multi-column sort priority. Higher values are compared first.
+     */
+    sortPriority?: number;
+}
+
+interface TableFilterData {
+    /**
+     * @zh 筛选数据选项的内容
+     * @en Filter the content of the data option
+     */
+    text: string | RenderFunction;
+    /**
+     * @zh 筛选数据选项的值
+     * @en Filter the value of the data option
+     */
+    value: string;
+}
+
+interface TableFilterable {
+    /**
+     * @zh 筛选数据
+     * @en Filter data
+     */
+    filters?: TableFilterData[];
+    /**
+     * @zh 筛选函数
+     * @en Filter function
+     */
+    filter: (filteredValue: string[], record: TableData) => boolean;
+    /**
+     * @zh 是否支持多选
+     * @en Whether to support multiple selection
+     */
+    multiple?: boolean;
+    /**
+     * @zh 筛选项
+     * @en Filter value
+     */
+    filteredValue?: string[];
+    /**
+     * @zh 默认筛选项
+     * @en Default filter value
+     */
+    defaultFilteredValue?: string[];
+    /**
+     * @zh 筛选框的内容
+     * @en The content of filter box
+     */
+    renderContent?: (data: {
+        filterValue: string[];
+        setFilterValue: (filterValue: string[]) => void;
+        handleFilterConfirm: (event: Event) => void;
+        handleFilterReset: (event: Event) => void;
+    }) => VNodeChild;
+    /**
+     * @zh 筛选按钮的图标
+     * @en Filter icon for button
+     */
+    icon?: RenderFunction;
+    /**
+     * @zh 筛选框的弹出框配置
+     * @en Pop-up box configuration of filter box
+     */
+    triggerProps?: TriggerProps;
+    /**
+     * @zh 筛选图标是否左对齐
+     * @en Whether the filter icon is aligned to the left
+     * @version 2.13.0
+     */
+    alignLeft?: boolean;
+    slotName?: string;
+}
+
+interface TableColumnData {
+    /**
+     * @zh 列信息的标识，对应 `TableData` 中的数据
+     * @en The identifier of the column information, corresponding to the data in `TableData`
+     */
+    dataIndex?: string;
+    /**
+     * @zh 列标题
+     * @en Column header
+     */
+    title?: string | RenderFunction;
+    /**
+     * @zh 列宽度
+     * @en Column width
+     */
+    width?: number;
+    /**
+     * @zh 最小列宽
+     * @en Minimum column width
+     */
+    minWidth?: number;
+    /**
+     * @zh 对齐方向
+     * @en Alignment direction
+     */
+    align?: 'left' | 'center' | 'right';
+    /**
+     * @zh 固定位置
+     * @en Fixed position
+     */
+    fixed?: 'left' | 'right';
+    /**
+     * @zh 是否显示省略号
+     * @en Whether to show ellipsis
+     */
+    ellipsis?: boolean;
+    /**
+     * @zh 是否在显示省略号时显示文本提示。可填入 tooltip 组件属性
+     * @en Whether to show a text hint when an ellipsis is displayed. Can be filled in tooltip component properties
+     * @version 2.26.0
+     */
+    tooltip?: boolean | Record<string, any>;
+    /**
+     * @zh 排序相关选项
+     * @en Sorting related options
+     */
+    sortable?: TableSortable;
+    /**
+     * @zh 过滤相关选项
+     * @en Filter related options
+     */
+    filterable?: TableFilterable;
+    /**
+     * @zh 表头子数据，用于表头分组
+     * @en Header sub-data, used for header grouping
+     */
+    children?: TableColumnData[];
+    /**
+     * @zh 自定义单元格类名
+     * @en Custom cell class
+     * @version 2.36.0
+     */
+    cellClass?: ClassName;
+    /**
+     * @zh 自定义表头单元格类名
+     * @en Custom header cell class
+     * @version 2.36.0
+     */
+    headerCellClass?: ClassName;
+    /**
+     * @zh 自定义内容单元格类名
+     * @en Custom body cell class
+     * @version 2.36.0
+     */
+    bodyCellClass?: ClassName | ((record: TableData) => ClassName);
+    /**
+     * @zh 自定义总结栏单元格类名
+     * @en Custom body cell class
+     * @version 2.36.0
+     */
+    summaryCellClass?: ClassName | ((record: TableData) => ClassName);
+    /**
+     * @zh 自定义单元格样式
+     * @en Custom cell style
+     * @version 2.11.0
+     */
+    cellStyle?: CSSProperties;
+    /**
+     * @zh 自定义表头单元格样式
+     * @en Custom header cell style
+     * @version 2.29.0
+     */
+    headerCellStyle?: CSSProperties;
+    /**
+     * @zh 自定义内容单元格样式
+     * @en Custom body cell style
+     * @version 2.29.0
+     */
+    bodyCellStyle?: CSSProperties | ((record: TableData) => CSSProperties);
+    /**
+     * @zh 自定义总结栏单元格样式
+     * @en Custom summary cell style
+     * @version 2.30.0
+     */
+    summaryCellStyle?: CSSProperties | ((record: TableData) => CSSProperties);
+    /**
+     * @zh 自定义列单元格的渲染
+     * @en Customize the rendering of column cells
+     */
+    render?: (data: {
+        record: TableData;
+        column: TableColumnData;
+        rowIndex: number;
+    }) => VNodeChild;
+    /**
+     * @zh 设置当前列的渲染插槽的名字。插槽参数同 #cell
+     * @en Sets the name of the render slot for the current column. Slot parameters are the same as #cell
+     * @version 2.18.0
+     */
+    slotName?: string;
+    /**
+     * @zh 设置当前列的标题的渲染插槽的名字
+     * @en Set the name of the render slot for the header of the current column
+     * @version 2.23.0
+     */
+    titleSlotName?: string;
+    slots?: Slots;
+    isLastLeftFixed?: boolean;
+    isFirstRightFixed?: boolean;
+    colSpan?: number;
+    rowSpan?: number;
+    index?: number;
+    parent?: TableColumnData;
+    _resizeWidth?: number;
+}
+
+interface TableBorder {
+    /**
+     * @zh 是否展示外边框
+     * @en TWhether to display the outer border
+     */
+    wrapper?: boolean;
+    /**
+     * @zh 是否展示单元格边框（表头+主体）
+     * @en Whether to display the cell border (header + body)
+     */
+    cell?: boolean;
+    /**
+     * @zh 是否展示表头单元格边框
+     * @en Whether to display the header cell border
+     */
+    headerCell?: boolean;
+    /**
+     * @zh 是否展示主体单元格边框
+     * @en Whether to display the body cell border
+     */
+    bodyCell?: boolean;
+}
+
+interface TableRowSelection {
+    /**
+     * @zh 行选择器的类型
+     * @en The type of row selector
+     */
+    type?: 'checkbox' | 'radio';
+    /**
+     * @zh 已选择的行（受控模式）
+     * @en Selected row (controlled mode)
+     */
+    selectedRowKeys?: BaseType[];
+    /**
+     * @zh 默认已选择的行（非受控模式）
+     * @en The selected row by default (uncontrolled mode)
+     */
+    defaultSelectedRowKeys?: BaseType[];
+    /**
+     * @zh 是否显示全选选择器
+     * @en Whether to show the select all selector
+     */
+    showCheckedAll?: boolean;
+    /**
+     * @zh 列标题
+     * @en Column title
+     */
+    title?: string;
+    /**
+     * @zh 列宽度
+     * @en Column width
+     */
+    width?: number;
+    /**
+     * @zh 是否固定
+     * @en Is it fixed
+     */
+    fixed?: boolean;
+    /**
+     * @zh 是否开启严格选择模式
+     * @en Whether to enable strict selection mode
+     * @defaultValue true
+     * @version 2.29.0
+     */
+    checkStrictly?: boolean;
+    /**
+     * @zh 是否仅展示当前页的 keys（切换分页时清空 keys）
+     * @en Whether to display only the keys of the current page (clear keys when switching paging)
+     * @version 2.32.0
+     */
+    onlyCurrent?: boolean;
+}
+
+interface TableExpandable {
+    /**
+     * @zh 显示的展开行（受控模式）
+     * @en Displayed Expanded Row (Controlled Mode)
+     */
+    expandedRowKeys?: BaseType[];
+    /**
+     * @zh 默认显示的展开行（非受控模式）
+     * @en Expand row displayed by default (Uncontrolled mode)
+     */
+    defaultExpandedRowKeys?: BaseType[];
+    /**
+     * @zh 是否默认展开所有的行
+     * @en Whether to expand all rows by default
+     */
+    defaultExpandAllRows?: boolean;
+    /**
+     * @zh 自定义展开行内容
+     * @en Customize expanded row content
+     */
+    expandedRowRender?: (record: TableData) => VNodeChild;
+    /**
+     * @zh 展开图标
+     * @en Expand icon
+     */
+    icon?: (expanded: boolean, record: TableData) => VNodeChild;
+    /**
+     * @zh 列标题
+     * @en Column title
+     */
+    title?: string;
+    /**
+     * @zh 列宽度
+     * @en Column width
+     */
+    width?: number;
+    /**
+     * @zh 是否固定
+     * @en Is it fixed
+     */
+    fixed?: boolean;
+}
+
+interface TableDraggable {
+    /**
+     * @zh 拖拽类型
+     * @en drag type
+     */
+    type?: 'row' | 'handle';
+    /**
+     * @zh 列标题
+     * @en Column title
+     */
+    title?: string;
+    /**
+     * @zh 列宽度
+     * @en Column width
+     */
+    width?: number;
+    /**
+     * @zh 是否固定
+     * @en Is it fixed
+     */
+    fixed?: boolean;
+}
+
+type OperationName = 'selection-checkbox' | 'selection-radio' | 'expand' | 'drag-handle';
+
+interface TableOperationColumn {
+    name: OperationName | string;
+    title?: string | RenderFunction;
+    width?: number;
+    fixed?: boolean;
+    render?: (record: TableData) => VNodeChild;
+    isLastLeftFixed?: boolean;
+}
+
+interface TableComponents {
+    operations: (operations: {
+        dragHandle?: TableOperationColumn;
+        expand?: TableOperationColumn;
+        selection?: TableOperationColumn;
+    }) => TableOperationColumn[];
+}
+
+interface TableChangeExtra {
+    /**
+     * @zh 触发类型
+     * @en Trigger type
+     */
+    type: 'pagination' | 'sorter' | 'filter' | 'drag';
+    /**
+     * @zh 页码
+     * @en page number
+     */
+    page?: number;
+    /**
+     * @zh 每页数据数
+     * @en number per page
+     */
+    pageSize?: number;
+    /**
+     * @zh 排序信息
+     * @en Sort information
+     */
+    sorter?: Sorter;
+    /** 按优先级排列的全部排序条件；sorter 保留首个条件以兼容已有消费方。 */
+    sorters?: Sorter[];
+    /**
+     * @zh 筛选信息
+     * @en Filter information
+     */
+    filters?: Filters;
+    /**
+     * @zh 拖拽信息
+     * @en Drag and drop information
+     */
+    dragTarget?: TableData;
+}
+
+interface TableInternalProps {
+    columns: TableColumnData[];
+    data: TableData[];
+    bordered?: boolean | TableBorder;
+    rowSelection?: TableRowSelection;
+    expandable?: TableExpandable;
+    pagination?: boolean | Data;
+    pagePosition?: string;
+}
+
+type Sorter = {
+    field: string;
+    direction: 'ascend' | 'descend';
+};
+
+type Filters = Record<string, string[]>;
+```
+
+
+返回 [Table 用法](./table.md)。