element/examples/docs/radio.md

167 lines
5.4 KiB
Markdown
Raw Normal View History

2016-07-27 06:15:02 +00:00
<script>
module.exports = {
data() {
return {
radio: '',
radio1: '选中且禁用',
radio2: 3,
radio31: '',
radio32: '',
radio33: ''
};
}
};
</script>
## 基本用法
2016-08-23 10:32:28 +00:00
要使用 Radio 组件,只需要设置`v-model`绑定变量,选中意味着变量的值为相应 Radio `label`属性的值,`label`可以是`String`或者`Number`。
2016-07-27 06:15:02 +00:00
<div class="demo-box demo-radio">
2016-08-15 02:36:21 +00:00
<el-radio class="radio" v-model="radio" label="单选框 A"></el-radio>
<el-radio class="radio" v-model="radio" label="单选框 B"></el-radio>
<el-radio class="radio" v-model="radio" label="单选框 C"></el-radio>
2016-07-27 06:15:02 +00:00
</div>
2016-08-23 10:32:28 +00:00
{{radio}}
2016-07-27 06:15:02 +00:00
```html
<template>
2016-08-15 02:36:21 +00:00
<el-radio class="radio" v-model="radio" label="单选框 A"></el-radio>
<el-radio class="radio" v-model="radio" label="单选框 B"></el-radio>
<el-radio class="radio" v-model="radio" label="单选框 C"></el-radio>
2016-07-27 06:15:02 +00:00
</template>
<script>
export default {
data () {
return {
2016-08-23 10:32:28 +00:00
radio: ''
};
2016-07-27 06:15:02 +00:00
}
}
</script>
```
## Radio Group
2016-08-23 10:32:28 +00:00
结合`el-radio-group`元素和子元素`el-radio`可以实现单选组,在`el-radio-group`中绑定`v-model`,在`el-radio`中设置好`label`即可,无需再给每一个`el-radio`绑定变量,另外,还提供了`change`事件来响应变化,它会传入一个参数`value`。
2016-07-27 06:15:02 +00:00
<div class="demo-box demo-radio">
2016-08-15 02:36:21 +00:00
<el-radio-group v-model="radio2">
2016-07-27 06:15:02 +00:00
<el-radio :label="9"></el-radio>
<el-radio :label="6"></el-radio>
<el-radio :label="3"></el-radio>
</el-radio-group>
</div>
```html
2016-08-15 02:36:21 +00:00
<el-radio-group v-model="radio2">
2016-07-27 06:15:02 +00:00
<el-radio :label="9"></el-radio>
<el-radio :label="6"></el-radio>
<el-radio :label="3"></el-radio>
</el-radio-group>
```
## Radio Group Button
2016-08-23 10:32:28 +00:00
还有一种特殊的单选按钮组,只需要把`el-radio`元素换成`el-radio-button`元素即可此外Element 还提供了`size`属性给按钮组,支持`large`和`small`两种(如果不设定为默认)。
2016-07-27 06:15:02 +00:00
<div class="demo">
2016-08-15 02:36:21 +00:00
<el-radio-group v-model="radio31" size="large">
2016-07-27 06:15:02 +00:00
<el-radio-button label="上海"></el-radio-button>
<el-radio-button label="北京"></el-radio-button>
<el-radio-button label="广州" :disabled="true"></el-radio-button>
<el-radio-button label="深圳"></el-radio-button>
</el-radio-group>
</div>
<div class="demo">
2016-08-15 02:36:21 +00:00
<el-radio-group v-model="radio32">
2016-07-27 06:15:02 +00:00
<el-radio-button label="上海"></el-radio-button>
<el-radio-button label="北京"></el-radio-button>
<el-radio-button label="广州" :disabled="true"></el-radio-button>
<el-radio-button label="深圳"></el-radio-button>
</el-radio-group>
</div>
<div class="demo">
2016-08-15 02:36:21 +00:00
<el-radio-group v-model="radio33" size="small">
2016-07-27 06:15:02 +00:00
<el-radio-button label="上海"></el-radio-button>
<el-radio-button label="北京"></el-radio-button>
<el-radio-button label="广州" :disabled="true"></el-radio-button>
<el-radio-button label="深圳"></el-radio-button>
</el-radio-group>
</div>
```html
2016-08-15 02:36:21 +00:00
<el-radio-group v-model="radio31" size="large">
2016-07-27 06:15:02 +00:00
<el-radio-button label="上海"></el-radio-button>
<el-radio-button label="北京"></el-radio-button>
<el-radio-button label="广州" :disabled="true"></el-radio-button>
<el-radio-button label="深圳"></el-radio-button>
</el-radio-group>
2016-08-15 02:36:21 +00:00
<el-radio-group v-model="radio32">
2016-07-27 06:15:02 +00:00
<el-radio-button label="上海"></el-radio-button>
<el-radio-button label="北京"></el-radio-button>
<el-radio-button label="广州" :disabled="true"></el-radio-button>
<el-radio-button label="深圳"></el-radio-button>
</el-radio-group>
2016-08-15 02:36:21 +00:00
<el-radio-group v-model="radio33" size="small">
2016-07-27 06:15:02 +00:00
<el-radio-button label="上海"></el-radio-button>
<el-radio-button label="北京"></el-radio-button>
<el-radio-button label="广州" :disabled="true"></el-radio-button>
<el-radio-button label="深圳"></el-radio-button>
</el-radio-group>
```
## 禁用
2016-08-23 10:32:28 +00:00
只要在`el-radio`元素中设置`disabled`属性即可,它接受一个`Boolean``true`为禁用。
注意:请牢记,选中的条件是绑定的变量值等于`label`中的值。
2016-07-27 06:15:02 +00:00
<div class="demo-box demo-radio">
2016-08-15 02:36:21 +00:00
<el-radio disabled v-model="radio" label="禁用"></el-radio>
<el-radio disabled v-model="radio1" label="选中且禁用"></el-radio>
2016-07-27 06:15:02 +00:00
</div>
```html
2016-08-23 10:32:28 +00:00
<template>
<el-radio disabled v-model="radio" label="禁用"></el-radio>
<el-radio disabled v-model="radio1" label="选中且禁用"></el-radio>
</template>
<script>
export default {
data () {
return {
radio: '',
radio1: '选中且禁用'
};
}
}
</script>
2016-07-27 06:15:02 +00:00
```
2016-08-23 10:32:28 +00:00
## Radio Attributes
2016-07-27 06:15:02 +00:00
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---------- |-------- |---------- |------------- |-------- |
2016-08-23 10:32:28 +00:00
| label | Radio 的 value | string,number | | |
| disabled | 是否禁用 | boolean | | false |
2016-07-27 06:15:02 +00:00
2016-08-23 10:32:28 +00:00
## Radio-group Attributes
2016-07-27 06:15:02 +00:00
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---------- |-------- |---------- |------------- |-------- |
2016-08-23 10:32:28 +00:00
| size | Radio 按钮组尺寸 | string | large, small | |
## Radio-group Events
| 事件名称 | 说明 | 回调参数 |
|---------- |-------- |---------- |
| change | 绑定值变化时触发的事件 | 选中的 Radio label 值 |
2016-07-27 06:15:02 +00:00
2016-08-23 10:32:28 +00:00
## Radio-button Attributes
2016-07-27 06:15:02 +00:00
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---------- |-------- |---------- |------------- |-------- |
2016-08-23 10:32:28 +00:00
| label | Radio 的 value | string,number | | |
| disabled | 是否禁用 | boolean | | false |