Switch

开关用于即时生效的布尔设置。下方预览由 pingo 引擎实时渲染，可以直接点击，并跟随站点主题切换明暗。不传 checked 时组件自己持有状态（defaultChecked 给初始值）；传了 checked 就由调用方持有，组件只负责回调。

用法

import { useSignal, type PingoNode } from "@dopejs/pingo";
import { Switch } from "@dopejs/pingo-ui";

// useSignal 是 hook，必须运行在组件作用域内。
function AirplaneMode(): PingoNode {
  const on = useSignal(false);
  return (
    <Switch checked={on.get()} semanticLabel="飞行模式" onCheckedChange={(next) => on.set(next)} />
  );
}

root.render(<AirplaneMode />);

checked 由父组件持有，onCheckedChange 负责更新它。不需要外部状态时省略 checked，组件会自己记住，与 Slider、Tabs、Collapsible 一致：

<Switch defaultChecked semanticLabel="飞行模式" />

注意受控用法必须真的更新 checked：传了 checked 却忽略 onCheckedChange，开关永远不会动，看上去就像点不动。

示例

禁用

传入 disabled 后开关不再响应指针与键盘，语义值变为 disabled。

Props

无障碍

组件带 switch 语义角色，语义值随状态在 on / off / disabled 间切换。指针按下时自动聚焦。开关没有可见文字，请始终提供 semanticLabel。