image-20200915165239029 Eh-UI

组件简介

更新日志

时间/周期

2020年4月-2020年9月

更新内容

基础组件

一、Button 按钮

1.1 使用方法
1.1.1 基础用法

image-20200911160837131

1.2 Attributes
参数说明类型可选值默认值
size尺寸stringmedium / small / mini
type类型stringprimary / success / warning / danger / info / text
plain是否朴素按钮booleanfalse
round是否圆角按钮booleanfalse
circle是否圆形按钮booleanfalse
loading是否加载中状态booleanfalse
disabled是否禁用状态booleanfalse
icon图标类名string
autofocus是否默认聚焦booleanfalse
native-type原生 type 属性stringbutton / submit / resetbutton

二、Radio 单选框

2.1 使用方法
2.1.1 基础用法

image-20200911161303974

2.2 Attributes
参数说明类型可选值默认值
value / v-model绑定值string / number / boolean
labelRadio 的 valuestring / number / boolean
disabled是否禁用booleanfalse
border是否显示边框booleanfalse
sizeRadio 的尺寸,仅在 border 为真时有效stringmedium / small / mini
name原生 name 属性string
2.3 Events
事件名称说明回调参数
change绑定值变化时触发的事件选中的 Radio label 值

三、Checkbox 多选框

 

3.1 使用方法
3.1.1 基础用法

 

image-20200911162207045

3.1.2 禁用状态

image-20200911162423857

3.1.3 多选框组

image-20200911162541187

3.1.4 Indeterminate 状态

image-20200911162646582

3.1.5 可选项目数量的限制

image-20200911162858416

3.2 Attributes
3.2.1 Checkbox
参数说明类型可选值默认值
value / v-model绑定值string / number / boolean
label选中状态的值(只有在checkbox-group或者绑定对象类型为array时有效)string / number / boolean
true-label选中时的值string / number
false-label没有选中时的值string / number
disabled是否禁用booleanfalse
border是否显示边框booleanfalse
sizeCheckbox 的尺寸,仅在 border 为真时有效stringmedium / small / mini
name原生 name 属性string
checked当前是否勾选booleanfalse
indeterminate设置 indeterminate 状态,只负责样式控制booleanfalse
3.2.2 Checkbox-group
参数说明类型可选值默认值
value / v-model绑定值array
size多选框组尺寸,仅对按钮形式的 Checkbox 或带有边框的 Checkbox 有效stringmedium / small / mini
disabled是否禁用booleanfalse
min可被勾选的 checkbox 的最小数量number
max可被勾选的 checkbox 的最大数量number
text-color按钮形式的 Checkbox 激活时的文本颜色string#ffffff
fill按钮形式的 Checkbox 激活时的填充色和边框色string#409EFF
3.2.3 Checkbox-button
参数说明类型可选值默认值
label选中状态的值(只有在checkbox-group或者绑定对象类型为array时有效)string / number / boolean
true-label选中时的值string / number
false-label没有选中时的值string / number
disabled是否禁用booleanfalse
name原生 name 属性string
checked当前是否勾选booleanfalse
3.3 Events
3.3.1 Checkbox
事件名称说明回调参数
change当绑定值变化时触发的事件更新后的值
3.3.2 Checkbox-group
事件名称说明回调参数
change当绑定值变化时触发的事件更新后的值

 

四、Input 输入框

4.1 使用方法
4.1.1 基础用法

image-20200911163248305

4.1.2 禁用状态

image-20200911163650046

4.1.3 可清空

image-20200911163917896

4.1.4 密码框

image-20200911164026916

4.1.5 文本域

image-20200911164138408

4.1.6 带 icon 的输入框

image-20200914140323493

4.1.7 可自适应文本高度的文本域

image-20200914140552914

 

