Welcome to Hexo! This is your very first post. Check documentation for more info. If you get any problems when using Hexo, you can find the answer in troubleshooting or you can ask me on GitHub.
Welcome to Hexo! This is your very first post. Check documentation for more info. If you get any problems when using Hexo, you can find the answer in troubleshooting or you can ask me on GitHub.
如 $\lim_{x \to 0} \frac{\sin x}{x}$ 渲染的是
$$
\begin{eqnarray}
\lim_{x \to 0} \frac{\sin x + x^2 + x^3}{x} & = & \lim_{x \to 0} \frac{\sin x }{x} + \lim_{x \to 0} \frac{x^2 }{x} + \lim_{x \to 0}\frac{x^3}{x}
\\ & = & \lim_{x \to 0}\frac{\sin x}{x}
\\ & = & 1
\end{eqnarray}
$$
本文档描述了 @pureadmin/table
组件库的完整类型定义,包括表格组件、分页组件、加载配置等相关类型。
1 | type Size = "large" | "default" | "small"; |
组件尺寸类型。
1 | type Align = "left" | "center" | "right"; |
对齐方式类型。
1 | type Effect = "dark" | "light"; |
tooltip 效果类型。
1 | type Layout = "fixed" | "auto"; |
表格布局类型。
基础的 Element Plus 表格属性配置。
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
data |
Array<any> |
- | 显示的数据(必填) |
height |
string | number |
- | Table 的高度 |
maxHeight |
string | number |
- | Table 的最大高度 |
stripe |
boolean |
false |
是否为斑马纹 table |
border |
boolean |
false |
是否带有纵向边框 |
size |
Size |
- | Table 的尺寸 |
fit |
boolean |
true |
列的宽度是否自撑开 |
showHeader |
boolean |
true |
是否显示表头 |
highlightCurrentRow |
boolean |
false |
是否要高亮当前行 |
属性名 | 类型 | 说明 |
---|---|---|
currentRowKey |
string | number |
当前行的 key(只写属性) |
rowClassName |
ColumnCls<any> |
行的 className 回调方法 |
rowStyle |
ColumnStyle<any> |
行的 style 回调方法 |
cellClassName |
CellCls<any> |
单元格的 className 回调方法 |
cellStyle |
CellStyle<any> |
单元格的 style 回调方法 |
headerRowClassName |
ColumnCls<any> |
表头行的 className 回调方法 |
headerRowStyle |
ColumnStyle<any> |
表头行的 style 回调方法 |
headerCellClassName |
CellCls<any> |
表头单元格的 className 回调方法 |
headerCellStyle |
CellStyle<any> |
表头单元格的 style 回调方法 |
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
rowKey |
string | ((row: any) => string) |
- | 行数据的 Key |
emptyText |
string |
"No Data" |
空数据时显示的文本内容 |
defaultExpandAll |
boolean |
false |
是否默认展开所有行 |
expandRowKeys |
any[] |
- | 展开行的 keys 数组 |
defaultSort |
Sort |
- | 默认的排序列的 prop 和顺序 |
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
tooltipEffect |
Effect |
"dark" |
tooltip effect 属性 |
tooltipOptions |
TableOverflowTooltipOptions |
- | 溢出 tooltip 的选项 |
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
showSummary |
boolean |
false |
是否在表尾显示合计行 |
sumText |
string |
"合计" |
合计行第一列的文本 |
summaryMethod |
SummaryMethod<any> |
- | 自定义的合计计算方法 |
spanMethod |
Function |
- | 合并行或列的计算方法 |
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
selectOnIndeterminate |
boolean |
true |
多选表格中点击表头多选框的行为 |
indent |
number |
16 |
展示树形数据时,树节点的缩进 |
lazy |
boolean |
- | 是否懒加载子节点数据 |
load |
Function |
- | 加载子节点数据的函数 |
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
treeProps |
{ hasChildren?: string; children?: string; } |
{ hasChildren: 'hasChildren', children: 'children' } |
渲染嵌套数据的配置选项 |
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
tableLayout |
Layout |
"fixed" |
设置表格单元、行和列的布局方式 |
scrollbarAlwaysOn |
boolean |
false |
总是显示滚动条 |
flexible |
boolean |
false |
确保主轴的最小尺寸 |
扩展的表格属性,继承自 TableProps
。
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
tableKey |
string | number |
- | 唯一键,用于多表格实例区分 |
columns |
Array<TableColumns> |
- | Table-column 配置(必填) |
loading |
boolean |
false |
是否开启加载动画 |
loadingConfig |
LoadingConfig |
- | 加载动画的相关配置 |
alignWhole |
Align |
"left" |
对齐方式 |
headerAlign |
Align |
- | 表头对齐方式 |
showOverflowTooltip |
boolean |
false |
当内容过长被隐藏时显示 tooltip |
rowHoverBgColor |
string |
- | 鼠标经过行时的背景色 |
pagination |
PaginationProps |
- | 分页相关配置 |
adaptive |
boolean |
false |
表格是否撑满内容区自适应高度 |
adaptiveConfig |
AdaptiveConfig |
- | 撑满内容区自适应高度相关配置 |
locale |
DefaultLanguage | Language |
- | 国际化配置 |
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
offsetBottom |
number |
96 |
表格距离页面底部的偏移量 |
fixHeader |
boolean |
true |
是否固定表头 |
timeout |
number |
60 |
页面 resize 时的防抖时间(ms) |
zIndex |
number |
3 |
表头的 z-index |
表格列的完整配置选项。
属性名 | 类型 | 说明 |
---|---|---|
label |
string |
显示的标题 |
prop |
string | ((index: number) => string) |
字段名称 |
type |
TableColumnType |
列的类型(selection/index/expand) |
index |
number | ((index: number) => number) |
自定义索引 |
columnKey |
string |
column 的 key |
width |
string | number |
对应列的宽度 |
minWidth |
string | number |
对应列的最小宽度 |
fixed |
TableColumnFixed |
列是否固定(true/left/right) |
属性名 | 类型 | 说明 |
---|---|---|
renderHeader |
Function |
列标题 Label 区域渲染函数 |
formatter |
Function |
用来格式化内容 |
showOverflowTooltip |
boolean |
当内容过长被隐藏时显示 tooltip |
align |
Align |
对齐方式 |
headerAlign |
Align |
表头对齐方式 |
className |
string |
列的 className |
labelClassName |
string |
当前列标题的自定义类名 |
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
sortable |
TableColumnSortable |
false |
对应列是否可以排序 |
sortMethod |
Function |
- | 指定数据按照哪个属性进行排序 |
sortBy |
string | Function | string[] |
- | 指定数据按照哪个属性进行排序 |
sortOrders |
Array<TableColumnSortOrders> |
['ascending', 'descending', null] |
数据在排序时所使用排序策略的轮转顺序 |
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
resizable |
boolean |
true |
对应列是否可以通过拖动改变宽度 |
selectable |
Function |
- | 仅对 type=selection 的列有效 |
reserveSelection |
boolean |
false |
仅对 type=selection 的列有效 |
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
filters |
Array<{text: string; value: string}> |
- | 数据过滤的选项 |
filterPlacement |
TableColumnFilterPlacement |
- | 过滤弹出框的定位 |
filterClassName |
string |
- | 过滤弹出框的 className |
filterMultiple |
boolean |
true |
数据过滤的选项是否多选 |
filterMethod |
Function |
- | 数据过滤使用的方法 |
filteredValue |
Array<any> |
- | 选中的数据过滤项 |
属性名 | 类型 | 说明 |
---|---|---|
hide |
boolean | CallableFunction |
是否隐藏 |
slot |
string |
自定义列的内容插槽 |
headerSlot |
string |
自定义表头的内容插槽 |
children |
Array<TableColumns> |
多级表头 |
cellRenderer |
Function |
自定义单元格渲染器(jsx语法) |
headerRenderer |
Function |
自定义头部渲染器(jsx语法) |
分页组件的配置选项。
属性名 | 类型 | 说明 |
---|---|---|
pageSize |
number |
每页显示条目个数(必填) |
total |
number |
总条目数(必填) |
currentPage |
number |
当前页数(必填) |
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
size |
Size |
"default" |
分页大小 |
background |
boolean |
false |
是否为分页按钮添加背景色 |
defaultPageSize |
number |
- | 每页显示条目数的初始值 |
pageCount |
number |
- | 总页数 |
pagerCount |
number |
- | 设置最大页码按钮数 |
defaultCurrentPage |
number |
- | 当前页数的初始值 |
layout |
string |
"total, sizes, prev, pager, next, jumper" |
组件布局 |
pageSizes |
number[] |
[5, 10, 15, 20] |
每页显示个数选择器的选项设置 |
popperClass |
string |
- | 每页显示个数选择器的下拉框类名 |
prevText |
string |
- | 替代图标显示的上一页文字 |
nextText |
string |
- | 替代图标显示的下一页文字 |
disabled |
boolean |
false |
是否禁用分页 |
hideOnSinglePage |
boolean |
- | 只有一页时是否隐藏 |
align |
Align |
"right" |
分页的对齐方式 |
style |
CSSProperties |
- | 自定义分页样式 |
class |
string |
- | 自定义类名 |
加载动画的相关配置。
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
text |
string |
- | 显示在加载图标下方的加载文案 |
spinner |
string |
- | 自定义加载图标 |
svg |
string |
- | 自定义 svg 加载图标 |
viewBox |
string |
- | 自定义 svg 加载图标的大小 |
background |
string |
- | 背景遮罩的颜色 |
1 | type DefaultLanguage = "en" | "zhCn" | "zhTw"; |
1 | type Language = { |
1 | type TranslatePair = { |
属性名 | 类型 | 说明 |
---|---|---|
locale |
DefaultLanguage | Language |
国际化配置 |
i18n |
I18n |
自适应国际化语言 |
ssr |
boolean |
是否是服务端渲染 |
1 | type TableColumnType = "selection" | "index" | "expand"; |
1 | type TableColumnSortable = false | true | "custom"; |
1 | type TableColumnFixed = true | "left" | "right"; |
1 | type TableColumnSortOrders = "ascending" | "descending" | null; |
1 | type TableColumnFilterPlacement = "top-start" | "top-end" | "top" | "bottom-start" | "bottom-end" | "bottom" | "left-start" | "left-end" | "left" | "right-start" | "right-end" | "right"; |
1 | import type { PureTableProps, TableColumns } from '@pureadmin/table'; |
1 | const columns: TableColumns[] = [ |