# Radio 单选框

概述

Radio 单项选择器，需结合fui-radio-group和fui-radio组件一起使用。微信、百度、QQ小程序中还使用了fui-form-field组件（如果未使用easycom组件规范，请在fui-radio-group组件中手动引入、注册该组件）。

# 支持平台

App-vue	App-Nvue	微信小程序	支付宝小程序	百度小程序	字节小程序	QQ小程序	H5	PC	快手小程序	钉钉小程序
✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓

# 引入

以下介绍两种常用的引入方式。

第一种：在页面中引用、注册

注意：使用这种方式引入，请务必在fui-radio-group组件中手动引入、注册fui-form-field组件。

import fuiRadioGroup from "@/components/firstui/fui-radio-group/fui-radio-group.vue"
import fuiRadio from "@/components/firstui/fui-radio/fui-radio.vue"
export default {
	components:{
		fuiRadioGroup,
		fuiRadio
	}
}

1
2
3
4
5
6
7
8

第二种：easycom组件规范

传统vue组件，需要安装、引用、注册，三个步骤后才能使用组件。easycom将其精简为一步。

First UI easycom配置请查看快速上手。

如果不了解easycom，可先查看官网文档 (opens new window)。

# 代码演示

部分示例演示，完整使用请参考示例程序以及文档API。

基本使用

可通过v-model直接获取选中的值，也可通过change事件来获取。

<fui-radio-group name="radio" v-model="val" @change="change">
	<view class="fui-list__item">
		<fui-label>
			<view class="fui-align__center">
				<fui-radio value="1" checked></fui-radio>
				<text class="fui-text">选中</text>
			</view>
		</fui-label>
		<fui-label :margin="['0','0','0','40rpx']">
			<view class="fui-align__center">
				<fui-radio value="2"></fui-radio>
				<text class="fui-text">未选中</text>
			</view>
		</fui-label>
	</view>
</fui-radio-group>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

# Slots

# fui-radio-group 组件

插槽名称	说明
default	标签显示内容，内部由多个fui-radio组成

# fui-radio 组件

插槽名称	说明
-	-

# fui-form-field 组件

该组件主要用于表单传递数据，仅微信、百度、QQ小程序端使用。

插槽名称	说明
default	标签内显示内容，内部由多个fui-radio组成

# Props

# fui-radio-group 组件

属性名	类型	说明	默认值	平台差异说明
name	String	单项选择器名称	-	-
value	String	选中的value值，用于双向绑定，vue2使用	-	-
modelValue	String	选中的value值，用于双向绑定，vue3使用	-	-

# fui-radio 组件

属性名	类型	说明	默认值	平台差异说明
value	String	value值，当选中时会携带该值	-	-
checked	Boolean	是否选中	false	-
disabled	Boolean	是否禁用	false	-
color	String	选中时背景颜色	#465CFF	非Nvue端默认为空，可以通过css变量（--fui-color-primary）修改默认颜色值
borderColor	String	未选中时边框颜色	#ccc	-
borderRadius	String	圆角值	Nvue：40rpx，非nvue：50%	Nvue端只能传入具体值，不可使用百分比
isCheckMark	Boolean	是否只展示对号，无边框背景，仅styleType=1时有效	false	-
checkMarkColor	String	对号颜色，styleType=1时有效	#fff	-
dotColor 2.4.0+	String	圆点颜色，styleType=2时有效	-	-
scaleRatio	Number, String	缩放比例	1	-
styleType 2.4.0+	Number, String	选中后样式类型,可选值：1-checkmark（对号） 2-dot（圆点）	1	-

# fui-form-field 组件

属性名	类型	说明	默认值	平台差异说明
hidden	Boolean	是否为隐藏域	false	微信、百度、QQ小程序

# Events

# fui-radio-group 组件

事件名	说明	回调参数
@change	选中项发生变化时触发	event.detail = { value }
@input vue2	用于组件双向绑定，使用v-model指令即可	value
@update:modelValue vue3	用于组件双向绑定，使用v-model指令即可	modelValue

示例预览

# 示例代码地址

Radio 单选框

← Label 标签 Checkbox 复选框 →