4.2 Attributes
4.2.1 Input Attribute
参数说明类型可选值默认值
type类型stringtext,textarea 和其他 原生 input 的 type 值text
value / v-model绑定值string / number
maxlength原生属性,最大输入长度number
minlength原生属性,最小输入长度number
show-word-limit是否显示输入字数统计,只在 type = "text"type = "textarea" 时有效booleanfalse
placeholder输入框占位文本string
clearable是否可清空booleanfalse
show-password是否显示切换密码图标booleanfalse
disabled禁用booleanfalse
size输入框尺寸,只在 type!="textarea" 时有效stringmedium / small / mini
prefix-icon输入框头部图标string
suffix-icon输入框尾部图标string
rows输入框行数,只对 type="textarea" 有效number2
autosize自适应内容高度,只对 type="textarea" 有效,可传入对象,如,{ minRows: 2, maxRows: 6 }boolean / objectfalse
autocomplete原生属性,自动补全stringon, offoff
auto-complete下个主版本弃用stringon, offoff
name原生属性string
readonly原生属性,是否只读booleanfalse
max原生属性,设置最大值
min原生属性,设置最小值
step原生属性,设置输入字段的合法数字间隔
resize控制是否能被用户缩放stringnone, both, horizontal, vertical
autofocus原生属性,自动获取焦点booleantrue, falsefalse
form原生属性string
label输入框关联的label文字string
tabindex输入框的tabindexstring--
validate-event输入时是否触发表单的校验boolean-true
4.2.2 Autocomplete
参数说明类型可选值默认值
placeholder输入框占位文本string
disabled禁用booleanfalse
value-key输入建议对象中用于显示的键名stringvalue
value必填值,输入绑定值string
debounce获取输入建议的去抖延时number300
placement菜单弹出位置stringtop / top-start / top-end / bottom / bottom-start / bottom-endbottom-start
fetch-suggestions返回输入建议的方法,仅当你的输入建议数据 resolve 时,通过调用 callback(data:[]) 来返回它Function(queryString, callback)
popper-classAutocomplete 下拉列表的类名string
trigger-on-focus是否在输入框 focus 时显示建议列表booleantrue
name原生属性string
select-when-unmatched在输入没有任何匹配建议的情况下,按下回车是否触发 select 事件booleanfalse
label输入框关联的label文字string
prefix-icon输入框头部图标string
suffix-icon输入框尾部图标string
hide-loading是否隐藏远程加载时的加载图标booleanfalse
popper-append-to-body是否将下拉列表插入至 body 元素。在下拉列表的定位出现问题时,可将该属性设置为 falseboolean-true
highlight-first-item是否默认突出显示远程搜索建议中的第一项booleanfalse
4.3 Slots
4.3.1 Input
name说明
prefix输入框头部内容,只对 type="text" 有效
suffix输入框尾部内容,只对 type="text" 有效
prepend输入框前置内容,只对 type="text" 有效
append输入框后置内容,只对 type="text" 有效
4.3.2 Autocomplete
name说明
prefix输入框头部内容
suffix输入框尾部内容
prepend输入框前置内容
append输入框后置内容
4.3.3 Autocomplete Scoped
name说明
自定义输入建议,参数为 { item }
4.4 Events
4.4.1 Input
事件名称说明回调参数
blur在 Input 失去焦点时触发(event: Event)
focus在 Input 获得焦点时触发(event: Event)
change仅在输入框失去焦点或用户按下回车时触发(value: string | number)
input在 Input 值改变时触发(value: string | number)
clear在点击由 clearable 属性生成的清空按钮时触发
4.5 Methods
4.5.1 Input
方法名说明参数
focus使 input 获取焦点
blur使 input 失去焦点
select选中 input 中的文字

 

五、级联选择器

5.1 使用方法
5.1.1 基础用法

image-20200911164609031

5.1.2 禁用选项

image-20200911164907400

5.1.3 可清空

image-20200911170037635

5.1.4仅显示最后一级
5.1.5 多选
5.1.6 选择任意一级选项
5.1.7动态加载
5.1.8可搜索
5.1.9 自定义节点内容
5.1.10级联面板
5.2 Attributes
5.2.1 Cascader
参数说明类型可选值默认值
value / v-model选中项绑定值-
options可选项数据源,键名可通过 Props 属性配置array
props配置选项,具体见下表object
size尺寸stringmedium / small / mini
placeholder输入框占位文本string请选择
disabled是否禁用booleanfalse
clearable是否支持清空选项booleanfalse
show-all-levels输入框中是否显示选中值的完整路径booleantrue
collapse-tags多选模式下是否折叠Tagboolean-false
separator选项分隔符string斜杠' / '
filterable是否可搜索选项boolean
filter-method自定义搜索逻辑,第一个参数是节点node,第二个参数是搜索关键词keyword,通过返回布尔值表示是否命中function(node, keyword)--
debounce搜索关键词输入的去抖延迟,毫秒number300
before-filter筛选之前的钩子,参数为输入的值,若返回 false 或者返回 Promise 且被 reject,则停止筛选function(value)
popper-class自定义浮层类名string
5.2.2 CascaderPanel
参数说明类型可选值默认值
value / v-model选中项绑定值-
options可选项数据源,键名可通过 Props 属性配置array
props配置选项,具体见下表object
5.3 Events
5.3.1 Cascader
事件名称说明回调参数
change当选中节点变化时触发选中节点的值
expand-change当展开节点发生变化时触发各父级选项值组成的数组
blur当失去焦点时触发(event: Event)
focus当获得焦点时触发(event: Event)
visible-change下拉框出现/隐藏时触发出现则为 true,隐藏则为 false
remove-tag在多选模式下,移除Tag时触发移除的Tag对应的节点的值
5.3.2 CascaderPanel
事件名称说明回调参数
change当选中节点变化时触发选中节点的值
expand-change当展开节点发生变化时触发各父级选项值组成的数组
5.4 Methods
5.4.1 Cascader
方法名说明参数
getCheckedNodes获取选中的节点(leafOnly) 是否只是叶子节点,默认值为 false
5.4.2 CascaderPanel
方法名说明参数
getCheckedNodes获取选中的节点数组(leafOnly) 是否只是叶子节点,默认值为 false
clearCheckedNodes清空选中的节点-
5.5 Slots
5.5.1 Cascader
名称说明
-自定义备选项的节点内容,参数为 { node, data },分别为当前节点的 Node 对象和数据
empty无匹配选项时的内容
5.5.2 CascaderPanel
名称说明
-自定义备选项的节点内容,参数为 { node, data },分别为当前节点的 Node 对象和数据
5.6 Props
参数说明类型可选值默认值
expandTrigger次级菜单的展开方式stringclick / hover'click'
multiple是否多选boolean-false
checkStrictly是否严格的遵守父子节点不互相关联boolean-false
emitPath在选中节点改变时,是否返回由该节点所在的各级菜单的值所组成的数组,若设置 false,则只返回该节点的值boolean-true
lazy是否动态加载子节点,需与 lazyLoad 方法结合使用boolean-false
lazyLoad加载动态数据的方法,仅在 lazy 为 true 时有效function(node, resolve),node为当前点击的节点,resolve为数据加载完成的回调(必须调用)--
value指定选项的值为选项对象的某个属性值string'value'
label指定选项标签为选项对象的某个属性值string'label'
children指定选项的子选项为选项对象的某个属性值string'children'
disabled指定选项的禁用为选项对象的某个属性值string'disabled'
leaf指定选项的叶子节点的标志位为选项对象的某个属性值string'leaf'

