Skip to content

CrudTable 表格

非常完善的表格组件,灵活配置完成数据的增删改查,用于展示多条结构类似的数据, 可对数据进行排序、筛选、对比或其他自定义操作。

基础表格

高级表格

CrudTable 属性

属性名说明类型可选值默认值
data显示的数据array--
loading数据加载状态boolean-false
options表格配置objectoptions-
page表格分页参数objectobject{ pageIndex: 1, pageSize: 10, total: 0, }
headerRowStyle表头行的 style 的回调方法,也可以使用一个固定的 Object 为所有表头行设置一样的 Stylefunction({ row, rowIndex }) / object--
style组件style样式object--
className组件className样式string--
rowStyle行的style的回调方法,参考element-plusfunction--
rowClassName行的className的回调方法,参考element-plusfunction--
cellStyle单元格的style的回调方法,参考element-plusfunction--
cellClassName单元格的className的回调方法,参考element-plusfunction--
headerRowStyle表头style的回调方法,参考element-plusfunction--
headerRowClassName表头className的回调方法,参考element-plusfunction--
headerCellStyle表头单元格style的回调方法,参考element-plusfunction--
headerCellClassName表头单元格className的回调方法,参考element-plusfunction--
spanMethod合并行或列的计算方法,参考element-plusfunction--

CrudTable 事件

