|
|
// 从 "element-plus/es/components/table/src/table-column/defaults" 导入 TableColumnCtx 类型
|
|
|
// TableColumnCtx 可能是 Element Plus 中表格列的上下文类型，包含了表格列的一些默认属性和方法
|
|
|
import { TableColumnCtx } from "element-plus/es/components/table/src/table-column/defaults";
|
|
|
// 从 "@/components/Grid/interface" 导入 BreakPoint 和 Responsive 类型
|
|
|
// BreakPoint 可能表示响应式布局中的不同断点（如 xs, sm, md, lg, xl 等）
|
|
|
// Responsive 可能用于描述在不同断点下的响应式配置
|
|
|
import { BreakPoint, Responsive } from "@/components/Grid/interface";
|
|
|
|
|
|
// 定义一个接口 EnumProps，用于描述枚举属性
|
|
|
export interface EnumProps {
|
|
|
// 选项框显示的文字，类型为字符串
|
|
|
label: string;
|
|
|
// 选项框值，可以是任意类型
|
|
|
value: any;
|
|
|
// 是否禁用此选项，可选，默认为 undefined，类型为布尔值
|
|
|
disabled?: boolean;
|
|
|
// 当 tag 为 true 时，此选择会指定 tag 显示类型，可选，默认为 undefined，类型为字符串
|
|
|
tagType?: string;
|
|
|
// 为树形选择时，可以通过 children 属性指定子选项，可选，默认为 undefined，类型为 EnumProps 数组
|
|
|
children?: EnumProps[];
|
|
|
// 允许添加任意其他属性，属性名和值的类型都为任意类型
|
|
|
[key: string]: any;
|
|
|
}
|
|
|
|
|
|
// 定义一个类型别名 TypeProp，其值只能是 "index"、"selection" 或 "expand" 中的一个
|
|
|
export type TypeProp = "index" | "selection" | "expand";
|
|
|
|
|
|
// 定义一个类型别名 SearchType，用于表示搜索框的类型
|
|
|
// 可以是 "input"、"input-number" 等多种 Element Plus 组件类型
|
|
|
export type SearchType =
|
|
|
| "input"
|
|
|
| "input-number"
|
|
|
| "select"
|
|
|
| "select-v2"
|
|
|
| "tree-select"
|
|
|
| "cascader"
|
|
|
| "date-picker"
|
|
|
| "time-picker"
|
|
|
| "time-select"
|
|
|
| "switch"
|
|
|
| "slider";
|
|
|
|
|
|
// 定义一个接口 SearchProps，用于描述搜索项的属性
|
|
|
export type SearchProps = {
|
|
|
// 当前项搜索框的类型，类型为 SearchType
|
|
|
el: SearchType;
|
|
|
// 搜索项参数，根据 element plus 官方文档来传递，该属性所有值会透传到组件，可选，默认为 undefined
|
|
|
props?: any;
|
|
|
// 当搜索项 key 不为 prop 属性时，可通过 key 指定，可选，默认为 undefined，类型为字符串
|
|
|
key?: string;
|
|
|
// 搜索项排序（从大到小），可选，默认为 undefined，类型为数字
|
|
|
order?: number;
|
|
|
// 搜索项所占用的列数，默认为 1 列，可选，默认为 undefined，类型为数字
|
|
|
span?: number;
|
|
|
// 搜索字段左侧偏移列数，可选，默认为 undefined，类型为数字
|
|
|
offset?: number;
|
|
|
// 搜索项默认值，可以是字符串、数字、布尔值或任意类型的数组，可选，默认为 undefined
|
|
|
defaultValue?: string | number | boolean | any[];
|
|
|
// 扩展为包含 BreakPoint 类型的键和 Responsive 类型的值的部分记录，用于实现响应式配置
|
|
|
} & Partial<Record<BreakPoint, Responsive>>;
|
|
|
|
|
|
// 定义一个接口 ColumnProps，用于描述表格列的属性
|
|
|
// 扩展自 Partial<Omit<TableColumnCtx<T>, "children" | "renderHeader" | "renderCell">>，表示部分继承 TableColumnCtx 类型并去除 "children"、"renderHeader" 和 "renderCell" 属性
|
|
|
export interface ColumnProps<T = any>
|
|
|
extends Partial<Omit<TableColumnCtx<T>, "children" | "renderHeader" | "renderCell">> {
|
|
|
// 是否是标签展示，可选，默认为 undefined，类型为布尔值
|
|
|
tag?: boolean;
|
|
|
// 是否显示在表格当中，可选，默认为 undefined，类型为布尔值
|
|
|
isShow?: boolean;
|
|
|
// 搜索项配置，可选，默认为 undefined，类型为 SearchProps 或 undefined
|
|
|
search?: SearchProps | undefined;
|
|
|
// 枚举类型（渲染值的字典），可以是 EnumProps 数组或一个返回 Promise<any> 的函数，可选，默认为 undefined
|
|
|
enum?: EnumProps[] | ((params?: any) => Promise<any>);
|
|
|
// 当前单元格值是否根据 enum 格式化（示例：enum 只作为搜索项数据），可选，默认为 undefined，类型为布尔值
|
|
|
isFilterEnum?: boolean;
|
|
|
// 指定 label && value 的 key 值，可选，默认为 undefined，类型为包含 label 和 value 键的对象
|
|
|
fieldNames?: { label: string; value: string };
|
|
|
// 自定义表头内容渲染（tsx语法），可选，默认为 undefined，类型为一个接受 ColumnProps 类型参数并返回任意类型的函数
|
|
|
headerRender?: (row: ColumnProps) => any;
|
|
|
// 自定义单元格内容渲染（tsx语法），可选，默认为 undefined，类型为一个接受包含 row 属性且类型为 T 的对象并返回任意类型的函数
|
|
|
render?: (scope: { row: T }) => any;
|
|
|
// 多级表头，可选，默认为 undefined，类型为 ColumnProps<T> 数组
|
|
|
_children?: ColumnProps<T>[];
|
|
|
}
|