六、时间选择器

6.1 使用方法
6.1.1 固定时间点
6.1.2 任意时间点
6.1.3 固定时间范围
6.1.4 任意时间范围
6.2 Attributes
参数说明类型可选值默认值
value / v-model绑定值date(TimePicker) / string(TimeSelect)
readonly完全只读booleanfalse
disabled禁用booleanfalse
editable文本框可输入booleantrue
clearable是否显示清除按钮booleantrue
size输入框尺寸stringmedium / small / mini
placeholder非范围选择时的占位内容string
start-placeholder范围选择时开始日期的占位内容string
end-placeholder范围选择时开始日期的占位内容string
is-range是否为时间范围选择,仅对<el-time-picker>有效booleanfalse
arrow-control是否使用箭头进行时间选择,仅对<el-time-picker>有效booleanfalse
align对齐方式stringleft / center / rightleft
popper-classTimePicker 下拉框的类名string
picker-options当前时间日期选择器特有的选项参考下表object{}
range-separator选择范围时的分隔符string-'-'
value-format可选,仅TimePicker时可用,绑定值的格式。不指定则绑定值为 Date 对象string日期格式
default-value可选,选择器打开时默认显示的时间Date(TimePicker) / string(TimeSelect)可被new Date()解析(TimePicker) / 可选值(TimeSelect)
name原生属性string
prefix-icon自定义头部图标的类名stringel-icon-time
clear-icon自定义清空图标的类名stringel-icon-circle-close
6.3 Time Select Options
参数说明类型可选值默认值
start开始时间string09:00
end结束时间string18:00
step间隔时间string00:30
minTime最小时间,小于该时间的时间段将被禁用string00:00
maxTime最大时间,大于该时间的时间段将被禁用string
6.4 Time Picker Options
参数说明类型可选值默认值
selectableRange可选时间段,例如'18:30:00 - 20:30:00'或者传入数组['09:30:00 - 12:00:00', '14:30:00 - 18:30:00']string / array
format时间格式化(TimePicker)string小时:HH,分:mm,秒:ss,AM/PM A'HH:mm:ss'
6.5 Events
事件名说明参数
change用户确认选定的值时触发组件绑定值
blur当 input 失去焦点时触发组件实例
focus当 input 获得焦点时触发组件实例

6.6 Methods

方法名说明参数
focus使 input 获取焦点-

七、日期选择器

