更新记录
1.0.1(2025-08-02)
下载此版本
优化
1.0.0(2025-08-01)
下载此版本
初版
平台兼容性
uni-app
Vue2 |
Vue3 |
Chrome |
Safari |
app-vue |
app-nvue |
Android |
iOS |
鸿蒙 |
√ |
√ |
√ |
√ |
√ |
- |
- |
- |
- |
微信小程序 |
支付宝小程序 |
抖音小程序 |
百度小程序 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
快应用-华为 |
快应用-联盟 |
√ |
√ |
√ |
√ |
√ |
√ |
- |
√ |
√ |
√ |
√ |
其他
x-radio 组件使用说明
概述
x-radio
一个可自定义的单选框组件,支持自定义样式。
基本用法
<template>
<!-- vue2 :model-value.sync="isSelected", vue3 v-model="isSelected" -->
<x-radio v-model="isSelected" @change="handleChange">
</x-radio>
</template>
<script>
export default {
data() {
return {
isSelected: false
}
},
methods: {
handleChange(value) {
console.log('选中状态:', value)
}
}
}
</script>
Props 属性
属性 |
类型 |
默认值 |
说明 |
modelValue |
Boolean |
false |
绑定值,支持 v-model |
size |
String/Number |
36 |
组件大小,单位 rpx |
activeColor |
String |
#87ceeb |
选中时的背景颜色 |
inactiveColor |
String |
#ccc |
未选中时的边框颜色 |
radius |
String |
50% |
圆角大小 |
disabled |
Boolean |
false |
是否禁用 |
customStyle |
Object |
{} |
自定义样式对象 |
Events 事件
事件名 |
参数 |
说明 |
update:modelValue |
value: Boolean |
v-model 更新事件 |
click |
event |
点击事件 |
change |
value: Boolean |
状态改变事件 |
示例
自定义样式
<x-radio
v-model="selected"
:size="50"
active-color="#ff6b6b"
inactive-color="#999"
radius="10rpx"
/>
禁用状态
<x-radio
v-model="selected"
:disabled="true"
/>
自定义样式对象
<x-radio
v-model="selected"
:custom-style="{ boxShadow: '0 2px 4px rgba(0,0,0,0.1)' }"
/>
注意事项
- 组件使用 rpx 单位
- 选中状态显示白色 "√" 图标
- 支持插槽自定义选中状态的显示内容