事件名说明回调参数
confirm-search数据查询方法,该方法中获取参数,调用接口查询数据searchParams
clear-search数据查询方法,与confirm-search类似,该方清空参数,恢复默认参数,自动调用接口查询数据-
change-pagination分页数据改变时,默认调用confirm-search方法查询数据page
selection-change当用户手动勾选数据行的 Checkbox 时触发的事件selection
row-click当某一行被点击时会触发该事件时触发的事件row, column, event
row-contextmenu当某一行被鼠标右键点击时会触发该事件row, column, event
row-dblclick当某一行被双击时会触发该事件row, column, event
cell-click当某个单元格被点击时会触发该事件row, column, event
cell-dblclick当某个单元格被双击击时会触发该事件row, column, event
cell-contextmenu当某个单元格被鼠标右键点击时会触发该事件row, column, event
cell-mouse-enter当单元格 hover 进入时会触发该事件row, column, event
cell-mouse-leave当单元格 hover 退出时会触发该事件row, column, event
expand-change当用户对某一行展开或者关闭的时候会触发该事件(展开行时,回调的第二个参数为 expandedRows;树形表格时第二参数为 expanded)row, (expandedRows

options 配置

属性名说明类型可选值默认值
columns表单列数据arraycolumns-
initLoadData初始是否默认加载数据boolen-true
defaultContentHeight默认表格内容高度number-300
fullscreenchangeContentHeight是否开启监听全屏改变是动态设置table内容高度,默认关闭boolen-false
rowKey行数据的 Key,用来优化 Table 的渲染string-id
size尺寸大小stringlarge default smalldefault
fit列的宽度是否自撑开boolen-true
stripe是否为斑马纹 tableboolen-true
border是否带有纵向边框boolen-true
index是否显示序号boolen-true
selection是否显示选项框boolen-true
headerAlign表头对齐方式, 若不设置该项,则使用表格的对齐方式stringleft / center / rightcenter
cellAlign单元项对齐方式stringleft / center / rightcenter
columnMinWidth表格列默认宽度stringstring100px
addBtn是否显示新增按钮boolen-true
viewBtn是否显示查看按钮boolen-true
editBtn是否显示编辑按钮boolen-true
delBtn是否显示删除按钮boolen-true
batchDelBtn是否显示批量删除按钮boolen-true
refreshBtn是否显示table刷新按钮boolen-true
settingBtn是否显示table设置按钮boolen-true
operations是否显示table操作栏boolen-true
operationsWidthtable操作栏默认宽度number-260
operationsBtnPlaintable操作栏按钮设置plainboolen-false
operationsBtnTexttable操作栏按钮设置textboolen-true
operationsBtnSizetable操作栏按钮大小stringlarge / default / smallsmall
addBtnText自定义新增按钮名称string-新增
showSearchForm是否显示table搜索栏boolen-true
showHeaderMenu是否显示table菜单栏boolen-true
showSearchLabel是否显示table搜索栏labelboolen-true
searchSpan表格搜索栏列span设置number-4
searchGutter表格搜索栏列间隔设置number-4
searchLabelWidth表格搜索栏列label宽度number-5em
searchColumnMinWidth表格搜索栏列最小宽度number-300
searchColumns表格搜索栏列配置arraySearchColumnProps-
isPagination是否显示分页boolen-true
dialogTitle新增/编辑/详情 弹框titlestring--
dialogWidth新增/编辑/详情 弹框宽度string-60%
dialogFullscreen新增/编辑/详情 弹框是否全屏boolen-false
closeOnClickModal新增/编辑/详情 是否可以通过点击 modal 关闭窗口boolen-false
formLabelWidth新增/编辑/详情 表单label宽度string-5em
formColumnMinWidth新增/编辑/详情 表单列默认最小宽度number-350
formSpan新增/编辑/详情 表单列比例spannumber-12
formColumns新增/编辑/详情 表单列比例spanarrayFormColunmProps-

columns 配置

属性名说明类型可选值默认值
prop字段名称 对应列内容的字段名string--
label显示的标题string--
width表格列宽度string,number--
minWidth表格列最小宽度string,number--
fixed表格列固定stringleft right-
formatter用来格式化内容functionfunction(row, column, cellValue, index)-
showOverflowTooltip单元格文本溢出显示提示框boolen-true
headerAlign表头列对齐方式stringcenter left rightcenter
align单元格对齐方式stringcenter left rightcenter
sortable是否开启排序boolen-false
children子集arraycolumns-
type搜索栏或表单类型列显示stringinput inputInteger inputNumber textarea select radio checkbox date time datetime datetimerange numberRange inputTableSelect uploadImageinput
placeholder显示的placeholderstring--
dicData当type是类型选择时设置的选项字典array[{value: '', label: ''}]-
loadDicData动态加载选项字段方法function回调参数 (col done), done回调函数传入dicData数据-
disabled是否禁用boolen-false
readonly是否只读boolen-false
defaultValue表单默认值any--
labelWidth表格列宽度string, numner--
multiple是否可以多选boolen--
prefix表单前缀function返回对应前缀显示内容-
suffix表单后缀function返回对应后缀显示内容-
prepend表单前置function返回对应前置显示内容-
append表单后置function返回对应后置显示内容-
sort表单列表排序number--
required表单列表必填boolen--
hide表格是否显示列boolen--
span表单列spannumber-12
tableSelect表单列table弹框选择any--
onChange表单列change事件function--

SearchColumnProps 配置

属性名说明类型可选值默认值
searchType搜索栏类型列显示string--
searchSort-number--
searchLabel-string--
searchPlaceholder-string--
searchLabelWidth-string number--
searchDefaultValue-any--
searchDisabled-boolean--
searchReadonly-boolean--
searchHide-boolean--
searchMultiple-boolean--
searchFormat-string--
searchDisabledDate-string--
searchEditable-boolen--
searchShortcuts-any--
searchMin-number--
searchMax-number--
searchPrefix-function--
searchSuffix-function--
searchPrepend-function--
searchAppend-function--
searchDicData-array--
searchLoadDicData-function--
onChangeSearch-function--

FormColunmProps 配置

属性名说明类型可选值默认值
formType表单类型列显示string--
formSort-number--
formLabel-string--
formPlaceholder-string--
formLabelWidth-string number--
formDefaultValue-any--
formRequired-boolean--
formDisabled-boolean--
formReadonly-boolean--
formHide-boolean--
formMultiple-boolean--
formFormat-string--
formRemark-string--
formDivider-boolen--
formPrefix-function--
formSuffix-function--
formPrepend-function--
formAppend-function--
formRules-array--
formDicData-array--
searchLoadDicData-function--
onChangeForm-function--

Released under the MIT License.