7.1 使用方法
7.1.1 选择日
7.1.2 其他日期单位
7.1.3 选择日期范围
7.1.4 选择月份范围
7.1.5 日期格式
格式含义备注举例
yyyy 2017
M不补01
MM 01
W仅周选择器的 format 可用;不补01
WW仅周选择器的 format 可用01
d不补02
dd 02
H小时24小时制;不补03
HH小时24小时制03
h小时12小时制,须和 Aa 使用;不补03
hh小时12小时制,须和 Aa 使用03
m分钟不补04
mm分钟 04
s不补05
ss 05
AAM/PMformat 可用,大写AM
aam/pmformat 可用,小写am
timestampJS时间戳value-format 可用;组件绑定值为number类型1483326245000
[MM]不需要格式化字符使用方括号标识不需要格式化的字符 (如 [A] [MM])MM
7.1.6 默认显示日期
7.2 Attributes
参数说明类型可选值默认值
value / v-model绑定值date(DatePicker) / array(DateRangePicker)
readonly完全只读booleanfalse
disabled禁用booleanfalse
editable文本框可输入booleantrue
clearable是否显示清除按钮booleantrue
size输入框尺寸stringlarge, small, mini
placeholder非范围选择时的占位内容string
start-placeholder范围选择时开始日期的占位内容string
end-placeholder范围选择时结束日期的占位内容string
type显示类型stringyear/month/date/dates/ week/datetime/datetimerange/ daterange/monthrangedate
format显示在输入框中的格式string日期格式yyyy-MM-dd
align对齐方式stringleft, center, rightleft
popper-classDatePicker 下拉框的类名string
picker-options当前时间日期选择器特有的选项参考下表object{}
range-separator选择范围时的分隔符string'-'
default-value可选,选择器打开时默认显示的时间Date可被new Date()解析
default-time范围选择时选中日期所使用的当日内具体时刻string[]数组,长度为 2,每项值为字符串,形如12:00:00,第一项指定开始日期的时刻,第二项指定结束日期的时刻,不指定会使用时刻 00:00:00
value-format可选,绑定值的格式。不指定则绑定值为 Date 对象string日期格式
name原生属性string
unlink-panels在范围选择器里取消两个日期面板之间的联动booleanfalse
prefix-icon自定义头部图标的类名stringel-icon-date
clear-icon自定义清空图标的类名stringel-icon-circle-close
validate-event输入时是否触发表单的校验boolean-true
7.3 Picker Options
参数说明类型可选值默认值
shortcuts设置快捷选项,需要传入 { text, onClick } 对象用法参考 demo 或下表Object[]
disabledDate设置禁用状态,参数为当前日期,要求返回 BooleanFunction
cellClassName设置日期的 classNameFunction(Date)
firstDayOfWeek周起始日Number1 到 77
onPick选中日期后会执行的回调,只有当 daterangedatetimerange 才生效Function({ maxDate, minDate })
7.4 Shortcuts
参数说明类型可选值默认值
text标题文本string
onClick选中后的回调函数,参数是 vm,可通过触发 'pick' 事件设置选择器的值。例如 vm.$emit('pick', new Date())function
7.5 Events
事件名称说明回调参数
change用户确认选定的值时触发组件绑定值。格式与绑定值一致,可受 value-format 控制
blur当 input 失去焦点时触发组件实例
focus当 input 获得焦点时触发组件实例
7.6 Methods
方法名说明参数
focus使 input 获取焦点

八、日期时间选择器

8.1 使用方法
8.1.1 日期和时间点
8.1.2 日期和时间范围
8.1.3 默认的起始与结束时刻
8.2 Attributes
参数说明类型可选值默认值
value / v-model绑定值date(DateTimePicker) / array(DateTimeRangePicker)
readonly完全只读booleanfalse
disabled禁用booleanfalse
editable文本框可输入booleantrue
clearable是否显示清除按钮booleantrue
size输入框尺寸stringlarge, small, mini
placeholder非范围选择时的占位内容string
start-placeholder范围选择时开始日期的占位内容string
end-placeholder范围选择时结束日期的占位内容string
time-arrow-control是否使用箭头进行时间选择booleanfalse
type显示类型stringyear/month/date/week/ datetime/datetimerange/daterangedate
format显示在输入框中的格式string日期格式yyyy-MM-dd HH:mm:ss
align对齐方式stringleft, center, rightleft
popper-classDateTimePicker 下拉框的类名string
picker-options当前时间日期选择器特有的选项参考下表object{}
range-separator选择范围时的分隔符string-'-'
default-value可选,选择器打开时默认显示的时间Date可被new Date()解析
default-time选中日期后的默认具体时刻非范围选择时:string / 范围选择时:string[]非范围选择时:形如12:00:00的字符串;范围选择时:数组,长度为 2,每项值为字符串,形如12:00:00,第一项指定开始日期的时刻,第二项指定结束日期的时刻。不指定会使用时刻 00:00:00
value-format可选,绑定值的格式。不指定则绑定值为 Date 对象string日期格式
name原生属性string
unlink-panels在范围选择器里取消两个日期面板之间的联动booleanfalse
prefix-icon自定义头部图标的类名stringel-icon-date
clear-icon自定义清空图标的类名string 
8.3 Picker Options
参数说明类型可选值默认值
shortcuts设置快捷选项,需要传入 { text, onClick } 对象用法参考 demo 或下表Object[]
disabledDate设置禁用状态,参数为当前日期,要求返回 BooleanFunction
cellClassName设置日期的 classNameFunction(Date)
firstDayOfWeek周起始日Number1 到 77
8.4 Shortcuts
参数说明类型可选值默认值
text标题文本string
onClick选中后的回调函数,参数是 vm,可通过触发 'pick' 事件设置选择器的值。例如 vm.$emit('pick', new Date())function
8.5 Events
Event NameDescriptionParameters
change用户确认选定的值时触发组件绑定值。格式与绑定值一致,可受 value-format 控制
blur当 input 失去焦点时触发组件实例
focus当 input 获得焦点时触发组件实例
8.6 Methods
方法名说明参数
focus使 input 获取焦点
8.7 Slots
Name说明
range-separator自定义分隔符

九、Form 表单

