(1)Radio 单选框
基础用法----要使用 Radio 组件,只需要设置v-model绑定变量,选中意味着变量的值为相应 Radio label属性的值,label可以是String、Number或Boolean。
备选项
备选项
禁用状态-----只要在el-radio元素中设置disabled属性即可,它接受一个Boolean,true为禁用。
备选项
备选项
单选框组-----结合el-radio-group元素和子元素el-radio可以实现单选组,在el-radio-group中绑定v-model,在el-radio中设置好label即可,无需再给每一个el-radio绑定变量,另外,还提供了change事件来响应变化,它会传入一个参数value。
备选项
备选项
备选项
按钮样式----只需要把el-radio元素换成el-radio-button元素即可,此外,Element 还提供了size属性。
**带有边框**
备选项1
备选项2
备选项1
备选项2
备选项1
备选项2
备选项1
备选项2
(2)Checkbox 多选框
基础用法----在el-checkbox元素中定义v-model绑定变量,单一的checkbox中,默认绑定变量的值会是Boolean,选中为true。
备选项
备选项1
备选项
多选框组----checkbox-group元素能把多个 checkbox 管理为一组,只需要在 Group 中使用v-model绑定Array类型的变量即可。 el-checkbox 的 label属性是该 checkbox 对应的值,若该标签中无内容,则该属性也充当 checkbox 按钮后的介绍。label与数组中的元素值相对应,如果存在指定的值则为选中状态,否则为不选中。
indeterminate 状态
全选
{{city}}
{{city}}
按钮样式------只需要把el-checkbox元素替换为el-checkbox-button元素即可。此外,Element 还提供了size属性。
{{city}}
{{city}}
{{city}}
{{city}}
(3)Input 输入框
----***Input 为受控组件,它总会显示 Vue 绑定值。
通常情况下,应当处理 input 事件,并更新组件的绑定值(或使用v-model)。否则,输入框内显示的值将不会改变。
不支持 v-model 修饰符。***----
基础用法
可清空-----使用clearable属性即可得到一个可清空的输入框
密码框-----使用show-password属性即可得到一个可切换显示隐藏的密码框
带 icon 的输入框—可以通过 prefix-icon 和 suffix-icon 属性在 input 组件首部和尾部增加显示图标,也可以通过 slot 来放置图标。
属性方式:
slot 方式:
文本域高度可通过 rows 属性控制
拓展:-----resize:none;-------文本域不可拉伸了!!!
复合型输入框-----可通过 slot 来指定在 input 中前置或者后置内容。
Http://
.com
----可通过 size 属性指定输入框的尺寸,除了默认的大小外,还提供了 large、small 和 mini 三种尺寸。----
带输入建议----autocomplete 是一个可带输入建议的输入框组件,fetch-suggestions 是一个返回输入建议的方法属性,如 querySearch(queryString, cb),在该方法中你可以在你的输入建议数据准备好时通过 cb(data) 返回到 autocomplete 组件中。
激活即列出输入建议
输入后匹配输入建议
自定义模板—使用scoped slot自定义输入建议的模板。该 scope 的参数为item,表示当前输入建议对象。
{{ item.value }}
{{ item.address }}
输入长度限制-----maxlength 和 minlength 是原生属性,用来限制输入框的字符长度,其中字符长度是用 Javascript 的字符串长度统计的。对于类型为 text 或 textarea 的输入框,在使用 maxlength 属性限制最大输入长度的同时,可通过设置 show-word-limit 属性来展示字数统计。
(4)InputNumber 计数器
基础用法----要使用它,只需要在el-input-number元素中使用v-model绑定变量即可,变量的初始值即为默认值。
禁用状态—disabled属性接受一个Boolean,设置为true即可禁用整个组件,如果你只需要控制数值在某一范围内,可以设置min属性和max属性,不设置min和max时,最小值为 0。
步数----设置step属性可以控制步长,接受一个Number。
严格步数----step-strictly属性接受一个Boolean。如果这个属性被设置为true,则只能输入步数的倍数。
精度----设置 precision 属性可以控制数值精度,接收一个 Number。
注:precision 的值必须是一个非负整数,并且不能小于 step 的小数位数。
按钮位置----设置 controls-position 属性可以控制按钮位置。
(5)Select 选择器
基础用法----v-model的值为当前被选中的el-option的 value 属性值
有禁用选项-----在el-option中,设定disabled值为 true,即可禁用该选项
**禁用状态**-----为el-select设置disabled属性,则整个选择器不可用
可清空单选----为el-select设置clearable属性,则可将选择器清空。需要注意的是,clearable属性仅适用于单选。
基础多选-----为el-select设置multiple属性即可启用多选,此时v-model的值为当前选中值所组成的数组。默认情况下选中值会以 Tag 的形式展现,你也可以设置collapse-tags属性将它们合并为一段文字。
自定义模板----将自定义的 HTML 模板插入el-option的 slot 中即可。
{{ item.label }}
{{ item.value }}
分组-----使用el-option-group对备选项进行分组,它的label属性为分组名
可搜索-----为el-select添加filterable属性即可启用搜索功能。默认情况下,Select 会找出所有label属性包含输入值的选项。如果希望使用其他的搜索逻辑,可以通过传入一个filter-method来实现。filter-method为一个Function,它会在输入值发生变化时调用,参数为当前输入值。
远程搜索------为了启用远程搜索,需要将filterable和remote设置为true,同时传入一个remote-method。remote-method为一个Function,它会在输入值发生变化时调用,参数为当前输入值。需要注意的是,如果el-option是通过v-for指令渲染出来的,此时需要为el-option添加key属性,且其值需具有唯一性,比如此例中的item.value。
创建条目-----使用allow-create属性即可通过在输入框中输入文字来创建新的条目。注意此时filterable必须为真。本例还使用了default-first-option属性,在该属性打开的情况下,按下回车就可以选中当前选项列表中的第一个选项,无需使用鼠标或键盘方向键进行定位。
注:如果 Select 的绑定值为对象类型,请务必指定 value-key 作为它的唯一性标识。
(6)Cascader 级联选择器—当一个数据集合有清晰的层级结构时,可通过级联选择器逐级查看并选择。
基础用法—只需为 Cascader 的options属性指定选项数组即可渲染出一个级联选择器。通过props.expandTrigger可以定义展开子级菜单的触发方式。
默认 click 触发子菜单
hover 触发子菜单
禁用选项----本例中,options指定的数组中的第一个元素含有disabled: true键值对,因此是禁用的。在默认情况下,Cascader 会检查数据中每一项的disabled字段是否为true,如果你的数据中表示禁用含义的字段名不为disabled,可以通过props.disabled属性来指定(详见下方 API 表格)。当然,value、label和children这三个字段名也可以通过同样的方式指定。
仅显示最后一级------属性show-all-levels定义了是否显示完整的路径,将其赋值为false则仅显示最后一级。
多选-------在开启多选模式后,默认情况下会展示所有已选中的选项的Tag,你可以使用collapse-tags来折叠Tag
默认显示所有Tag
折叠展示Tag
选择任意一级选项------可通过 props.checkStrictly = true 来设置父子节点取消选中关联,从而达到选择任意一级选项的目的。
单选选择任意一级选项
多选选择任意一级选项
动态加载-------通过lazy开启动态加载,并通过lazyload来设置加载数据源的方法。lazyload方法有两个参数,第一个参数node为当前点击的节点,第二个resolve为数据加载完成的回调(必须调用)。为了更准确的显示节点的状态,还可以对节点数据添加是否为叶子节点的标志位 (默认字段为leaf,可通过props.leaf修改),否则会简单的以有无子节点来判断是否为叶子节点。
可搜索-----将filterable赋值为true即可打开搜索功能,默认会匹配节点的label或所有父节点的label(由show-all-levels决定)中包含输入值的选项。你也可以用filter-method自定义搜索逻辑,接受一个函数,第一个参数是节点node,第二个参数是搜索关键词keyword,通过返回布尔值表示是否命中。
单选可搜索
多选可搜索
{{ data.label }}
({{ data.children.length }})
级联面板—和级联选择器一样,通过options来指定选项,也可通过props来设置多选、动态加载等功能。