应弃用 uni-radio,改用原生 radio-group + label + input[type="radio"] 手写结构,因其支持全端、样式可控、事件可靠,且能精准实现整行点击、图标对齐、禁用态等需求。

直接用 uni-radio 基本没法自定义样式——它内部结构被封装死,外部 CSS 几乎无法穿透圆点、选中态等关键部分。真正能落地的方案是弃用它,改用原生 radio-group + label + input[type="radio"] 手写结构。
为什么不能靠改 uni-radio 的 class 或 style
uni-radio 是一个黑盒组件:它的 DOM 是用 view 和 text 拼出来的,不是标准 input;所有视觉逻辑(比如圆圈、对勾、禁用灰度)都硬编码在组件源码里;你加 !important 也盖不过去,因为样式根本不在你可控制的层级。
- 调试时能看到元素,但 hover 或点击后状态不更新——不是逻辑错,是样式没挂到真实响应节点上
- 微信/支付宝小程序里,
uni-radio的:checked绑定经常失效,尤其配合v-for动态渲染时 - 想让整行可点、图标右对齐、禁用时文字变浅——这些需求在
uni-radio上要 hack 十几层,不如重写
用 radio-group + label + input 的正确写法
这个组合在 H5、App、小程序(含鸿蒙)全端可用,关键是结构和 class 控制方式要对:
-
input[type="radio"]必须设position: absolute; opacity: 0;,确保可触发但不可见 -
label必须包裹input和自定义内容(文字 + 图标),点击 label 才能触发 input - 不要依赖
input:checked + .icon这类兄弟选择器——微信/支付宝小程序不支持:checked伪类 - 改用
:class="{ 'is-checked': selectedValue === item.value }"动态绑定 label 的 class -
radio-group的@change事件只在 H5 有效;真机调试时,必须监听 label 的@click并手动赋值
图标用 font-icon 还是 SVG?怎么对齐才不飘
推荐用 iconfont 字体图标(体积小、易缩放),避免用图片或复杂 SVG;对齐问题本质是行高和基线错位:
-
font-size设为16px左右,配合line-height: 1和vertical-align: middle - 图标容器(比如
.custom-radio-icon)设display: inline-flex; align-items: center;更稳 - 不要用
margin-top硬调——不同平台字体渲染差异会导致偏移量不一致 - 选中态图标(如对勾)建议用伪元素
::before实现,避免多一层 DOM 影响 flex 布局
最常被忽略的是小程序真机下的事件链:你以为绑了 @change 就够了,但微信小程序里 radio-group 的 change 可能根本不触发;必须把逻辑下沉到每个 label @click,再显式设置 selectedValue = item.value,否则用户点了没反应。


