9.1 使用方法
9.1.1 典型表单
9.1.2 行内表单
9.1.3 对齐方式
9.1.4 表单验证
9.1.5 自定义校验规则
9.1.6 动态增减表单项
9.1.7 数字类型验证
9.1.8 表单内组件尺寸控制
9.2 Attributes
9.2.1 Form
参数说明类型可选值默认值
model表单数据对象object
rules表单验证规则object
inline行内表单模式booleanfalse
label-position表单域标签的位置,如果值为 left 或者 right 时,则需要设置 label-widthstringright/left/topright
label-width表单域标签的宽度,例如 '50px'。作为 Form 直接子元素的 form-item 会继承该值。支持 autostring
label-suffix表单域标签的后缀string
hide-required-asterisk是否显示必填字段的标签旁边的红色星号booleanfalse
show-message是否显示校验错误信息booleantrue
inline-message是否以行内形式展示校验信息booleanfalse
status-icon是否在输入框中显示校验结果反馈图标booleanfalse
validate-on-rule-change是否在 rules 属性改变后立即触发一次验证booleantrue
size用于控制该表单内组件的尺寸stringmedium / small / mini
disabled是否禁用该表单内的所有组件。若设置为 true,则表单内组件上的 disabled 属性不再生效booleanfalse
9.2.2Form-Item
参数说明类型可选值默认值
prop表单域 model 字段,在使用 validate、resetFields 方法的情况下,该属性是必填的string传入 Form 组件的 model 中的字段
label标签文本string
label-width表单域标签的的宽度,例如 '50px'。支持 autostring
required是否必填,如不设置,则会根据校验规则自动生成booleanfalse
rules表单验证规则object
error表单域验证错误信息, 设置该值会使表单验证状态变为error,并显示该错误信息string
show-message是否显示校验错误信息booleantrue
inline-message以行内形式展示校验信息booleanfalse
size用于控制该表单域下组件的尺寸stringmedium / small / mini-
9.3 Methods
9.3.1 Form
方法名说明参数
validate对整个表单进行校验的方法,参数为一个回调函数。该回调函数会在校验结束后被调用,并传入两个参数:是否校验成功和未通过校验的字段。若不传入回调函数,则会返回一个 promiseFunction(callback: Function(boolean, object))
validateField对部分表单字段进行校验的方法Function(props: array | string, callback: Function(errorMessage: string))
resetFields对整个表单进行重置,将所有字段值重置为初始值并移除校验结果
clearValidate移除表单项的校验结果。传入待移除的表单项的 prop 属性或者 prop 组成的数组,如不传则移除整个表单的校验结果Function(props: array | string)
9.3.2 Form-Item
方法名说明参数
resetField对该表单项进行重置,将其值重置为初始值并移除校验结果-
clearValidate移除该表单项的校验结果-
9.4 Events
9.4.1 Form Events
事件名称说明回调参数
validate任一表单项被校验后触发被校验的表单项 prop 值,校验是否通过,错误消息(如果存在)
9.5 Slot
9.5.1 Form-Item
name说明
Form Item 的内容
label标签文本的内容
9.5.2 Form-Item Scoped
name说明
error自定义表单校验信息的显示方式,参数为 { error }

十、EhGrid

10.1 调用方式
10.2 传入属性
10.2.1 Id

示例:

10.2.2 DataSource

示例:

10.2.3 Grid

默认配置 / 示例:

10.2.4 Options

默认配置 / 示例:

10.2.5 Table-collapse
10.3 传入方法
10.3.1 Selection-change

示例:

10.3.2 Cell-click

示例:

10.3.3 Data-change

示例:

10.3.4 Expand-row-click

示例:

10.4 实例方法
10.4.1 DoSearch[bindGrid]

示例:

10.4.2 OpenExport
10.4.3 ClearSelection

示例:

10.5 使用插槽
#####10.5.1 Toolbar

示例:


十一、EhLayout

11.1 调用方式
11.2 传入属性
11.2.1 Left-width
11.2.2 Right-width
11.3 使用插槽

示例图

top
left
center
right
bottom

 

center(默认插槽):将内容放置在整个布局组件中间,原则上必填 (有默认 15px 边距),可直接当做子元素写入组件标签内。

top:将内容放置在整个布局组件顶部,没有则不显示

bottom:将内容放置在整个布局组件底部,没有则不显示

left:将内容放置在整个布局组件中间,没有则 center 向左取代 left 的位置

right:将内容放置在整个布局组件中间,没有则 center 向右取代 right 的位置

示例:


十二、EhSearchBack

12.1 调用方式
12.2 传入属性
12.2.1 V-model

示例:

12.2.2searchField

示例:

12.2.3 LabelField

示例:

12.2.4 DefaultLabel

示例:

12.2.5 SearchSelect

示例:

12.2.6 GridOptions

示例:

12.2.7 Button

默认 / 示例:

12.2.8 ShowDialogLeft

默认 / 示例 见插槽。

12.2.9 InputAttributes

默认 / 示例:

12.2.10 DialogAttributes

