输入与选择 / COMPONENT ATLAS

开关ToggleSwitch

直接开启或关闭一项设置。滑块的位置与主题色共同传达当前状态。

亲手试一试。

01 / LIVE PREVIEW
● ToggleSwitch
接收更新
自动备份

STATES / 示例状态

关闭开启
在左侧预览中体验这枚组件。
INTERACTIVE SPECIMEN · 跟随全站主题

用法

02 / USAGE

下方展示组件的调用方式。

RUST · DIOXUS RSX
let mut enabled = use_signal(|| true);
rsx! {
    ToggleSwitch {
        checked: enabled(),
        aria_label: Some("接收更新".to_string()),
        ontoggle: move |_| enabled.toggle(),
    }
}

主要属性

03 / PROPERTIES
属性 / 类型默认值说明
checkedbool必填当前开关状态。
ontoggleCallback<()>必填点击后通知父组件切换状态。
aria_labelOption<String>None开关的无障碍名称。

操作方式

04 / INTERACTION
Tab移动焦点Space / Enter切换开关
YGGDRASIL · 每一个细节,都有回应。src/components/forms.rs
© 2026 Yggdrasil