Skip to content

单选框 Radio

常用于性别、偏好、单选型问题等场景,保障用户做出明确且唯一的选择,在表单填写、设置选项等交互流程中,提升信息收集准确性与操作便捷性。

Radio

value:option 1

配置项

基础用法

单选框的基本用法

vue
<template>
  <bp-space>
    <bp-radio v-model="val" :value="0">选项</bp-radio>
    <bp-radio v-model="val" disabled :value="1">禁用选项</bp-radio>
  </bp-space>
</template>

<script setup lang="ts">
import { ref } from "vue";
const val = ref(1);
</script>

单选框组

通过 radio-group 组件实现单选框组,更好的管理一组单选框

vue
<template>
  <bp-space type="vertical">
    <bp-radio-group v-model="val">
      <template v-for="v in optionList">
        <bp-radio :value="v">{{ v }}</bp-radio>
      </template>
    </bp-radio-group>
    <bp-radio-group v-model="val1">
      <template v-for="v in optionList">
        <bp-radio :value="v">{{ v }}</bp-radio>
      </template>
    </bp-radio-group>
  </bp-space>
</template>

<script setup lang="ts">
import { ref } from "vue";

const val = ref('男');
const val1 = ref('女');
const optionList = ["男", "女", "未知"];
</script>

按钮单选框组

通过 type="button" 设置单选框为按钮样式

vue
<template>
  <bp-radio-group v-model="val" type="button">
    <template v-for="v in optionList">
      <bp-radio :value="v">{{ v }}</bp-radio>
    </template>
  </bp-radio-group>
</template>

<script setup lang="ts">
import { ref } from "vue";

const val = ref("推荐");
const optionList = ["推荐", "最新", "最热"];
</script>

Radio 属性

v-model绑定值
RadioValue
--
value单选值
RadioValue
--
disabled是否禁用
Boolean
false-

RadioGroup 属性

v-model绑定值
RadioValue
--
type单选组类型
RadioType
--
disabled是否禁用
Boolean
false-
size尺寸
ButtonSize
default-
direction单选组类型
DirectionType
--

Radio 事件

change单选值改变触发value:RadioValue-