示例:

12.2.11 OpenSearch

示例:

12.2.12 FilterForm

示例:

12.3 使用插槽
12.3.1 FilterBar

示例:

12.3.2 Dialog-left
12.4传入方法
12.4.1 Input

示例:

12.4.2 SelectedRows

示例:

12.5 实例方法
12.5.1 SearchGrid

十三、EhTabs

13.1 调用方式
13.2 传入属性
13.2.1 Tabs

示例:

13.2.2 V-mode

示例:

13.3 传入方法
13.3.1 After-close

示例:

13.4 使用插槽
13.4.1 自定义插槽名

示例:

13.5 实例方法
13.5.1 RemoveTab

示例:

 

十四、EhSelect

14.1 调用方式
14.2 传入属性
14.2.1 V-model
14.2.2 KeyName valueName

示例:

14.2.3 SelectOptions

示例:

14.2.4 SelectRequest

示例:

14.2.5 RelatedSelect
14.2.6 RelatedRequest

示例:

14.2.7 FocusLoad
14.2.8 Width
14.2.9 Label
14.2.10 SelectAttributes

示例:

14.3 传入方法
14.3.1 ChangeOption

 

十五、Tabs

15.1 使用方法
15.1.1 基础用法
15.1.2 选项卡样式
15.1.3 卡片化
15.1.4 位置
15.1.5 自定义标签页
15.1.6 动态增减标签页
15.1.7 自定义增加标签页触发器
15.2 Attributes
15.2.1 Tabs
参数说明类型可选值默认值
value / v-model绑定值,选中选项卡的 namestring第一个选项卡的 name
type风格类型stringcard/border-card
closable标签是否可关闭booleanfalse
addable标签是否可增加booleanfalse
editable标签是否同时可增加和关闭booleanfalse
tab-position选项卡所在位置stringtop/right/bottom/lefttop
stretch标签的宽度是否自撑开boolean-false
before-leave切换标签之前的钩子,若返回 false 或者返回 Promise 且被 reject,则阻止切换。Function(activeName, oldActiveName)
15.2.2 Tab-pane
参数说明类型可选值默认值
label选项卡标题string
disabled是否禁用booleanfalse
name与选项卡绑定值 value 对应的标识符,表示选项卡别名string该选项卡在选项卡列表中的顺序值,如第一个选项卡则为'1'
closable标签是否可关闭booleanfalse
lazy标签是否延迟渲染booleanfalse
15.3 Tabs Events
事件名称说明回调参数
tab-clicktab 被选中时触发被选中的标签 tab 实例
tab-remove点击 tab 移除按钮后触发被删除的标签的 name
tab-add点击 tabs 的新增按钮后触发
edit点击 tabs 的新增按钮或 tab 被关闭后触发(targetName, action)

十六、树形控件

