在一組備選項中進行單選。
通過以下方式來全局注冊組件,更多注冊方式請參考組件注冊。
import { createApp } from 'vue';
import { RadioGroup, Radio } from 'vant';
const app = createApp();
app.use(Radio);
app.use(RadioGroup);
通過 v-model 綁定值當(dāng)前選中項的 name。
<van-radio-group v-model="checked">
<van-radio name="1">單選框 1</van-radio>
<van-radio name="2">單選框 2</van-radio>
</van-radio-group>
import { ref } from 'vue';
export default {
setup() {
const checked = ref('1');
return { checked };
},
};
將 direction 屬性設(shè)置為 horizontal 后,單選框組會變成水平排列。
<van-radio-group v-model="checked" direction="horizontal">
<van-radio name="1">單選框 1</van-radio>
<van-radio name="2">單選框 2</van-radio>
</van-radio-group>
通過 disabled 屬性禁止選項切換,在 Radio 上設(shè)置 disabled 可以禁用單個選項。
<van-radio-group v-model="checked" disabled>
<van-radio name="1">單選框 1</van-radio>
<van-radio name="2">單選框 2</van-radio>
</van-radio-group>
將 shape 屬性設(shè)置為 square,單選框的形狀會變成方形。
<van-radio-group v-model="checked">
<van-radio name="1" shape="square">單選框 1</van-radio>
<van-radio name="2" shape="square">單選框 2</van-radio>
</van-radio-group>
通過 checked-color 屬性設(shè)置選中狀態(tài)的圖標(biāo)顏色。
<van-radio-group v-model="checked">
<van-radio name="1" checked-color="#ee0a24">單選框 1</van-radio>
<van-radio name="2" checked-color="#ee0a24">單選框 2</van-radio>
</van-radio-group>
通過 icon-size 屬性可以自定義圖標(biāo)的大小。
<van-radio-group v-model="checked">
<van-radio name="1" icon-size="24px">單選框 1</van-radio>
<van-radio name="2" icon-size="24px">單選框 2</van-radio>
</van-radio-group>
通過 icon 插槽自定義圖標(biāo),并通過 slotProps 判斷是否為選中狀態(tài)。
<van-radio-group v-model="checked">
<van-radio name="1">
單選框 1
<template #icon="props">
<img class="img-icon" :src="props.checked ? activeIcon : inactiveIcon" />
</template>
</van-radio>
<van-radio name="2">
單選框 2
<template #icon="props">
<img class="img-icon" :src="props.checked ? activeIcon : inactiveIcon" />
</template>
</van-radio>
</van-radio-group>
<style>
.img-icon {
height: 20px;
}
</style>
import { ref } from 'vue';
export default {
setup() {
const checked = ref('1');
return {
checked,
activeIcon: 'https://img.yzcdn.cn/vant/user-active.png',
inactiveIcon: 'https://img.yzcdn.cn/vant/user-inactive.png',
};
},
};
設(shè)置 label-disabled 屬性后,點擊圖標(biāo)以外的內(nèi)容不會觸發(fā)單選框切換。
<van-radio-group v-model="checked">
<van-radio name="1" label-disabled>單選框 1</van-radio>
<van-radio name="2" label-disabled>單選框 2</van-radio>
</van-radio-group>
此時你需要再引入 Cell 和 CellGroup 組件。
<van-radio-group v-model="checked">
<van-cell-group>
<van-cell title="單選框 1" clickable @click="checked = '1'">
<template #right-icon>
<van-radio name="1" />
</template>
</van-cell>
<van-cell title="單選框 2" clickable @click="checked = '2'">
<template #right-icon>
<van-radio name="2" />
</template>
</van-cell>
</van-cell-group>
</van-radio-group>
參數(shù) | 說明 | 類型 | 默認值 |
---|---|---|---|
name | 標(biāo)識符 | any | - |
shape | 形狀,可選值為 square
|
string | round
|
disabled | 是否為禁用狀態(tài) | boolean | false
|
label-disabled | 是否禁用文本內(nèi)容點擊 | boolean | false
|
label-position | 文本位置,可選值為 left
|
string | right
|
icon-size | 圖標(biāo)大小,默認單位為px
|
number | string | 20px
|
checked-color | 選中狀態(tài)顏色 | string | #1989fa
|
參數(shù) | 說明 | 類型 | 默認值 |
---|---|---|---|
v-model | 當(dāng)前選中項的標(biāo)識符 | any | - |
disabled | 是否禁用所有單選框 | boolean | false
|
direction | 排列方向,可選值為horizontal
|
string | vertical
|
icon-size | 所有單選框的圖標(biāo)大小,默認單位為px
|
number | string | 20px
|
checked-color | 所有單選框的選中狀態(tài)顏色 | string | #1989fa
|
事件名 | 說明 | 回調(diào)參數(shù) |
---|---|---|
click | 點擊單選框時觸發(fā) | event: MouseEvent |
事件名 | 說明 | 回調(diào)參數(shù) |
---|---|---|
change | 當(dāng)綁定值變化時觸發(fā)的事件 | name: string |
名稱 | 說明 | 參數(shù) |
---|---|---|
default | 自定義文本 | - |
icon | 自定義圖標(biāo) | { checked: boolean, disabled: boolean } |
組件提供了下列 CSS 變量,可用于自定義樣式,使用方法請參考 ConfigProvider 組件。
名稱 | 默認值 | 描述 |
---|---|---|
--van-radio-size | 20px | - |
--van-radio-border-color | var(--van-gray-5) | - |
--van-radio-transition-duration | var(--van-animation-duration-fast) | - |
--van-radio-label-margin | var(--van-padding-xs) | - |
--van-radio-label-color | var(--van-text-color) | - |
--van-radio-checked-icon-color | var(--van-primary-color) | - |
--van-radio-disabled-icon-color | var(--van-gray-5) | - |
--van-radio-disabled-label-color | var(--van-gray-5) | - |
--van-radio-disabled-background-color | var(--van-border-color) | - |
更多建議: