更新记录
0.1.5(2026-08-14)
下载此版本
- 精简 readme:移除内部开发向内容(设计说明 / 实现细节 / 平台差异实现等),只保留安装、用法、API、主题等用户文档
0.1.3(2026-08-07)
下载此版本
- 支持 iOS 端:内联 style 中
var() 过渡解析异常导致关闭态整钮透明/发白,iOS 下轨道与滑块色改为实色兜底(APP-IOS 条件编译);显式 activeColor/inactiveColor 仍生效。Android、鸿蒙、Web 与小程序行为不变。
0.1.2(2026-08-01)
下载此版本
查看更多
平台兼容性
uni-app x(4.25)
| Chrome |
Safari |
Android |
iOS |
鸿蒙 |
微信小程序 |
| √ |
√ |
√ |
√ |
√ |
√ |
其他
nax-switch
uni-app x 开关,功能覆盖常用场景。
依赖
nax-icon(loading 图标)
nax-ui-theme(CSS 变量 --nax-*,安装时依赖 / 运行时弱依赖)
基础用法
<nax-switch v-model="checked" @change="onChange"></nax-switch>
Props
| 属性 |
类型 |
默认 |
说明 |
| modelValue |
boolean |
false |
开关状态(v-model) |
| disabled |
boolean |
false |
禁用 |
| loading |
boolean |
false |
加载中,阻止切换 |
| size |
string |
md |
sm / md / lg |
| activeColor |
string |
'' |
打开时轨道色;空则 --nax-color-primary |
| inactiveColor |
string |
'' |
关闭时轨道色;空则 --nax-color-border |
| vibrateShort |
boolean |
false |
切换时短震动(App / 微信小程序等) |
| customClass |
string |
'' |
根节点扩展 class |
Events
| 事件 |
说明 |
| update:modelValue |
v-model |
| change |
状态变化(boolean) |
主题
通过 CSS 变量覆盖:
| Token |
用途 |
--nax-color-bg |
背景色 |
--nax-color-border |
边框色 |
--nax-color-primary |
主题主色 |
--nax-color-text-secondary |
次要文字色 |
--nax-opacity-disabled |
禁用透明度 |