Skip to content

Crud属性文档

js
//crud组件全局配置
app.use(XCrud)

Crud

参数说明类型
v-model:form绑定表单值object
data显示的数据array
option表单配置项参考Option配置TableOption
before-open弹窗表单打开前的回调,会暂停Dialog的打开,done用于打开Dialog,type(check/查看,create/新增, update/编辑)为当前窗口的类型,row为弹窗表单的绑定的数据新增时为undefined
Function
dialog-close弹窗关闭前的回调,type为当前窗口的类型
Function
permission表格多个按钮权限控制,采用函数方式可以精确到行控制CrudPermission
search搜索变量object
page分页变量参考Page参数CrudPageProps
span-method合并行或列的计算方法
Function
summary-method自定义的合计计算方法
Function

Page

参数说明类型默认值
currentPage当前页数number1
pageSize每页显示条目个数number10
total总条目数number0
background是否为分页按钮添加背景色booleantrue
layout组件布局,子组件名用逗号分隔
Array
[total, sizes, prev, pager, next, jumper]
pageSizes每页显示个数选择器的选项设置number[][10, 20, 30, 40]

Option

参数说明类型默认值
title表格标题string | VNode-
height表格高度string-
maxHeight表格的最大高度。 合法的值为数字或者单位为 px 的高度string-
index是否有序号栏booleanfalse
indexText序号栏文本内容string序号
lazy表格组件是否懒加载子节点数据booleanfalse
border是否带有纵向边框booleanfalse
labelWidth表单项的文字宽度number90
selection是否有选择框booleanfalse
selectionWidth复选框栏宽度string50
rowKey行数据的 Key,用来优化 Table 的渲染;在使用 reserve-selection 功能与显示树形数据时,该属性是必填的。stringid
menu是否显示操作栏booleanfalse
menuTitle操作栏标题string操作
menuWidth操作栏宽度string220px
menuMinWidth操作栏最小宽度string220px
menuFixed操作栏列是否固定在左侧或者右侧。 true 表示固定在左侧boolean | left | rightright
menuHeaderAlign操作栏表头的对齐方式left | center | rightcenter
sortable是否开启拖拽排序booleanfalse
menuHeaderRight表格头部菜单栏右边是否显示booleantrue
column表头配置ColumnProps[]详情-
group表单分组TableGroupInterface[]-
tableLoading表格等待框的控制booleanfalse
highlightCurrentRow是否要高亮当前行booleanfalse
searchLabelWidth搜索项标题宽度number90
searchSpan搜索项框栅列number8
defaultExpandAll是否默认展开所有行,当前表格包含展开行存在或者为树形表格时有效booleanfalse
isDrawer弹窗是否为抽屉booleanfalse
addTitle表格新增弹窗标题string新增
editTitle表格修改弹窗标题string编辑
viewTitle表格查看弹窗标题string查看
dialogWidth表格弹窗宽度string80%
addBtn表格新增按钮booleanfalse
delBtn表格删除按钮booleanfalse
viewBtn表格查看按钮booleanfalse
updateBtn修改按钮booleanfalse
importBtn表格导入按钮booleanfalse
excelBtn表格导出按钮booleanfalse
viewTabstabs查看ViewTabs[]-
isCard是否卡片booleantrue
menuBtn表单操作栏是否显示booleantrue
cancelBtn表格弹窗取消按钮booleantrue
submitBtn表格弹窗提交按钮booleantrue
submitBtnText表格弹窗提交按钮文本string确定

Column

