Toggle
从 Base Toggle 协议投影出的 Shadcn Toggle。
本页常规演示显式采用 Shadcn Rhea 外观,示例代码保持一致;这不修改公共组件的兼容默认值,也不代表全部浏览器、原生宿主和视觉验收已完成。Surface/Text 等中性原子仍保留各自公开语义,外观主题由消费组合提供。
当前页面展示 Proto UI 中 shadcn 风格的 toggle 条目。
本页 Rhea 配方对照固定 Rhea 样式源码:default/sm/lg 高度为 2rem/1.75rem/2.25rem(16px 根字号),min-width 与高度一致,内边距均为 0.625rem,gap 0.25rem,圆角 rounded-2xl(上游约定为 --radius ×1.8;Proto 当前以 --pui-radius +8px 近似,仅在固定 0.625rem/10px 基础下同为18px,不宣称动态一致);outline 保留 border-input、无 shadow;pressed 使用 muted 表面;hover 使用 foreground 墨色并叠加 muted 表面——该 hover 表面来自同一固定修订的共享 base 配方 hover:bg-muted,对两变体均生效,.cn-toggle-variant-outline 只是重复它,不属于 Proto 自行添加。独立 02cad611 New York 源码 仍保留 36/32/40px 高度、accent active、outline shadow-xs 与 muted-foreground default hover,属于兼容 profile;两者不混称跨宿主已视觉等价。
Toggle 的 active、disabled、键盘与 a11y 仍由 Base 所有。asChild 有意不提供;原生属性/pressed API 别名、invalid 与任意嵌套 SVG 样式仍属兼容性差异。本页和源码测试不等于四 runtime、双主题的原生像素验收。
演示依次是 Bold、已按下的 Italic outline、小号 Underline、禁用且已按下的 Strikethrough、大号文字,以及一个 outline toggle。图标按钮的名称是视觉隐藏的。
使用页首的“预览 Runtime”切换 Web Components、React、Vue 或 Vue 2;窄屏时先打开“导航与设置”。本页示例隐藏自身的 Runtime 工具栏。
npx @proto.ui/cli@latest add wc shadcn-toggle
把 wc 换成 react、vue 或 vue2,即可生成对应宿主的 facade。
传入 active 进入受控模式。
| 属性 | 类型 | 默认值 |
|---|---|---|
active | boolean undefined | 非受控 |
defaultActive | boolean | false |
disabled | boolean | false |
variant | 'default' 'outline' | default |
size | 'default' 'sm' 'lg' | default |
Root 暴露 active、disabled、hovered、focused、focusVisible、pressed,以及 activeChange。