t-radio-group

RadioGroup 单选框组

组件介绍

单选框组组件，支持布局方向（横向或纵向），不同的显示模式（radio、button、cell），丰富主题配置。

平台兼容

Harmony	H5	Android	iOS	小程序	UTS
✅	✅	✅	✅	✅	✅

基础用法

<template>
  <view class="radio-group-demo">
    <t-radio-group v-model="selected" mode="radio">
      <t-radio value="1" label="选项1"></t-radio>
      <t-radio value="2" label="选项2"></t-radio>
      <t-radio value="3" label="选项3"></t-radio>
    </t-radio-group>
    
    <t-radio-group v-model="selected2" mode="button">
      <t-radio value="A" label="选项A"></t-radio>
      <t-radio value="B" label="选项B"></t-radio>
      <t-radio value="C" label="选项C"></t-radio>
    </t-radio-group>
  </view>
</template>

<script setup>
const selected = ref('1');
const selected2 = ref('A');
</script>

<style scoped>
.radio-group-demo {
  padding: 40rpx;
  display: flex;
  flex-direction: column;
  gap: 30rpx;
}
</style>

Props

属性名	类型	默认值	说明	可选值
size	String	"medium"	组件尺寸	large, medium, small, mini
type	String	""	组件类型	info, primary, error, warning, success
disabled	Boolean	false	组件是否禁用	true, false
hover	Boolean	false	是否有点击效果	true, false
path	String	""	点击组件后跳转的页面路径	-
effect	String	"normal"	组件显示主题	normal, dark, light, plain
childClass	String	""	统一设置子元素样式	-
transition	Boolean	false	是否支持动画	true, false
duration	Number	200	动画时间	-
labelClass	String	""	显示文本样式	-
icon	String	"check-fill"	图标	-
iconBoxClass	String	""	图标容器样式	-
activeClass	String	""	选中时的组件的样式	-
inactiveClass	String	""	未选中时的组件的样式	-
iconClass	String	""	图标样式	-
activeIconClass	String	""	选中时图标的样式	-
inactiveIconClass	String	""	未选中时图标的样式	-
activeLabelClass	String	""	选中时文本的样式	-
inactiveLabelClass	String	""	未选中时文本的样式	-
mode	String	"radio"	显示模式	button, radio, cell
border	Boolean	true	是否显示边框	true, false
modelValue	String	""	双向绑定的值	-

Events

事件名	说明	回调参数
change	选中状态发生变化时触发	当前选中的值
click	点击时触发	-
transitionend	动画结束时触发	-
initFinished	组件初始化完成触发	组件的节点信息
touchstart	触摸开始时触发	触摸事件对象
touchend	触摸结束时触发	触摸事件对象
touchmove	触摸移动时触发	触摸事件对象
touchcancel	触摸取消时触发	触摸事件对象

Mode 说明

模式值	说明	显示效果
radio	单选框模式	显示圆形单选框
button	按钮样式	显示按钮样式
cell	列表模式	显示列表样式

Slots

插槽名	说明
default	内容插槽，用于放置t-radio子组件