toggle.rs

   1use gpui::{
   2    AnyElement, AnyView, ClickEvent, ElementId, Hsla, IntoElement, Styled, Window, div, hsla,
   3    prelude::*,
   4};
   5use std::{rc::Rc, sync::Arc};
   6
   7use crate::utils::is_light;
   8use crate::{Color, Icon, IconName, ToggleState, Tooltip};
   9use crate::{ElevationIndex, KeyBinding, prelude::*};
  10
  11// TODO: Checkbox, CheckboxWithLabel, and Switch could all be
  12// restructured to use a ToggleLike, similar to Button/Buttonlike, Label/Labellike
  13
  14/// Creates a new checkbox.
  15pub fn checkbox(id: impl Into<ElementId>, toggle_state: ToggleState) -> Checkbox {
  16    Checkbox::new(id, toggle_state)
  17}
  18
  19/// Creates a new switch.
  20pub fn switch(id: impl Into<ElementId>, toggle_state: ToggleState) -> Switch {
  21    Switch::new(id, toggle_state)
  22}
  23
  24/// The visual style of a toggle.
  25#[derive(Debug, Default, Clone, PartialEq, Eq)]
  26pub enum ToggleStyle {
  27    /// Toggle has a transparent background
  28    #[default]
  29    Ghost,
  30    /// Toggle has a filled background based on the
  31    /// elevation index of the parent container
  32    ElevationBased(ElevationIndex),
  33    /// A custom style using a color to tint the toggle
  34    Custom(Hsla),
  35}
  36
  37/// # Checkbox
  38///
  39/// Checkboxes are used for multiple choices, not for mutually exclusive choices.
  40/// Each checkbox works independently from other checkboxes in the list,
  41/// therefore checking an additional box does not affect any other selections.
  42#[derive(IntoElement, RegisterComponent)]
  43pub struct Checkbox {
  44    id: ElementId,
  45    toggle_state: ToggleState,
  46    disabled: bool,
  47    placeholder: bool,
  48    on_click: Option<Box<dyn Fn(&ToggleState, &ClickEvent, &mut Window, &mut App) + 'static>>,
  49    filled: bool,
  50    style: ToggleStyle,
  51    tooltip: Option<Box<dyn Fn(&mut Window, &mut App) -> AnyView>>,
  52    label: Option<SharedString>,
  53}
  54
  55impl Checkbox {
  56    /// Creates a new [`Checkbox`].
  57    pub fn new(id: impl Into<ElementId>, checked: ToggleState) -> Self {
  58        Self {
  59            id: id.into(),
  60            toggle_state: checked,
  61            disabled: false,
  62            on_click: None,
  63            filled: false,
  64            style: ToggleStyle::default(),
  65            tooltip: None,
  66            label: None,
  67            placeholder: false,
  68        }
  69    }
  70
  71    /// Sets the disabled state of the [`Checkbox`].
  72    pub fn disabled(mut self, disabled: bool) -> Self {
  73        self.disabled = disabled;
  74        self
  75    }
  76
  77    /// Sets the disabled state of the [`Checkbox`].
  78    pub fn placeholder(mut self, placeholder: bool) -> Self {
  79        self.placeholder = placeholder;
  80        self
  81    }
  82
  83    /// Binds a handler to the [`Checkbox`] that will be called when clicked.
  84    pub fn on_click(
  85        mut self,
  86        handler: impl Fn(&ToggleState, &mut Window, &mut App) + 'static,
  87    ) -> Self {
  88        self.on_click = Some(Box::new(move |state, _, window, cx| {
  89            handler(state, window, cx)
  90        }));
  91        self
  92    }
  93
  94    pub fn on_click_ext(
  95        mut self,
  96        handler: impl Fn(&ToggleState, &ClickEvent, &mut Window, &mut App) + 'static,
  97    ) -> Self {
  98        self.on_click = Some(Box::new(handler));
  99        self
 100    }
 101
 102    /// Sets the `fill` setting of the checkbox, indicating whether it should be filled.
 103    pub fn fill(mut self) -> Self {
 104        self.filled = true;
 105        self
 106    }
 107
 108    /// Sets the style of the checkbox using the specified [`ToggleStyle`].
 109    pub fn style(mut self, style: ToggleStyle) -> Self {
 110        self.style = style;
 111        self
 112    }
 113
 114    /// Match the style of the checkbox to the current elevation using [`ToggleStyle::ElevationBased`].
 115    pub fn elevation(mut self, elevation: ElevationIndex) -> Self {
 116        self.style = ToggleStyle::ElevationBased(elevation);
 117        self
 118    }
 119
 120    /// Sets the tooltip for the checkbox.
 121    pub fn tooltip(mut self, tooltip: impl Fn(&mut Window, &mut App) -> AnyView + 'static) -> Self {
 122        self.tooltip = Some(Box::new(tooltip));
 123        self
 124    }
 125
 126    /// Set the label for the checkbox.
 127    pub fn label(mut self, label: impl Into<SharedString>) -> Self {
 128        self.label = Some(label.into());
 129        self
 130    }
 131}
 132
 133impl Checkbox {
 134    fn bg_color(&self, cx: &App) -> Hsla {
 135        let style = self.style.clone();
 136        match (style, self.filled) {
 137            (ToggleStyle::Ghost, false) => cx.theme().colors().ghost_element_background,
 138            (ToggleStyle::Ghost, true) => cx.theme().colors().element_background,
 139            (ToggleStyle::ElevationBased(_), false) => gpui::transparent_black(),
 140            (ToggleStyle::ElevationBased(elevation), true) => elevation.darker_bg(cx),
 141            (ToggleStyle::Custom(_), false) => gpui::transparent_black(),
 142            (ToggleStyle::Custom(color), true) => color.opacity(0.2),
 143        }
 144    }
 145
 146    fn border_color(&self, cx: &App) -> Hsla {
 147        if self.disabled {
 148            return cx.theme().colors().border_variant;
 149        }
 150
 151        match self.style.clone() {
 152            ToggleStyle::Ghost => cx.theme().colors().border,
 153            ToggleStyle::ElevationBased(_) => cx.theme().colors().border,
 154            ToggleStyle::Custom(color) => color.opacity(0.3),
 155        }
 156    }
 157
 158    /// container size
 159    pub fn container_size() -> Pixels {
 160        px(20.0)
 161    }
 162}
 163
 164impl RenderOnce for Checkbox {
 165    fn render(self, _: &mut Window, cx: &mut App) -> impl IntoElement {
 166        let group_id = format!("checkbox_group_{:?}", self.id);
 167        let color = if self.disabled {
 168            Color::Disabled
 169        } else {
 170            Color::Selected
 171        };
 172        let icon = match self.toggle_state {
 173            ToggleState::Selected => {
 174                if self.placeholder {
 175                    None
 176                } else {
 177                    Some(
 178                        Icon::new(IconName::Check)
 179                            .size(IconSize::Small)
 180                            .color(color),
 181                    )
 182                }
 183            }
 184            ToggleState::Indeterminate => {
 185                Some(Icon::new(IconName::Dash).size(IconSize::Small).color(color))
 186            }
 187            ToggleState::Unselected => None,
 188        };
 189
 190        let bg_color = self.bg_color(cx);
 191        let border_color = self.border_color(cx);
 192        let hover_border_color = border_color.alpha(0.7);
 193
 194        let size = Self::container_size();
 195
 196        let checkbox = h_flex()
 197            .id(self.id.clone())
 198            .justify_center()
 199            .items_center()
 200            .size(size)
 201            .group(group_id.clone())
 202            .child(
 203                div()
 204                    .flex()
 205                    .flex_none()
 206                    .justify_center()
 207                    .items_center()
 208                    .m_1()
 209                    .size_4()
 210                    .rounded_xs()
 211                    .bg(bg_color)
 212                    .border_1()
 213                    .border_color(border_color)
 214                    .when(self.disabled, |this| this.cursor_not_allowed())
 215                    .when(self.disabled, |this| {
 216                        this.bg(cx.theme().colors().element_disabled.opacity(0.6))
 217                    })
 218                    .when(!self.disabled, |this| {
 219                        this.group_hover(group_id.clone(), |el| el.border_color(hover_border_color))
 220                    })
 221                    .when(self.placeholder, |this| {
 222                        this.child(
 223                            div()
 224                                .flex_none()
 225                                .rounded_full()
 226                                .bg(color.color(cx).alpha(0.5))
 227                                .size(px(4.)),
 228                        )
 229                    })
 230                    .children(icon),
 231            );
 232
 233        h_flex()
 234            .id(self.id)
 235            .gap(DynamicSpacing::Base06.rems(cx))
 236            .child(checkbox)
 237            .when_some(
 238                self.on_click.filter(|_| !self.disabled),
 239                |this, on_click| {
 240                    this.on_click(move |click, window, cx| {
 241                        on_click(&self.toggle_state.inverse(), click, window, cx)
 242                    })
 243                },
 244            )
 245            // TODO: Allow label size to be different from default.
 246            // TODO: Allow label color to be different from muted.
 247            .when_some(self.label, |this, label| {
 248                this.child(Label::new(label).color(Color::Muted))
 249            })
 250            .when_some(self.tooltip, |this, tooltip| {
 251                this.tooltip(move |window, cx| tooltip(window, cx))
 252            })
 253    }
 254}
 255
 256/// A [`Checkbox`] that has a [`Label`].
 257#[derive(IntoElement, RegisterComponent)]
 258pub struct CheckboxWithLabel {
 259    id: ElementId,
 260    label: Label,
 261    checked: ToggleState,
 262    on_click: Arc<dyn Fn(&ToggleState, &mut Window, &mut App) + 'static>,
 263    filled: bool,
 264    style: ToggleStyle,
 265    checkbox_position: IconPosition,
 266}
 267
 268// TODO: Remove `CheckboxWithLabel` now that `label` is a method of `Checkbox`.
 269impl CheckboxWithLabel {
 270    /// Creates a checkbox with an attached label.
 271    pub fn new(
 272        id: impl Into<ElementId>,
 273        label: Label,
 274        checked: ToggleState,
 275        on_click: impl Fn(&ToggleState, &mut Window, &mut App) + 'static,
 276    ) -> Self {
 277        Self {
 278            id: id.into(),
 279            label,
 280            checked,
 281            on_click: Arc::new(on_click),
 282            filled: false,
 283            style: ToggleStyle::default(),
 284            checkbox_position: IconPosition::Start,
 285        }
 286    }
 287
 288    /// Sets the style of the checkbox using the specified [`ToggleStyle`].
 289    pub fn style(mut self, style: ToggleStyle) -> Self {
 290        self.style = style;
 291        self
 292    }
 293
 294    /// Match the style of the checkbox to the current elevation using [`ToggleStyle::ElevationBased`].
 295    pub fn elevation(mut self, elevation: ElevationIndex) -> Self {
 296        self.style = ToggleStyle::ElevationBased(elevation);
 297        self
 298    }
 299
 300    /// Sets the `fill` setting of the checkbox, indicating whether it should be filled.
 301    pub fn fill(mut self) -> Self {
 302        self.filled = true;
 303        self
 304    }
 305
 306    pub fn checkbox_position(mut self, position: IconPosition) -> Self {
 307        self.checkbox_position = position;
 308        self
 309    }
 310}
 311
 312impl RenderOnce for CheckboxWithLabel {
 313    fn render(self, _window: &mut Window, cx: &mut App) -> impl IntoElement {
 314        h_flex()
 315            .gap(DynamicSpacing::Base08.rems(cx))
 316            .when(self.checkbox_position == IconPosition::Start, |this| {
 317                this.child(
 318                    Checkbox::new(self.id.clone(), self.checked)
 319                        .style(self.style.clone())
 320                        .when(self.filled, Checkbox::fill)
 321                        .on_click({
 322                            let on_click = self.on_click.clone();
 323                            move |checked, window, cx| {
 324                                (on_click)(checked, window, cx);
 325                            }
 326                        }),
 327                )
 328            })
 329            .child(
 330                div()
 331                    .id(SharedString::from(format!("{}-label", self.id)))
 332                    .on_click({
 333                        let on_click = self.on_click.clone();
 334                        move |_event, window, cx| {
 335                            (on_click)(&self.checked.inverse(), window, cx);
 336                        }
 337                    })
 338                    .child(self.label),
 339            )
 340            .when(self.checkbox_position == IconPosition::End, |this| {
 341                this.child(
 342                    Checkbox::new(self.id.clone(), self.checked)
 343                        .style(self.style)
 344                        .when(self.filled, Checkbox::fill)
 345                        .on_click(move |checked, window, cx| {
 346                            (self.on_click)(checked, window, cx);
 347                        }),
 348                )
 349            })
 350    }
 351}
 352
 353/// Defines the color for a switch component.
 354#[derive(Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Clone, Copy, Default)]
 355pub enum SwitchColor {
 356    #[default]
 357    Default,
 358    Accent,
 359    Error,
 360    Warning,
 361    Success,
 362    Custom(Hsla),
 363}
 364
 365impl SwitchColor {
 366    fn get_colors(&self, is_on: bool, cx: &App) -> (Hsla, Hsla) {
 367        if !is_on {
 368            return (
 369                cx.theme().colors().element_disabled,
 370                cx.theme().colors().border,
 371            );
 372        }
 373
 374        match self {
 375            SwitchColor::Default => {
 376                let colors = cx.theme().colors();
 377                let base_color = colors.text;
 378                let bg_color = colors.element_background.blend(base_color.opacity(0.08));
 379                (bg_color, colors.border_variant)
 380            }
 381            SwitchColor::Accent => {
 382                let status = cx.theme().status();
 383                (status.info.opacity(0.4), status.info.opacity(0.2))
 384            }
 385            SwitchColor::Error => {
 386                let status = cx.theme().status();
 387                (status.error.opacity(0.4), status.error.opacity(0.2))
 388            }
 389            SwitchColor::Warning => {
 390                let status = cx.theme().status();
 391                (status.warning.opacity(0.4), status.warning.opacity(0.2))
 392            }
 393            SwitchColor::Success => {
 394                let status = cx.theme().status();
 395                (status.success.opacity(0.4), status.success.opacity(0.2))
 396            }
 397            SwitchColor::Custom(color) => (*color, color.opacity(0.6)),
 398        }
 399    }
 400}
 401
 402impl From<SwitchColor> for Color {
 403    fn from(color: SwitchColor) -> Self {
 404        match color {
 405            SwitchColor::Default => Color::Default,
 406            SwitchColor::Accent => Color::Accent,
 407            SwitchColor::Error => Color::Error,
 408            SwitchColor::Warning => Color::Warning,
 409            SwitchColor::Success => Color::Success,
 410            SwitchColor::Custom(_) => Color::Default,
 411        }
 412    }
 413}
 414
 415/// # Switch
 416///
 417/// Switches are used to represent opposite states, such as enabled or disabled.
 418#[derive(IntoElement, RegisterComponent)]
 419pub struct Switch {
 420    id: ElementId,
 421    toggle_state: ToggleState,
 422    disabled: bool,
 423    on_click: Option<Box<dyn Fn(&ToggleState, &mut Window, &mut App) + 'static>>,
 424    label: Option<SharedString>,
 425    key_binding: Option<KeyBinding>,
 426    color: SwitchColor,
 427    tab_index: Option<isize>,
 428}
 429
 430impl Switch {
 431    /// Creates a new [`Switch`].
 432    pub fn new(id: impl Into<ElementId>, state: ToggleState) -> Self {
 433        Self {
 434            id: id.into(),
 435            toggle_state: state,
 436            disabled: false,
 437            on_click: None,
 438            label: None,
 439            key_binding: None,
 440            color: SwitchColor::default(),
 441            tab_index: None,
 442        }
 443    }
 444
 445    /// Sets the color of the switch using the specified [`SwitchColor`].
 446    pub fn color(mut self, color: SwitchColor) -> Self {
 447        self.color = color;
 448        self
 449    }
 450
 451    /// Sets the disabled state of the [`Switch`].
 452    pub fn disabled(mut self, disabled: bool) -> Self {
 453        self.disabled = disabled;
 454        self
 455    }
 456
 457    /// Binds a handler to the [`Switch`] that will be called when clicked.
 458    pub fn on_click(
 459        mut self,
 460        handler: impl Fn(&ToggleState, &mut Window, &mut App) + 'static,
 461    ) -> Self {
 462        self.on_click = Some(Box::new(handler));
 463        self
 464    }
 465
 466    /// Sets the label of the [`Switch`].
 467    pub fn label(mut self, label: impl Into<SharedString>) -> Self {
 468        self.label = Some(label.into());
 469        self
 470    }
 471
 472    /// Display the keybinding that triggers the switch action.
 473    pub fn key_binding(mut self, key_binding: impl Into<Option<KeyBinding>>) -> Self {
 474        self.key_binding = key_binding.into();
 475        self
 476    }
 477
 478    pub fn tab_index(mut self, tab_index: impl Into<isize>) -> Self {
 479        self.tab_index = Some(tab_index.into());
 480        self
 481    }
 482}
 483
 484impl RenderOnce for Switch {
 485    fn render(self, _window: &mut Window, cx: &mut App) -> impl IntoElement {
 486        let is_on = self.toggle_state == ToggleState::Selected;
 487        let adjust_ratio = if is_light(cx) { 1.5 } else { 1.0 };
 488
 489        let base_color = cx.theme().colors().text;
 490        let thumb_color = base_color;
 491        let (bg_color, border_color) = self.color.get_colors(is_on, cx);
 492
 493        let bg_hover_color = if is_on {
 494            bg_color.blend(base_color.opacity(0.16 * adjust_ratio))
 495        } else {
 496            bg_color.blend(base_color.opacity(0.05 * adjust_ratio))
 497        };
 498
 499        let thumb_opacity = match (is_on, self.disabled) {
 500            (_, true) => 0.2,
 501            (true, false) => 1.0,
 502            (false, false) => 0.5,
 503        };
 504
 505        let group_id = format!("switch_group_{:?}", self.id);
 506
 507        let switch = div()
 508            .id((self.id.clone(), "switch"))
 509            .p(px(1.0))
 510            .border_2()
 511            .border_color(cx.theme().colors().border_transparent)
 512            .rounded_full()
 513            .when_some(
 514                self.tab_index.filter(|_| !self.disabled),
 515                |this, tab_index| {
 516                    this.tab_index(tab_index).focus(|mut style| {
 517                        style.border_color = Some(cx.theme().colors().border_focused);
 518                        style
 519                    })
 520                },
 521            )
 522            .child(
 523                h_flex()
 524                    .w(DynamicSpacing::Base32.rems(cx))
 525                    .h(DynamicSpacing::Base20.rems(cx))
 526                    .group(group_id.clone())
 527                    .child(
 528                        h_flex()
 529                            .when(is_on, |on| on.justify_end())
 530                            .when(!is_on, |off| off.justify_start())
 531                            .size_full()
 532                            .rounded_full()
 533                            .px(DynamicSpacing::Base02.px(cx))
 534                            .bg(bg_color)
 535                            .when(!self.disabled, |this| {
 536                                this.group_hover(group_id.clone(), |el| el.bg(bg_hover_color))
 537                            })
 538                            .border_1()
 539                            .border_color(border_color)
 540                            .child(
 541                                div()
 542                                    .size(DynamicSpacing::Base12.rems(cx))
 543                                    .rounded_full()
 544                                    .bg(thumb_color)
 545                                    .opacity(thumb_opacity),
 546                            ),
 547                    ),
 548            );
 549
 550        h_flex()
 551            .id(self.id)
 552            .gap(DynamicSpacing::Base06.rems(cx))
 553            .cursor_pointer()
 554            .child(switch)
 555            .when_some(
 556                self.on_click.filter(|_| !self.disabled),
 557                |this, on_click| {
 558                    this.on_click(move |_, window, cx| {
 559                        on_click(&self.toggle_state.inverse(), window, cx)
 560                    })
 561                },
 562            )
 563            .when_some(self.label, |this, label| {
 564                this.child(Label::new(label).size(LabelSize::Small))
 565            })
 566            .children(self.key_binding)
 567    }
 568}
 569
 570/// # SwitchField
 571///
 572/// A field component that combines a label, description, and switch into one reusable component.
 573///
 574/// # Examples
 575///
 576/// ```
 577/// use ui::prelude::*;
 578///
 579/// SwitchField::new(
 580///     "feature-toggle",
 581///     "Enable feature",
 582///     "This feature adds new functionality to the app.",
 583///     ToggleState::Unselected,
 584///     |state, window, cx| {
 585///         // Logic here
 586///     }
 587/// );
 588/// ```
 589#[derive(IntoElement, RegisterComponent)]
 590pub struct SwitchField {
 591    id: ElementId,
 592    label: SharedString,
 593    description: Option<SharedString>,
 594    toggle_state: ToggleState,
 595    on_click: Arc<dyn Fn(&ToggleState, &mut Window, &mut App) + 'static>,
 596    disabled: bool,
 597    color: SwitchColor,
 598    tooltip: Option<Rc<dyn Fn(&mut Window, &mut App) -> AnyView>>,
 599    tab_index: Option<isize>,
 600}
 601
 602impl SwitchField {
 603    pub fn new(
 604        id: impl Into<ElementId>,
 605        label: impl Into<SharedString>,
 606        description: Option<SharedString>,
 607        toggle_state: impl Into<ToggleState>,
 608        on_click: impl Fn(&ToggleState, &mut Window, &mut App) + 'static,
 609    ) -> Self {
 610        Self {
 611            id: id.into(),
 612            label: label.into(),
 613            description: description,
 614            toggle_state: toggle_state.into(),
 615            on_click: Arc::new(on_click),
 616            disabled: false,
 617            color: SwitchColor::Accent,
 618            tooltip: None,
 619            tab_index: None,
 620        }
 621    }
 622
 623    pub fn description(mut self, description: impl Into<SharedString>) -> Self {
 624        self.description = Some(description.into());
 625        self
 626    }
 627
 628    pub fn disabled(mut self, disabled: bool) -> Self {
 629        self.disabled = disabled;
 630        self
 631    }
 632
 633    /// Sets the color of the switch using the specified [`SwitchColor`].
 634    /// This changes the color scheme of the switch when it's in the "on" state.
 635    pub fn color(mut self, color: SwitchColor) -> Self {
 636        self.color = color;
 637        self
 638    }
 639
 640    pub fn tooltip(mut self, tooltip: impl Fn(&mut Window, &mut App) -> AnyView + 'static) -> Self {
 641        self.tooltip = Some(Rc::new(tooltip));
 642        self
 643    }
 644
 645    pub fn tab_index(mut self, tab_index: isize) -> Self {
 646        self.tab_index = Some(tab_index);
 647        self
 648    }
 649}
 650
 651impl RenderOnce for SwitchField {
 652    fn render(self, _window: &mut Window, _cx: &mut App) -> impl IntoElement {
 653        let tooltip = self.tooltip.map(|tooltip_fn| {
 654            h_flex()
 655                .gap_0p5()
 656                .child(Label::new(self.label.clone()))
 657                .child(
 658                    IconButton::new("tooltip_button", IconName::Info)
 659                        .icon_size(IconSize::XSmall)
 660                        .icon_color(Color::Muted)
 661                        .shape(crate::IconButtonShape::Square)
 662                        .style(ButtonStyle::Transparent)
 663                        .tooltip({
 664                            let tooltip = tooltip_fn.clone();
 665                            move |window, cx| tooltip(window, cx)
 666                        })
 667                        .on_click(|_, _, _| {}), // Intentional empty on click handler so that clicking on the info tooltip icon doesn't trigger the switch toggle
 668                )
 669        });
 670
 671        h_flex()
 672            .id((self.id.clone(), "container"))
 673            .when(!self.disabled, |this| {
 674                this.hover(|this| this.cursor_pointer())
 675            })
 676            .w_full()
 677            .gap_4()
 678            .justify_between()
 679            .flex_wrap()
 680            .child(match (&self.description, tooltip) {
 681                (Some(description), Some(tooltip)) => v_flex()
 682                    .gap_0p5()
 683                    .max_w_5_6()
 684                    .child(tooltip)
 685                    .child(Label::new(description.clone()).color(Color::Muted))
 686                    .into_any_element(),
 687                (Some(description), None) => v_flex()
 688                    .gap_0p5()
 689                    .max_w_5_6()
 690                    .child(Label::new(self.label.clone()))
 691                    .child(Label::new(description.clone()).color(Color::Muted))
 692                    .into_any_element(),
 693                (None, Some(tooltip)) => tooltip.into_any_element(),
 694                (None, None) => Label::new(self.label.clone()).into_any_element(),
 695            })
 696            .child(
 697                Switch::new((self.id.clone(), "switch"), self.toggle_state)
 698                    .color(self.color)
 699                    .disabled(self.disabled)
 700                    .when_some(
 701                        self.tab_index.filter(|_| !self.disabled),
 702                        |this, tab_index| this.tab_index(tab_index),
 703                    )
 704                    .on_click({
 705                        let on_click = self.on_click.clone();
 706                        move |state, window, cx| {
 707                            (on_click)(state, window, cx);
 708                        }
 709                    }),
 710            )
 711            .when(!self.disabled, |this| {
 712                this.on_click({
 713                    let on_click = self.on_click.clone();
 714                    let toggle_state = self.toggle_state;
 715                    move |_click, window, cx| {
 716                        (on_click)(&toggle_state.inverse(), window, cx);
 717                    }
 718                })
 719            })
 720    }
 721}
 722
 723impl Component for SwitchField {
 724    fn scope() -> ComponentScope {
 725        ComponentScope::Input
 726    }
 727
 728    fn description() -> Option<&'static str> {
 729        Some("A field component that combines a label, description, and switch")
 730    }
 731
 732    fn preview(_window: &mut Window, _cx: &mut App) -> Option<AnyElement> {
 733        Some(
 734            v_flex()
 735                .gap_6()
 736                .children(vec![
 737                    example_group_with_title(
 738                        "States",
 739                        vec![
 740                            single_example(
 741                                "Unselected",
 742                                SwitchField::new(
 743                                    "switch_field_unselected",
 744                                    "Enable notifications",
 745                                    Some("Receive notifications when new messages arrive.".into()),
 746                                    ToggleState::Unselected,
 747                                    |_, _, _| {},
 748                                )
 749                                .into_any_element(),
 750                            ),
 751                            single_example(
 752                                "Selected",
 753                                SwitchField::new(
 754                                    "switch_field_selected",
 755                                    "Enable notifications",
 756                                    Some("Receive notifications when new messages arrive.".into()),
 757                                    ToggleState::Selected,
 758                                    |_, _, _| {},
 759                                )
 760                                .into_any_element(),
 761                            ),
 762                        ],
 763                    ),
 764                    example_group_with_title(
 765                        "Colors",
 766                        vec![
 767                            single_example(
 768                                "Default",
 769                                SwitchField::new(
 770                                    "switch_field_default",
 771                                    "Default color",
 772                                    Some("This uses the default switch color.".into()),
 773                                    ToggleState::Selected,
 774                                    |_, _, _| {},
 775                                )
 776                                .into_any_element(),
 777                            ),
 778                            single_example(
 779                                "Accent",
 780                                SwitchField::new(
 781                                    "switch_field_accent",
 782                                    "Accent color",
 783                                    Some("This uses the accent color scheme.".into()),
 784                                    ToggleState::Selected,
 785                                    |_, _, _| {},
 786                                )
 787                                .color(SwitchColor::Accent)
 788                                .into_any_element(),
 789                            ),
 790                        ],
 791                    ),
 792                    example_group_with_title(
 793                        "Disabled",
 794                        vec![single_example(
 795                            "Disabled",
 796                            SwitchField::new(
 797                                "switch_field_disabled",
 798                                "Disabled field",
 799                                Some("This field is disabled and cannot be toggled.".into()),
 800                                ToggleState::Selected,
 801                                |_, _, _| {},
 802                            )
 803                            .disabled(true)
 804                            .into_any_element(),
 805                        )],
 806                    ),
 807                    example_group_with_title(
 808                        "No Description",
 809                        vec![single_example(
 810                            "No Description",
 811                            SwitchField::new(
 812                                "switch_field_disabled",
 813                                "Disabled field",
 814                                None,
 815                                ToggleState::Selected,
 816                                |_, _, _| {},
 817                            )
 818                            .into_any_element(),
 819                        )],
 820                    ),
 821                    example_group_with_title(
 822                        "With Tooltip",
 823                        vec![
 824                            single_example(
 825                                "Tooltip with Description",
 826                                SwitchField::new(
 827                                    "switch_field_tooltip_with_desc",
 828                                    "Nice Feature",
 829                                    Some("Enable advanced configuration options.".into()),
 830                                    ToggleState::Unselected,
 831                                    |_, _, _| {},
 832                                )
 833                                .tooltip(Tooltip::text("This is content for this tooltip!"))
 834                                .into_any_element(),
 835                            ),
 836                            single_example(
 837                                "Tooltip without Description",
 838                                SwitchField::new(
 839                                    "switch_field_tooltip_no_desc",
 840                                    "Nice Feature",
 841                                    None,
 842                                    ToggleState::Selected,
 843                                    |_, _, _| {},
 844                                )
 845                                .tooltip(Tooltip::text("This is content for this tooltip!"))
 846                                .into_any_element(),
 847                            ),
 848                        ],
 849                    ),
 850                ])
 851                .into_any_element(),
 852        )
 853    }
 854}
 855
 856impl Component for Checkbox {
 857    fn scope() -> ComponentScope {
 858        ComponentScope::Input
 859    }
 860
 861    fn description() -> Option<&'static str> {
 862        Some("A checkbox component that can be used for multiple choice selections")
 863    }
 864
 865    fn preview(_window: &mut Window, _cx: &mut App) -> Option<AnyElement> {
 866        Some(
 867            v_flex()
 868                .gap_6()
 869                .children(vec![
 870                    example_group_with_title(
 871                        "States",
 872                        vec![
 873                            single_example(
 874                                "Unselected",
 875                                Checkbox::new("checkbox_unselected", ToggleState::Unselected)
 876                                    .into_any_element(),
 877                            ),
 878                            single_example(
 879                                "Placeholder",
 880                                Checkbox::new("checkbox_indeterminate", ToggleState::Selected)
 881                                    .placeholder(true)
 882                                    .into_any_element(),
 883                            ),
 884                            single_example(
 885                                "Indeterminate",
 886                                Checkbox::new("checkbox_indeterminate", ToggleState::Indeterminate)
 887                                    .into_any_element(),
 888                            ),
 889                            single_example(
 890                                "Selected",
 891                                Checkbox::new("checkbox_selected", ToggleState::Selected)
 892                                    .into_any_element(),
 893                            ),
 894                        ],
 895                    ),
 896                    example_group_with_title(
 897                        "Styles",
 898                        vec![
 899                            single_example(
 900                                "Default",
 901                                Checkbox::new("checkbox_default", ToggleState::Selected)
 902                                    .into_any_element(),
 903                            ),
 904                            single_example(
 905                                "Filled",
 906                                Checkbox::new("checkbox_filled", ToggleState::Selected)
 907                                    .fill()
 908                                    .into_any_element(),
 909                            ),
 910                            single_example(
 911                                "ElevationBased",
 912                                Checkbox::new("checkbox_elevation", ToggleState::Selected)
 913                                    .style(ToggleStyle::ElevationBased(
 914                                        ElevationIndex::EditorSurface,
 915                                    ))
 916                                    .into_any_element(),
 917                            ),
 918                            single_example(
 919                                "Custom Color",
 920                                Checkbox::new("checkbox_custom", ToggleState::Selected)
 921                                    .style(ToggleStyle::Custom(hsla(142.0 / 360., 0.68, 0.45, 0.7)))
 922                                    .into_any_element(),
 923                            ),
 924                        ],
 925                    ),
 926                    example_group_with_title(
 927                        "Disabled",
 928                        vec![
 929                            single_example(
 930                                "Unselected",
 931                                Checkbox::new(
 932                                    "checkbox_disabled_unselected",
 933                                    ToggleState::Unselected,
 934                                )
 935                                .disabled(true)
 936                                .into_any_element(),
 937                            ),
 938                            single_example(
 939                                "Selected",
 940                                Checkbox::new("checkbox_disabled_selected", ToggleState::Selected)
 941                                    .disabled(true)
 942                                    .into_any_element(),
 943                            ),
 944                        ],
 945                    ),
 946                    example_group_with_title(
 947                        "With Label",
 948                        vec![single_example(
 949                            "Default",
 950                            Checkbox::new("checkbox_with_label", ToggleState::Selected)
 951                                .label("Always save on quit")
 952                                .into_any_element(),
 953                        )],
 954                    ),
 955                ])
 956                .into_any_element(),
 957        )
 958    }
 959}
 960
 961impl Component for Switch {
 962    fn scope() -> ComponentScope {
 963        ComponentScope::Input
 964    }
 965
 966    fn description() -> Option<&'static str> {
 967        Some("A switch component that represents binary states like on/off")
 968    }
 969
 970    fn preview(_window: &mut Window, _cx: &mut App) -> Option<AnyElement> {
 971        Some(
 972            v_flex()
 973                .gap_6()
 974                .children(vec![
 975                    example_group_with_title(
 976                        "States",
 977                        vec![
 978                            single_example(
 979                                "Off",
 980                                Switch::new("switch_off", ToggleState::Unselected)
 981                                    .on_click(|_, _, _cx| {})
 982                                    .into_any_element(),
 983                            ),
 984                            single_example(
 985                                "On",
 986                                Switch::new("switch_on", ToggleState::Selected)
 987                                    .on_click(|_, _, _cx| {})
 988                                    .into_any_element(),
 989                            ),
 990                        ],
 991                    ),
 992                    example_group_with_title(
 993                        "Colors",
 994                        vec![
 995                            single_example(
 996                                "Default",
 997                                Switch::new("switch_default_style", ToggleState::Selected)
 998                                    .color(SwitchColor::Default)
 999                                    .on_click(|_, _, _cx| {})
1000                                    .into_any_element(),
1001                            ),
1002                            single_example(
1003                                "Accent",
1004                                Switch::new("switch_accent_style", ToggleState::Selected)
1005                                    .color(SwitchColor::Accent)
1006                                    .on_click(|_, _, _cx| {})
1007                                    .into_any_element(),
1008                            ),
1009                            single_example(
1010                                "Error",
1011                                Switch::new("switch_error_style", ToggleState::Selected)
1012                                    .color(SwitchColor::Error)
1013                                    .on_click(|_, _, _cx| {})
1014                                    .into_any_element(),
1015                            ),
1016                            single_example(
1017                                "Warning",
1018                                Switch::new("switch_warning_style", ToggleState::Selected)
1019                                    .color(SwitchColor::Warning)
1020                                    .on_click(|_, _, _cx| {})
1021                                    .into_any_element(),
1022                            ),
1023                            single_example(
1024                                "Success",
1025                                Switch::new("switch_success_style", ToggleState::Selected)
1026                                    .color(SwitchColor::Success)
1027                                    .on_click(|_, _, _cx| {})
1028                                    .into_any_element(),
1029                            ),
1030                            single_example(
1031                                "Custom",
1032                                Switch::new("switch_custom_style", ToggleState::Selected)
1033                                    .color(SwitchColor::Custom(hsla(300.0 / 360.0, 0.6, 0.6, 1.0)))
1034                                    .on_click(|_, _, _cx| {})
1035                                    .into_any_element(),
1036                            ),
1037                        ],
1038                    ),
1039                    example_group_with_title(
1040                        "Disabled",
1041                        vec![
1042                            single_example(
1043                                "Off",
1044                                Switch::new("switch_disabled_off", ToggleState::Unselected)
1045                                    .disabled(true)
1046                                    .into_any_element(),
1047                            ),
1048                            single_example(
1049                                "On",
1050                                Switch::new("switch_disabled_on", ToggleState::Selected)
1051                                    .disabled(true)
1052                                    .into_any_element(),
1053                            ),
1054                        ],
1055                    ),
1056                    example_group_with_title(
1057                        "With Label",
1058                        vec![
1059                            single_example(
1060                                "Label",
1061                                Switch::new("switch_with_label", ToggleState::Selected)
1062                                    .label("Always save on quit")
1063                                    .into_any_element(),
1064                            ),
1065                            // TODO: Where did theme_preview_keybinding go?
1066                            // single_example(
1067                            //     "Keybinding",
1068                            //     Switch::new("switch_with_keybinding", ToggleState::Selected)
1069                            //         .key_binding(theme_preview_keybinding("cmd-shift-e"))
1070                            //         .into_any_element(),
1071                            // ),
1072                        ],
1073                    ),
1074                ])
1075                .into_any_element(),
1076        )
1077    }
1078}
1079
1080impl Component for CheckboxWithLabel {
1081    fn scope() -> ComponentScope {
1082        ComponentScope::Input
1083    }
1084
1085    fn description() -> Option<&'static str> {
1086        Some("A checkbox component with an attached label")
1087    }
1088
1089    fn preview(_window: &mut Window, _cx: &mut App) -> Option<AnyElement> {
1090        Some(
1091            v_flex()
1092                .gap_6()
1093                .children(vec![example_group_with_title(
1094                    "States",
1095                    vec![
1096                        single_example(
1097                            "Unselected",
1098                            CheckboxWithLabel::new(
1099                                "checkbox_with_label_unselected",
1100                                Label::new("Always save on quit"),
1101                                ToggleState::Unselected,
1102                                |_, _, _| {},
1103                            )
1104                            .into_any_element(),
1105                        ),
1106                        single_example(
1107                            "Indeterminate",
1108                            CheckboxWithLabel::new(
1109                                "checkbox_with_label_indeterminate",
1110                                Label::new("Always save on quit"),
1111                                ToggleState::Indeterminate,
1112                                |_, _, _| {},
1113                            )
1114                            .into_any_element(),
1115                        ),
1116                        single_example(
1117                            "Selected",
1118                            CheckboxWithLabel::new(
1119                                "checkbox_with_label_selected",
1120                                Label::new("Always save on quit"),
1121                                ToggleState::Selected,
1122                                |_, _, _| {},
1123                            )
1124                            .into_any_element(),
1125                        ),
1126                    ],
1127                )])
1128                .into_any_element(),
1129        )
1130    }
1131}