简体中文
fs-switch
约 348 字大约 1 分钟
2026-06-25
简介
开关组件用于控制某个功能的开/关状态,支持多种类型、状态和尺寸,适用于表单、设置等场景。
使用方法
局部引入,在需要引入的页面或组件的 index.json 中配置:
"usingComponents": {
"fs-switch": "ava-ui/fxui/fs-switch/index"
}代码演示
类型(type 属性)
default:标准开关text:带文字的开关(ON/OFF)icon:带图标的开关
尺寸(size 属性)
mini:高度 18px,适合紧凑场景medium:高度 30px,适合常规场景
状态(status 属性)
default:正常loading:加载中(不可切换)disabled:禁用(不可切换)
代码示例
API
属性
| 属性 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| checked | 是否选中 | boolean | true / false | false |
| type | 类型 | string | default/text/icon | default |
| status | 状态 | string | default/loading/disabled | default |
| size | 尺寸 | string | mini/medium | mini |
| checkedText | 选中时文本 | string | - | "ON" |
| uncheckedText | 未选中时文本 | string | - | "OFF" |
| checkedIcon | 选中时图标 | string | - | "checkmark" |
| uncheckedIcon | 未选中时图标 | string | - | "guanbi2" |
事件
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| change | 状态切换时触发 |
Slot
无
图标说明
checkedIcon和uncheckedIcon属性可用fxui/common_css/iconfont字体库中的图标名,如checkmark、guanbi2、star、jinbi等。- 也可通过 slot 自定义 icon(如需扩展)。
