Checkbox

Checkbox 是一个用于二元选择的复选框组件，支持标签、禁用状态和不同文字尺寸。

使用 on_change 接收请求的新值，由状态所有者保存并调用 cx.notify()。原有的 on_click 保留为兼容名称；两者设置的是同一个回调，最后一次设置生效。

#导入

use gpui_kit::component::checkbox::Checkbox;

#用法

#基础 Checkbox

Checkbox::new("my-checkbox")
    .label("Accept terms and conditions")
    .checked(false)
    .on_change(|checked, _, _| {
        println!("Checkbox is now: {}", checked);
    })

on_change 会在用户切换状态时触发，接收到的是切换后的新状态。

#受控 Checkbox

struct MyView {
    is_checked: bool,
}

impl Render for MyView {
    fn render(&mut self, _: &mut Window, cx: &mut Context<Self>) -> impl IntoElement {
        Checkbox::new("checkbox")
            .label("Option")
            .checked(self.is_checked)
            .on_change(cx.listener(|view, checked, _, cx| {
                view.is_checked = *checked;
                cx.notify();
            }))
    }
}

#不同尺寸

Checkbox::new("cb").text_xs().label("Extra Small")
Checkbox::new("cb").text_sm().label("Small")
Checkbox::new("cb").label("Medium")
Checkbox::new("cb").text_lg().label("Large")

#禁用状态

Checkbox::new("checkbox")
    .label("Disabled checkbox")
    .disabled(true)
    .checked(false)

#不带标签

Checkbox::new("checkbox")
    .checked(true)

#自定义 Tab 顺序

Checkbox::new("checkbox")
    .label("Custom tab order")
    .tab_index(2)
    .tab_stop(true)

#API 参考

• Checkbox

#样式

实现了 Sizable 和 Disableable trait：

• text_xs()：超小字号
• text_sm()：小字号
• text_base()：默认字号
• text_lg()：大字号
• disabled(bool)：禁用状态

#示例

#复选框列表

v_flex()
    .gap_2()
    .child(Checkbox::new("cb1").label("Option 1").checked(true))
    .child(Checkbox::new("cb2").label("Option 2").checked(false))
    .child(Checkbox::new("cb3").label("Option 3").checked(false))

#表单集成

struct FormView {
    agree_terms: bool,
    subscribe: bool,
}

v_flex()
    .gap_3()
    .child(
        Checkbox::new("terms")
            .label("I agree to the terms and conditions")
            .checked(self.agree_terms)
            .on_change(cx.listener(|view, checked, _, cx| {
                view.agree_terms = *checked;
                cx.notify();
            }))
    )
    .child(
        Checkbox::new("subscribe")
            .label("Subscribe to newsletter")
            .checked(self.subscribe)
            .on_change(cx.listener(|view, checked, _, cx| {
                view.subscribe = *checked;
                cx.notify();
            }))
    )