Switch Group 开关组

一组开关组件，允许用户快速切换多个相关联的选项。支持单选和多选模式。

组件特性

• 🔄 多种模式：支持单选（single）和多选（multiple）模式。
• 🎛️ 批量操作：在多选模式下提供内置的 selectAll（全选）和 clearAll（全不选）方法。
• 📐 方向控制：支持水平（row）或垂直（column）排列。
• 📋 表单与表格集成：能够轻松与 BrForm 表单组件和 BrTable 表格组件集成。
• 🎨 尺寸继承：自动继承全局配置或属性传递的尺寸，并向下传递给各个开关项。

基础用法

包含模式切换与批量操作的 SwitchGroup 基础用法。

Wi-FiBluetoothAirplane Mode

当前值: [ "wifi", "bluetooth" ]

Example

与表单集成

在表单操作中用于偏好设置的典型应用。

通知偏好设置

邮件通知短信通知App 推送通知

Example

与表格集成

在表格中结合插槽管理列表项的权限或状态。

用户	权限设置
User 1	读取写入管理
User 2	读取写入管理

Example

API 说明

BrSwitchGroup

属性	类型	默认值	说明
modelValue (v-model)	string | number | (string | number)[] | undefined	-	当前选中的值
mode	'single' | 'multiple'	'multiple'	选择模式
disabled	boolean	false	是否禁用整个开关组
direction	'row' | 'column'	'row'	布局方向
size	'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'default'	-	开关尺寸
lazyRender	boolean	false	是否懒加载渲染

方法 (Methods)

名称	说明
selectAll	选中所有可用选项（仅在 multiple 模式下有效）
clearAll	清除所有选项的选中状态

BrSwitchGroupItem

属性	类型	默认值	说明
value	string | number	-	选项的唯一标识（必填）
label	string	-	开关的文本标签
disabled	boolean	false	是否禁用该选项
checkedText	string	-	选中时显示的文本
uncheckedText	string	-	未选中时显示的文本
loading	boolean	false	是否处于加载中状态