16.1 使用方法
16.1.1 基础用法
16.1.2 可选择
16.1.3 懒加载自定义叶子节点
16.1.4 默认展开和默认选中
16.1.5 禁用状态
16.1.6 树节点的选择
16.1.7 自定义节点内容
16.1.8 节点过滤
16.1.9 手风琴模式
16.1.10 可拖拽节点
16.2 Attributes
参数说明类型可选值默认值
data展示数据array
empty-text内容为空的时候展示的文本String
node-key每个树节点用来作为唯一标识的属性,整棵树应该是唯一的String
props配置选项,具体看下表object
render-after-expand是否在第一次展开某个树节点后才渲染其子节点booleantrue
load加载子树数据的方法,仅当 lazy 属性为true 时生效function(node, resolve)
render-content树节点的内容区的渲染 FunctionFunction(h, { node, data, store }
highlight-current是否高亮当前选中节点,默认值是 false。booleanfalse
default-expand-all是否默认展开所有节点booleanfalse
expand-on-click-node是否在点击节点的时候展开或者收缩节点, 默认值为 true,如果为 false,则只有点箭头图标的时候才会展开或者收缩节点。booleantrue
check-on-click-node是否在点击节点的时候选中节点,默认值为 false,即只有在点击复选框时才会选中节点。booleanfalse
auto-expand-parent展开子节点的时候是否自动展开父节点booleantrue
default-expanded-keys默认展开的节点的 key 的数组array
show-checkbox节点是否可被选择booleanfalse
check-strictly在显示复选框的情况下,是否严格的遵循父子不互相关联的做法,默认为 falsebooleanfalse
default-checked-keys默认勾选的节点的 key 的数组array
current-node-key当前选中的节点string, number
filter-node-method对树节点进行筛选时执行的方法,返回 true 表示这个节点可以显示,返回 false 则表示这个节点会被隐藏Function(value, data, node)
accordion是否每次只打开一个同级树节点展开booleanfalse
indent相邻级节点间的水平缩进,单位为像素number16
icon-class自定义树节点的图标string--
lazy是否懒加载子节点,需与 load 方法结合使用booleanfalse
draggable是否开启拖拽节点功能booleanfalse
allow-drag判断节点能否被拖拽Function(node)
allow-drop拖拽时判定目标节点能否被放置。type 参数有三种情况:'prev'、'inner' 和 'next',分别表示放置在目标节点前、插入至目标节点和放置在目标节点后Function(draggingNode, dropNode, type)
16.3 Props
参数说明类型可选值默认值
label指定节点标签为节点对象的某个属性值string, function(data, node)
children指定子树为节点对象的某个属性值string
disabled指定节点选择框是否禁用为节点对象的某个属性值boolean, function(data, node)
isLeaf指定节点是否为叶子节点,仅在指定了 lazy 属性的情况下生效boolean, function(data, node)
16.4 Methods

Tree 内部使用了 Node 类型的对象来包装用户传入的数据,用来保存目前节点的状态。 Tree 拥有如下方法:

方法名说明参数
filter对树节点进行筛选操作接收一个任意类型的参数,该参数会在 filter-node-method 中作为第一个参数
updateKeyChildren通过 keys 设置节点子元素,使用此方法必须设置 node-key 属性(key, data) 接收两个参数,1. 节点 key 2. 节点数据的数组
getCheckedNodes若节点可被选择(即 show-checkboxtrue),则返回目前被选中的节点所组成的数组(leafOnly, includeHalfChecked) 接收两个 boolean 类型的参数,1. 是否只是叶子节点,默认值为 false 2. 是否包含半选节点,默认值为 false
setCheckedNodes设置目前勾选的节点,使用此方法必须设置 node-key 属性(nodes) 接收勾选节点数据的数组
getCheckedKeys若节点可被选择(即 show-checkboxtrue),则返回目前被选中的节点的 key 所组成的数组(leafOnly) 接收一个 boolean 类型的参数,若为 true 则仅返回被选中的叶子节点的 keys,默认值为 false
setCheckedKeys通过 keys 设置目前勾选的节点,使用此方法必须设置 node-key 属性(keys, leafOnly) 接收两个参数,1. 勾选节点的 key 的数组 2. boolean 类型的参数,若为 true 则仅设置叶子节点的选中状态,默认值为 false
setChecked通过 key / data 设置某个节点的勾选状态,使用此方法必须设置 node-key 属性(key/data, checked, deep) 接收三个参数,1. 勾选节点的 key 或者 data 2. boolean 类型,节点是否选中 3. boolean 类型,是否设置子节点 ,默认为 false
getHalfCheckedNodes若节点可被选择(即 show-checkboxtrue),则返回目前半选中的节点所组成的数组-
getHalfCheckedKeys若节点可被选择(即 show-checkboxtrue),则返回目前半选中的节点的 key 所组成的数组-
getCurrentKey获取当前被选中节点的 key,使用此方法必须设置 node-key 属性,若没有节点被选中则返回 null
getCurrentNode获取当前被选中节点的 data,若没有节点被选中则返回 null
setCurrentKey通过 key 设置某个节点的当前选中状态,使用此方法必须设置 node-key 属性(key) 待被选节点的 key,若为 null 则取消当前高亮的节点
setCurrentNode通过 node 设置某个节点的当前选中状态,使用此方法必须设置 node-key 属性(node) 待被选节点的 node
getNode根据 data 或者 key 拿到 Tree 组件中的 node(data) 要获得 node 的 key 或者 data
remove删除 Tree 中的一个节点,使用此方法必须设置 node-key 属性(data) 要删除的节点的 data 或者 node
append为 Tree 中的一个节点追加一个子节点(data, parentNode) 接收两个参数,1. 要追加的子节点的 data 2. 子节点的 parent 的 data、key 或者 node
insertBefore为 Tree 的一个节点的前面增加一个节点(data, refNode) 接收两个参数,1. 要增加的节点的 data 2. 要增加的节点的后一个节点的 data、key 或者 node
insertAfter为 Tree 的一个节点的后面增加一个节点(data, refNode) 接收两个参数,1. 要增加的节点的 data 2. 要增加的节点的前一个节点的 data、key 或者 node
16.5 Events
事件名称说明回调参数
node-click节点被点击时的回调共三个参数,依次为:传递给 data 属性的数组中该节点所对应的对象、节点对应的 Node、节点组件本身。
node-contextmenu当某一节点被鼠标右键点击时会触发该事件共四个参数,依次为:event、传递给 data 属性的数组中该节点所对应的对象、节点对应的 Node、节点组件本身。
check-change节点选中状态发生变化时的回调共三个参数,依次为:传递给 data 属性的数组中该节点所对应的对象、节点本身是否被选中、节点的子树中是否有被选中的节点
check当复选框被点击的时候触发共两个参数,依次为:传递给 data 属性的数组中该节点所对应的对象、树目前的选中状态对象,包含 checkedNodes、checkedKeys、halfCheckedNodes、halfCheckedKeys 四个属性
current-change当前选中节点变化时触发的事件共两个参数,依次为:当前节点的数据,当前节点的 Node 对象
node-expand节点被展开时触发的事件共三个参数,依次为:传递给 data 属性的数组中该节点所对应的对象、节点对应的 Node、节点组件本身
node-collapse节点被关闭时触发的事件共三个参数,依次为:传递给 data 属性的数组中该节点所对应的对象、节点对应的 Node、节点组件本身
node-drag-start节点开始拖拽时触发的事件共两个参数,依次为:被拖拽节点对应的 Node、event
node-drag-enter拖拽进入其他节点时触发的事件共三个参数,依次为:被拖拽节点对应的 Node、所进入节点对应的 Node、event
node-drag-leave拖拽离开某个节点时触发的事件共三个参数,依次为:被拖拽节点对应的 Node、所离开节点对应的 Node、event
node-drag-over在拖拽节点时触发的事件(类似浏览器的 mouseover 事件)共三个参数,依次为:被拖拽节点对应的 Node、当前进入节点对应的 Node、event
node-drag-end拖拽结束时(可能未成功)触发的事件共四个参数,依次为:被拖拽节点对应的 Node、结束拖拽时最后进入的节点(可能为空)、被拖拽节点的放置位置(before、after、inner)、event
node-drop拖拽成功完成时触发的事件共四个参数,依次为:被拖拽节点对应的 Node、结束拖拽时最后进入的节点、被拖拽节点的放置位置(before、after、inner)、event
16.6 Scoped Slot
name说明
自定义树节点的内容,参数为 { node, data }

十七、上传

17.1 使用方法
17.1.1 点击上传
17.1.2 用户头像上传
17.1.3 照片墙
17.1.4 文件缩略图
17.1.5 图片列表缩略图
17.1.6 上传文件列表控制
17.1.7 拖拽上传
17.1.8 手动上传
17.2 Attribute
参数说明类型可选值默认值
action必选参数,上传的地址string
headers设置上传的请求头部object
multiple是否支持多选文件boolean
data上传时附带的额外参数object
name上传的文件字段名stringfile
with-credentials支持发送 cookie 凭证信息booleanfalse
show-file-list是否显示已上传文件列表booleantrue
drag是否启用拖拽上传booleanfalse
accept接受上传的文件类型(thumbnail-mode 模式下此参数无效)string
on-preview点击文件列表中已上传的文件时的钩子function(file)
on-remove文件列表移除文件时的钩子function(file, fileList)
on-success文件上传成功时的钩子function(response, file, fileList)
on-error文件上传失败时的钩子function(err, file, fileList)
on-progress文件上传时的钩子function(event, file, fileList)
on-change文件状态改变时的钩子,添加文件、上传成功和上传失败时都会被调用function(file, fileList)
before-upload上传文件之前的钩子,参数为上传的文件,若返回 false 或者返回 Promise 且被 reject,则停止上传。function(file)
before-remove删除文件之前的钩子,参数为上传的文件和文件列表,若返回 false 或者返回 Promise 且被 reject,则停止删除。function(file, fileList)
list-type文件列表的类型stringtext/picture/picture-cardtext
auto-upload是否在选取文件后立即进行上传booleantrue
file-list上传的文件列表, 例如: [{name: 'food.jpg', url: 'https://xxx.cdn.com/xxx.jpg'}]array[]
http-request覆盖默认的上传行为,可以自定义上传的实现function
disabled是否禁用booleanfalse
limit最大允许上传个数number
on-exceed文件超出个数限制时的钩子function(files, fileList)-
17.3 Slot
name说明
trigger触发文件选择框的内容
tip提示说明文字
17.4 Methods
方法名说明参数
clearFiles清空已上传的文件列表(该方法不支持在 before-upload 中调用)
abort取消上传请求( file: fileList 中的 file 对象 )
submit手动上传文件列表

十八、提示

18.1 使用方法
18.1.1 基本用法

image-20200915155913989

18.1.2 主题

image-20200915160236533

18.1.3 自定义关闭按钮

image-20200915160353753

18.1.4 带有 icon

image-20200915160510372

18.1.5 文字居中

image-20200915160624646

18.2 Attributes
参数说明类型可选值默认值
title标题string
type主题stringsuccess/warning/info/errorinfo
description辅助性文字。也可通过默认 slot 传入string
closable是否可关闭booleantrue
center文字是否居中booleantrue
close-text关闭按钮自定义文本string
show-icon是否显示图标booleanfalse
effect选择提供的主题stringlight/darklight
18.3 Slot
NameDescription
描述
title标题的内容
18.4 Events
事件名称说明回调参数
close关闭alert时触发的事件

十九、卡片

19.1 使用方法
19.1.1 基础用法
19.1.2 简单卡片
19.1.3 卡片阴影
19.2 Attributes
参数说明类型可选值默认值
header设置 header,也可以通过 slot#header 传入 DOMstring
body-style设置 body 的样式object{ padding: '20px' }
shadow设置阴影显示时机stringalways / hover / neveralways

业务组件

一、物料编码

二、工作单元

三、工艺路线

四、工作中心

五、工序

六、设备

 


 

其他组件