• Radio 单选框
    • 引入
  • 代码演示
    • 基础用法
    • 禁用状态
    • 自定义颜色
    • 自定义图标
    • 与 Cell 组件一起使用
  • API
    • Radio Props
    • RadioGroup Props
    • Radio Events
    • RadioGroup Events
    • Radio Slots

    Radio 单选框

    引入

    1. import { RadioGroup, Radio } from 'vant';
    2. Vue.use(RadioGroup);
    3. Vue.use(Radio);

    代码演示

    基础用法

    通过v-model绑定值当前选中项的 name

    1. <van-radio-group v-model="radio">
    2. <van-radio name="1">单选框 1</van-radio>
    3. <van-radio name="2">单选框 2</van-radio>
    4. </van-radio-group>
    1. export default {
    2. data() {
    3. return {
    4. radio: '1'
    5. }
    6. }
    7. };

    禁用状态

    通过disabled属性禁止选项切换,在van-radio上设置disabled可以禁用单个选项

    1. <van-radio-group v-model="radio" disabled>
    2. <van-radio name="1">单选框 1</van-radio>
    3. <van-radio name="2">单选框 2</van-radio>
    4. </van-radio-group>

    自定义颜色

    1. <van-radio checked-color="#07c160">复选框</van-radio>

    自定义图标

    通过 icon 插槽自定义图标,可以通过 slot-scope 判断是否为选中状态

    1. <van-radio v-model="checked">
    2. 自定义图标
    3. <img
    4. slot="icon"
    5. slot-scope="props"
    6. :src="props.checked ? icon.active : icon.normal"
    7. >
    8. </van-radio>
    1. export default {
    2. data() {
    3. checked: true,
    4. icon: {
    5. normal: '//img.yzcdn.cn/icon-normal.png',
    6. active: '//img.yzcdn.cn/icon-active.png'
    7. }
    8. }
    9. }

    与 Cell 组件一起使用

    此时你需要再引入CellCellGroup组件。

    1. <van-radio-group v-model="radio">
    2. <van-cell-group>
    3. <van-cell title="单选框 1" clickable @click="radio = '1'">
    4. <van-radio name="1" />
    5. </van-cell>
    6. <van-cell title="单选框 2" clickable @click="radio = '2'">
    7. <van-radio name="2" />
    8. </van-cell>
    9. </van-cell-group>
    10. </van-radio-group>

    API

    Radio Props

    参数说明类型默认值版本
    name标识符任意类型--
    shape形状,可选值为 squareStringround1.6.0
    disabled是否为禁用状态Booleanfalse-
    icon-size图标大小,默认单位为pxString | Number20px2.0.0
    label-disabled是否禁用文本内容点击Booleanfalse1.1.13
    label-position文本位置,可选值为 leftStringright1.1.13
    checked-color选中状态颜色String#1989fa1.4.5

    RadioGroup Props

    参数说明类型默认值版本
    v-model当前选中项的标识符任意类型--
    disabled是否禁用所有单选框Booleanfalse-

    Radio Events

    事件名说明回调参数
    click点击单选框时触发event: Event

    RadioGroup Events

    事件名说明回调参数
    change当绑定值变化时触发的事件当前选中项的 name

    Radio Slots

    名称说明slot-scope
    default自定义文本-
    icon自定义图标checked: 是否为选中状态

    Radio 单选框 - 图1