Element-ui学习笔记3--Form表单（一）

Radio单选框

要使用 Radio 组件，只需要设置v-model绑定变量，选中意味着变量的值为相应 Radio label属性的值，label可以是String、Number或Boolean。

<template>

　　 <el-radio v-model="radio" label="1">备选项</el-radio>

　　 <el-radio v-model="radio" label="2">备选项</el-radio>

</template>

<script>

　　 export default { data () { return { radio: '1' }; } }

</script>

el-radio-group的使用，可以只在父级绑定一个v-model

子元素el-radio只需要设置label值

按钮样式的单选框

只需要把el-radio元素换成el-radio-button元素即可，此外，Element 还提供了size属性，同button的默认，medium,small,mini

 

<el-radio v-model="radio1" label="1" border>备选项1</el-radio>

加上border属性可以设置带有边框的单选框

 

Radio Attributes

参数	说明	类型	可选值	默认值
value / v-model	绑定值	string / number / boolean	—	—
label	Radio 的 value	string / number / boolean	—	—
disabled	是否禁用	boolean	—	false
border	是否显示边框	boolean	—	false
size	Radio 的尺寸，仅在 border 为真时有效	string	medium / small / mini	—
name	原生 name 属性	string	—	—

 

 

 

 

 

 

 

 

Radio Events

事件名称	说明	回调参数
change	绑定值变化时触发的事件	选中的 Radio label 值

 

 

 

Radio-group Attributes

参数	说明	类型	可选值	默认值
value / v-model	绑定值	string / number / boolean	—	—
size	单选框组尺寸，仅对按钮形式的 Radio 或带有边框的 Radio 有效	string	medium / small / mini	—
disabled	是否禁用	boolean	—	false
text-color	按钮形式的 Radio 激活时的文本颜色	string	—	#ffffff
fill	按钮形式的 Radio 激活时的填充色和边框色	string	—	#409EFF

 

 

 

 

 

 

 

Radio-group Events

事件名称	说明	回调参数
change	绑定值变化时触发的事件	选中的 Radio label 值

 

 

 

Radio-button Attributes

参数	说明	类型	可选值	默认值
label	Radio 的 value	string / number	—	—
disabled	是否禁用	boolean	—	false
name	原生 name 属性	string	—	—

 

 

 

 

 

 

change事件默认执行函数的第一个返回值是选中的radio的label值，点击同一个radio不会重复触发

如果要触发，需要手动添加点击方法@click.native.prevent

 

Checkbox多选框

在el-checkbox元素中定义v-model绑定变量，单一的checkbox中，默认绑定变量的值会是Boolean，选中为true。

<template>

<!-- `checked` 为 true 或 false -->

　　 <el-checkbox v-model="checked">备选项</el-checkbox>

</template>

<script>

　　export default { data() { return { checked: true }; } };

</script>

checkbox-group元素能把多个 checkbox 管理为一组，只需要在 Group 中使用v-model绑定Array类型的变量即可。 

el-checkbox 的 label属性是该 checkbox 对应的值，若该标签中无内容，则该属性也充当 checkbox 按钮后的介绍。

label与数组中的元素值相对应，如果存在指定的值则为选中状态，否则为不选中。

<template>

　　<el-checkbox-group v-model="checkList">

　　　　 <el-checkbox label="复选框 A"></el-checkbox>

　　　　 <el-checkbox label="复选框 B"></el-checkbox>

　　　　 <el-checkbox label="复选框 C"></el-checkbox>

　　　　 <el-checkbox label="禁用" disabled></el-checkbox>

　　　　<el-checkbox label="选中且禁用" disabled></el-checkbox>

　　</el-checkbox-group>

</template>

<script> export default { data () { return { checkList: ['选中且禁用','复选框 A'] }; } }; </script>

indeterminate 属性用以表示 checkbox 的不确定状态，一般用于实现全选的效果

<el-checkbox :indeterminate="isIndeterminate" v-model="checkAll" @change="handleCheckAllChange">全选</el-checkbox>

 

indeterminate为false，checkAll为false的时候，状态为未选中。
indeterminate为true，checkAll为false的时候，状态为半选中。
indeterminate为false，checkAll为true的时候，状态为全选中。

 

使用 min 和 max 属性能够限制可以被勾选的项目的数量。

<template>

　　<el-checkbox-group v-model="checkedCities" :min="1" :max="2">

　　　　 <el-checkbox v-for="city in cities" :label="city" :key="city">{{city}}</el-checkbox>

　　</el-checkbox-group>

</template>

<script>

const cityOptions = ['上海', '北京', '广州', '深圳'];

export default { data() { return { checkedCities: ['上海', '北京'], cities: cityOptions }; } };

</script>

el-checkbox按钮样式

只需要把el-checkbox元素替换为el-checkbox-button元素即可。此外，Element 还提供了size属性。

添加border，一样可以生成有边框的多选框

Checkbox Attributes

参数	说明	类型	可选值	默认值
value / v-model	绑定值	string / number / boolean	—	—
label	选中状态的值（只有在checkbox-group或者绑定对象类型为array时有效）	string / number / boolean	—	—
true-label	选中时的值	string / number	—	—
false-label	没有选中时的值	string / number	—	—
disabled	是否禁用	boolean	—	false
border	是否显示边框	boolean	—	false
size	Checkbox 的尺寸，仅在 border 为真时有效	string	medium / small / mini	—
name	原生 name 属性	string	—	—
checked	当前是否勾选	boolean	—	false
indeterminate	设置 indeterminate 状态，只负责样式控制	boolean	—	false

 

 

 

 

 

 

 

 

 

 

Checkbox Events

事件名称	说明	回调参数
change	当绑定值变化时触发的事件	更新后的值

 

 

 

Checkbox-group Attributes

参数	说明	类型	可选值	默认值
value / v-model	绑定值	array	—	—
size	多选框组尺寸，仅对按钮形式的 Checkbox 或带有边框的 Checkbox 有效	string	medium / small / mini	—
disabled	是否禁用	boolean	—	false
min	可被勾选的 checkbox 的最小数量	number	—	—
max	可被勾选的 checkbox 的最大数量	number	—	—
text-color	按钮形式的 Checkbox 激活时的文本颜色	string	—	#ffffff
fill	按钮形式的 Checkbox 激活时的填充色和边框色	string	—	#409EFF

 

 

 

 

 

 

 

 

Checkbox-group Events

事件名称	说明	回调参数
change	当绑定值变化时触发的事件	更新后的值

 

 

 

Checkbox-button Attributes

参数	说明	类型	可选值	默认值
label	选中状态的值（只有在checkbox-group或者绑定对象类型为array时有效）	string / number / boolean	—	—
true-label	选中时的值	string / number	—	—
false-label	没有选中时的值	string / number	—	—
disabled	是否禁用	boolean	—	false
name	原生 name 属性	string	—	—
checked	当前是否勾选	boolean	—	false