参数说明类型默认值
label列标题string | VNode-
prop列标题的内容属性名称string-
componentBind表单项的需要绑定的其他值 type为selectPeople/regionalGrid 的时候该参数必填string-
type表单项的类型
FormItemType
input
span表单项的栅列number12
align对齐方式
enum
left
headerAlign表头对齐方式, 若不设置该项,则使用表格的对齐方式 默认left
enum
left
fixed列是否固定在左侧或者右侧。 true 表示固定在左侧
enum
-
width对应列的宽度number | string90
minWidth对应列的最小宽度, 对应列的最小宽度, 与 width 的区别是 width 是固定的,min-width 会把剩余宽度按比例分配给设置了 min-width 的列number | string-
showOverflowTooltip当内容过长被隐藏时显示booleanfalse
formatter用来格式化内容
Function
className列的 classNamestring-
labelClassName列的 classNamestring-
props数据字典属性的配置对象PropsInterface{label: 'label', value: 'value'}
dicData数据字典值DicDataInterface-
dicAjaxResolve数据字典 接口函数返回的数据Promise<any>-
searchSpan搜索项框栅列number8
menuSpan搜索栏操作区域的栅列number-
searchLabelWidth搜索项标题宽度number90
search是否为搜索项boolean-
searchPlaceholder搜索项辅助文字string-
searchType搜索项的类型 默认搜索项的类型,不配置则取type的配置FormItemTypeinput
searchClearable搜索项清除booleantrue
rules表单校验条件
RulesType
-
display弹出表单当前项是否显示
boolean | Function
true
createDisplay表单新增时当前项是否显示
boolean | Function
true
updateDisplay表单编辑时当前项是否显示
boolean | Function
true
checkDisplay表单查看时当前项是否显示
boolean | Function
true
disabled弹出表单当前项是否禁用booleanfalse`
createDisabled表单新增时当前项是否显示booleanfalse
updateDisabled表单编辑时当前项是否显示booleanfalse
checkDisabled表单查看时当前项是否显示booleanfalse
labelWidth表单项标题宽度number90
hide表格项是否隐藏booleanfalse
setUpHide列不显示可以通过操作控制显示booleanfalse
order表单位置排序,序号越大越靠前number1
searchOrder搜索栏位置排序,序号越大越靠前number1
tip内容提示辅助语string | VNode-
tipPlacement内容提示辅助语位置
enum
right-start
style表单项的样式CSSProperties-
sortable实现以该列为基准的排序booleanfalse
on触发事件的对象集合on?: {[key: string]: (event: any) => void}-

input

参数说明类型默认值
maxlength最大输入长度string | number-
minlength原生属性,最小输入长度number-
show-word-limit是否显示输入字数统计,只在 type = "text" 或 type = "textarea" 时有效booleanfalse
placeholder输入框占位文本string-
clearable是否可清空booleanfalse
size输入框尺寸,只在type不为 'textarea' 时有效
enum
default

inputNumber

type等于textarea的生效的配置项 具体参考el-input-number

textarea

type等于textarea的生效的配置项 具体参考el-textarea

select

type等于select的生效的配置项 具体参考el-select

checkbox

type等于checkbox的生效的配置项 具体参考el-checkbox

radio

type等于radio的生效的配置项 具体参考el-radio

radioButton

type等于radioButton的生效的配置项 具体参考el-radio

datePicker

type等于datePicker的生效的配置项 具体参考el-date-picker

cascader

type等于cascader的生效的配置项 具体参考el-cascader

switch

type等于switch的生效的配置项 具体参考el-switch

treeSelect

type等于treeSelect的生效的配置项 具体参考el-tree-select

editTable

type等于editTable的生效的配置项 具体参考editTable

Group

参数说明类型可选值默认值
label分组标题string | VNode--
prop表单分组的属性名称string--
slot是否插槽boolean--
column表单的各项FormColumnProps[]详情--

Events

事件名说明类型回调参数
row-save新增数据后点击确定触发该事件
Function
row表单绑定的数据,done关闭弹窗的函数isClear默认true关闭弹窗清空表单,isClear/false就只清除按钮loading效果
row-update编辑数据后点击确定触发该事件
Function
row表单绑定的数据,done关闭弹窗的函数isClear默认true关闭弹窗清空表单,isClear/false就只清除按钮loading效果
row-del删除数据后触发该事件
Function
row表格对应项的数据,index表格点击项
row-click行点击触发该事件
Function
row表格对应项的数据
selection-change表格多选触发该事件
Function
selection表格选中的数据
current-change表格
Function
currentPage表格选中的数据

Methods

方法名说明类型参数
doLayout对 Table 进行重新布局。 当表格可见性变化时,您可能需要调用此方法以获得正确的布局Function-
closeDialogForm关闭表单弹窗Function-
openDialogForm打开弹窗
Function
type弹窗类型check/查看,create/新增,update/修改,row表格对应的行数据,index 对应表格的第几行
toggleRowRadio用于单选表格
Function
id表格数据里对应的rowKey默认为id
toggleRowSelection用于多选表格,切换某一行的选中状态,如果使用了第二个参数,则可直接设置这一行选中与否
Function
row表格对应的行数据,selected是否选中
validate用于表单弹窗 表单校验的 下个版本即将淘汰请使用validateV2
Function
callback表单提交后触发的回调函数
scrollToField用于表单弹窗 滚动到指定的字段
Function
propcolumn里的prop配置
validateV2表单校验--
clearValidate移除该表单项的校验结果
Function
props是个数组,数组里的每一项是column里的prop配置
validateField验证具体的某个字段
Function
props是个数组,数组里的每一项是column里的prop配置

Slot

插槽名说明作用域参数
headerMenu表格头部操作栏插槽-
menu操作栏插槽-
page分页器插槽-
form表单插槽-
prop表格插槽,以Column里的prop做插槽名,例如column: [{prop: 'test'}]则插槽名为#test{ row, $index }
propSearch搜索栏插槽,以Column里的prop拼接Search做插槽名,例如column: [{prop: 'test'}]则插槽名为#testSearch{ row }
propForm表单插槽,以Column里的prop拼接Form做插槽名,例如column: [{prop: 'test'}]则插槽名为#testForm 作用域参数为-
propGroupForm表单分组插槽,以Group里的prop拼接Group做插槽名,例如group: [{prop: 'test'}]则插槽名为#testGroupForm{ _XBoxType?: 'check' | 'create' | 'update' }
propTabForm表单tab插槽,以ViewTabs里的value拼接TabForm做插槽名,例如viewTabs: [{value: 'test'}]则插槽名为#testTabForm{ _XBoxType?: 'check' | 'create' | 'update' }
importHeader导入文件头部插槽-
formHeader表单弹窗头部位置插槽{ _XBoxType?: 'check' | 'create' | 'update' }
formFooter表单弹窗底部位置插槽{ _XBoxType?: 'check' | 'create' | 'update' }