mirror of
https://github.com/element-plus/element-plus.git
synced 2024-12-21 02:50:11 +08:00
118 lines
3.9 KiB
TypeScript
118 lines
3.9 KiB
TypeScript
import { CreateElement, VNode } from 'vue'
|
|
import { ElementUIComponent, ElementUIHorizontalAlignment } from './component'
|
|
import { PopoverPlacement } from './popover'
|
|
|
|
export type TableColumnType = 'default' | 'selection' | 'index' | 'expand'
|
|
export type TableColumnFixedType = 'left' | 'right'
|
|
export type SortOrders = 'ascending' | 'descending' | null
|
|
|
|
export type TableColumn = {
|
|
/** Label of the column */
|
|
label: string
|
|
|
|
/** Property name of the source data */
|
|
property: string
|
|
|
|
/** Type of the column */
|
|
type: string
|
|
|
|
/** Whether column is fixed at left/right */
|
|
fixed: boolean | string
|
|
}
|
|
|
|
/** Data used in renderHeader function */
|
|
export interface RenderHeaderData {
|
|
/** The column that is current rendering */
|
|
column: any
|
|
|
|
/** The index of the rendering column */
|
|
$index: number
|
|
}
|
|
|
|
/** Filter Object */
|
|
export interface TableColumnFilter {
|
|
/** The text to show in the filter's panel */
|
|
text: string
|
|
|
|
/** The value of the filter */
|
|
value: any
|
|
}
|
|
|
|
/** TableColumn Component */
|
|
export declare class ElTableColumn extends ElementUIComponent {
|
|
/** Type of the column. If set to `selection`, the column will display checkbox. If set to `index`, the column will display index of the row (staring from 1). If set to `expand`, the column will display expand icon. */
|
|
type: TableColumnType
|
|
|
|
/** Column label */
|
|
label: string
|
|
|
|
/** Column's key. If you need to use the filter-change event, you need this attribute to identify which column is being filtered */
|
|
columnKey: string
|
|
|
|
/** Field name. You can also use its alias: property */
|
|
prop: string
|
|
|
|
/** Column width */
|
|
width: string
|
|
|
|
/** Column minimum width. Columns with `width` has a fixed width, while columns with `min-width` has a width that is distributed in proportion */
|
|
minWidth: string
|
|
|
|
/** Whether column is fixed at left/right. Will be fixed at left if `true` */
|
|
fixed: boolean | TableColumnFixedType
|
|
|
|
/** Render function for table header of this column */
|
|
renderHeader: (h: CreateElement, data: RenderHeaderData) => VNode | string
|
|
|
|
/** Whether column can be sorted */
|
|
sortable: boolean | 'custom'
|
|
|
|
/** Sorting method. Works when `sortable` is `true` */
|
|
sortMethod: (a: any, b: any) => number
|
|
|
|
/** The order of the sorting strategies used when sorting the data. Works when `sortable` is `true`. */
|
|
sortOrders: SortOrders[]
|
|
|
|
/** Whether column width can be resized. Works when border of `el-table` is `true` */
|
|
resizable: boolean
|
|
|
|
/** Function that formats content */
|
|
formatter: (row: Record<string, unknown>, column: TableColumn) => any
|
|
|
|
/** Whether to hide extra content and show them in a tooltip when hovering on the cell */
|
|
showOverflowTooltip: boolean
|
|
|
|
/** Alignment */
|
|
align: ElementUIHorizontalAlignment
|
|
|
|
/** Alignment of the table header. If omitted, the value of the `align` attribute will be applied */
|
|
headerAlign: ElementUIHorizontalAlignment
|
|
|
|
/** Class name of cells in the column */
|
|
className: string
|
|
|
|
/** Class name of the label of this column */
|
|
labelClassName: string
|
|
|
|
/** Function that determines if a certain row can be selected, works when `type` is `'selection'` */
|
|
selectable: (row: Record<string, unknown>, index: number) => boolean
|
|
|
|
/** Whether to reserve selection after data refreshing, works when `type` is `'selection'` */
|
|
reserveSelection: boolean
|
|
|
|
/** An array of data filtering options */
|
|
filters: TableColumnFilter[]
|
|
|
|
/** Placement for the filter dropdown */
|
|
filterPlacement: PopoverPlacement
|
|
|
|
/** Whether data filtering supports multiple options */
|
|
filterMultiple: boolean
|
|
|
|
/** Data filtering method. If `filter-multiple` is on, this method will be called multiple times for each row, and a row will display if one of the calls returns `true` */
|
|
filterMethod: (value: any, row: Record<string, unknown>) => boolean
|
|
|
|
/** Filter value for selected data, might be useful when table header is rendered with `render-header` */
|
|
filteredValue: TableColumnFilter[]
|
|
}
|