Radio 单选框

示例

尺寸

可选的 ui 属性值:small

<template>
<article>
  <section>
    <veui-radio :checked.sync="normal">
      Normal size
    </veui-radio>
    <veui-radio
      :checked.sync="small"
      ui="small"
    >
      Small size
    </veui-radio>
  </section>
  <section>
    <veui-button
      ui="small"
      @click="reset"
    >
      Reset
    </veui-button>
  </section>
</article>
</template>

<script>
import { Radio, Button } from 'veui'

export default {
  components: {
    'veui-radio': Radio,
    'veui-button': Button
  },
  data () {
    return {
      normal: false,
      small: false
    }
  },
  methods: {
    reset () {
      this.normal = false
      this.small = false
    }
  }
}
</script>

值设定

可以通过设置 value 来修改选中状态下 model 属性(v-model)的值。

Selected: -

<template>
<article>
  <veui-radio
    v-for="({ value, label }) in flavors"
    :key="value"
    v-model="flavor"
    :value="value"
  >
    {{ label }}
  </veui-radio>
  <p>Selected: {{ flavorLabelMap[flavor] || '-' }}</p>
</article>
</template>

<script>
import { Radio } from 'veui'

export default {
  components: {
    'veui-radio': Radio
  },
  data () {
    return {
      flavor: null,
      flavors: [
        { value: 'LATTE', label: 'Latte' },
        { value: 'MOCHA', label: 'Mocha' },
        { value: 'AMERICANO', label: 'Americano' }
      ]
    }
  },
  computed: {
    flavorLabelMap () {
      return this.flavors.reduce((map, { value, label }) => {
        map[value] = label
        return map
      }, {})
    }
  }
}
</script>

API

属性

名称类型默认值描述
uistring-

预设样式。

描述
small小尺寸样式。
model*-

v-model

当前状态的值。选中状态为 value 对应值,未选中状态为绑定到同一 model 源的 Radio 组件的 value 值。

checkedbooleanfalse

.sync

是否处于选中状态。

value*true选中状态对应的值。
disabledbooleanfalse是否为禁用状态。
readonlybooleanfalse是否为只读状态。

插槽

名称描述
default单选框的描述文本,点击时会进行选中。无默认内容。

事件

名称描述
change用户切换选中状态时触发,回调参数为 (checked: boolean)checked 表示当前是否选中。
input

v-model

选中状态变化后触发,回调参数为 (val: *)val 为当前 model 属性的值。与 change 事件不同,input 事件在数据操作导致状态变化时也会触发。

此外,Radio 支持如下的原生事件:

auxclickclickcontextmenudblclickmousedownmouseentermouseleavemousemovemouseovermouseoutmouseupselectwheelkeydownkeypresskeyupfocusblurfocusinfocusout

回调参数均为相应的原生事件对象。