更新记录
1.0.8(2025-10-30)
下载此版本
fix: 修复错误的导入
1.0.7(2025-10-30)
下载此版本
fix: 组件主题
1.0.6(2024-08-07)
下载此版本
文档更新
查看更多
平台兼容性
uni-app(4.53)
| Vue2 |
Vue3 |
Chrome |
Safari |
app-vue |
app-nvue |
Android |
iOS |
鸿蒙 |
| × |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
| 微信小程序 |
支付宝小程序 |
抖音小程序 |
百度小程序 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
快应用-华为 |
快应用-联盟 |
| √ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
其他
r-radio
r-radio单选框,在一组备选项中进行单选。
示例
<template>
<r-config-provider :themeName="themeName">
<page-header title="单选框"></page-header>
<view style="padding: 20px">
<r-divider content-position="left">基础使用</r-divider>
<r-radio-group v-model:value="radioData">
<r-radio name="1">单选框 1</r-radio>
<r-radio name="2">单选框 2</r-radio>
</r-radio-group>
<r-divider content-position="left">水平排列 </r-divider>
<r-radio-group v-model:value="radioData" direction="horizontal">
<r-radio name="1">单选框 1</r-radio>
<r-radio name="2">单选框 2</r-radio>
</r-radio-group>
<r-divider content-position="left">禁用状态 </r-divider>
<r-radio-group v-model:value="radioData" disabled>
<r-radio name="1">单选框 1</r-radio>
<r-radio name="2">单选框 2</r-radio>
</r-radio-group>
<r-divider content-position="left">自定义形状 </r-divider>
<r-radio-group v-model:value="radioData" shape="square">
<r-radio name="1">单选框 1</r-radio>
<r-radio name="2">单选框 2</r-radio>
</r-radio-group>
<r-divider content-position="left">自定义形状 </r-divider>
<r-radio-group v-model:value="radioData" shape="dot">
<r-radio name="1">Radio 1</r-radio>
<r-radio name="2">Radio 2</r-radio>
</r-radio-group>
<r-divider content-position="left">自定义颜色 </r-divider>
<r-radio-group v-model:value="radioData">
<r-radio name="1" checked-color="#ee0a24">单选框 1</r-radio>
<r-radio name="2" checked-color="#ee0a24">单选框 2</r-radio>
</r-radio-group>
<r-divider content-position="left">基础使用</r-divider>
<r-radio-group v-model:value="radioData">
<r-radio name="1" icon-size="24px">单选框 1</r-radio>
<r-radio name="2" icon-size="24px">单选框 2</r-radio>
</r-radio-group>
<r-divider content-position="left">左侧文本 </r-divider>
<r-radio-group v-model:value="radioData">
<r-radio name="1" label-position="left">单选框 1</r-radio>
<r-radio name="2" label-position="left">单选框 2</r-radio>
</r-radio-group>
<r-divider content-position="left">禁用文本点击 </r-divider>
<r-radio-group v-model:value="radioData">
<r-radio name="1" label-disabled>单选框 1</r-radio>
<r-radio name="2" label-disabled>单选框 2</r-radio>
</r-radio-group>
<r-divider content-position="left">自定义图标 </r-divider>
<r-radio-group v-model:value="radioData">
<r-radio name="1">
单选框 1
<template #icon="props">
<image
style="height: 20px; width: 20px"
:src="props.checked ? activeURL : inactiveURL"
/>
</template>
</r-radio>
<r-radio name="2">
单选框 2
<template #icon="props">
<image
style="height: 20px; width: 20px"
:src="props.checked ? activeURL : inactiveURL"
/>
</template>
</r-radio>
</r-radio-group>
</view>
</r-config-provider>
</template>
<script setup>
import { ref } from "vue";
import useTheme from "@/hooks/useTheme";
const { themeName } = useTheme();
const radioData = ref("1");
const activeURL = ref(
"https://fastly.jsdelivr.net/npm/@vant/assets/user-active.png"
);
const inactiveURL = ref(
"https://fastly.jsdelivr.net/npm/@vant/assets/user-inactive.png"
);
</script>
<style></style>
API
Radio Props
| 名称 |
说明 |
类型 |
默认值 |
可选值 |
| name |
标识符,通常为一个唯一的字符串或数字 |
any |
- |
- |
| shape |
形状 |
String |
round |
square dot |
| disabled |
是否为禁用状态 |
Boolean |
false |
true |
| labelPosition |
文本位置 |
String |
right |
left |
| iconSize |
图标大小 |
String |
40rpx |
|
| checkedColor |
选中状态颜色 |
String |
#1989fa |
|
| themeName |
r-theme 的主题名称 |
String |
default |
|
RadioGroup Props
| 名称 |
说明 |
类型 |
默认值 |
可选值 |
| value |
当前选中项的标识符 |
any |
- |
- |
| disabled |
是否禁用所有单选框 |
Boolean |
false |
true |
| direction |
排列方向 |
String |
vertical |
horizontal |
| shape |
形状 |
String |
round |
square dot |
| iconSize |
所有单选框的图标大小 |
String |
40rpx |
|
| checkedColor |
所有单选框的选中状态颜色 |
String |
#1989fa |
|
| themeName |
r-theme 的主题名称 |
String |
default |
|
Radio Slots
| 名称 |
说明 |
参数 |
| default |
自定义文本 |
{ checked: boolean, disabled: boolean } |
| icon |
自定义图标 |
{ checked: boolean, disabled: boolean } |
Radio Events
| 名称 |
说明 |
回调参数 |
| update:value |
当绑定值变化时触发的事件 |
value |
| click |
点击单选框时触发 |
e |
RadioGroup Events
| 名称 |
说明 |
回调参数 |
| update:value |
当绑定值变化时触发的事件 |
value |
更多组件,请前往rainui