Switch
基于 Proto UI 重构的 Shadcn Switch。
本页常规演示显式采用 Shadcn Rhea 外观,示例代码保持一致;这不修改公共组件的兼容默认值,也不代表全部浏览器、原生宿主和视觉验收已完成。Surface/Text 等中性原子仍保留各自公开语义,外观主题由消费组合提供。
当前页面展示 Proto UI 中 shadcn 风格的 switch 条目。
在 Root 上设置 size="sm" 使用小尺寸;省略 size 或设置 size="default" 使用默认尺寸。Thumb 从实际所属的逻辑 Switch Root 派生尺寸,没有独立 size prop。尺寸变化不会改变 checked 值或发出 checkedChange。
本页 Rhea 配方的默认Root为2rem × 1.25rem,小号为1.5rem × 1rem,Thumb分别为1rem/0.75rem,使用2px透明边框与家族radius-2xl;选中位移为Thumb宽减4px。来源为 Rhea 样式源码。独立 02cad611 New York源码 仍保留2rem × 1.15rem / 1.5rem × 0.875rem与减2px位移,属于兼容profile;两者不混称跨宿主已视觉等价。
组合与可选拖动能力
Section titled “组合与可选拖动能力”默认 Switch 组合保持点击/Space 激活,拖动仅由 draggable: true 明确开启,不改上游默认。上方尺寸示例只有“Email alerts”启用拖动;下方两个独立增强示例分别展示 LTR 和 RTL 拖动。
下方真实页面组合复用现有 Field 的 Label、Description 和 Switch owner。Choice Card 的卡片空白区域可点击,但不创建第二个按钮或转发 click;卡内“Learn more”链接保持自己的操作。卡片选中色跟随已接受的 checked 值,受控 owner 拒绝请求时不乐观变色。disabled 和 readOnly 示例不得发出改值请求。
上游Choice Card anatomy由 FieldLabel 包住 Field。Proto 保留自己的 Field anatomy 和独立 description 关联,不导入该框架,也不改变当前样式 profile。这不是 Liquid Glass Switch 的实现。
npx @proto.ui/cli@latest add wc shadcn-switch
把 wc 换成 react、vue 或 vue2,即可生成对应宿主的 facade。
传入 checked 进入受控模式。
| 属性 | 类型 | 默认值 |
|---|---|---|
checked | boolean undefined | 非受控 |
defaultChecked | boolean | false |
disabled | boolean | false |
draggable | boolean | false |
direction | 'ltr' 'rtl' | ltr |
size | 'default' 'sm' | default |
size 是 Shadcn 的呈现属性。Thumb 没有属性。Root 仍是 checked 的唯一 owner。