Toggle Group
Switch text alignment with accessible icon buttons and see the content respond.
use blinc_cn as cn;
use blinc_core::reactive::{Signal, computed};
use blinc_layout::prelude::*;
pub fn toggle_group_demo(choice: Signal<String>, disabled: Signal<bool>) -> Div {
let icon = |paths: &str| blinc_icons::to_svg_with_stroke(paths, 18.0, 2.0);
div()
.class("demo-wide")
.child(
div().class("demo-row").child(
cn::toggle_group(choice)
.item(
cn::toggle_item("left")
.icon(icon(blinc_icons::icons::TEXT_ALIGN_START))
.aria_label("Align left"),
)
.item(
cn::toggle_item("center")
.icon(icon(blinc_icons::icons::TEXT_ALIGN_CENTER))
.aria_label("Align center"),
)
.item(
cn::toggle_item("right")
.icon(icon(blinc_icons::icons::TEXT_ALIGN_END))
.aria_label("Align right"),
)
.disabled(disabled),
),
)
.child(
div()
.class("demo-alignment-copy")
.attr_when(
"data-align",
"left",
computed(move |g| g.get(choice).as_deref() == Some("left")),
)
.attr_when(
"data-align",
"right",
computed(move |g| g.get(choice).as_deref() == Some("right")),
)
.child(text("Find the right balance").class("demo-label"))
.child(text("Align the content to suit your layout.").class("demo-caption")),
)
}
@layer components {
.blinc-toggle {
flex-direction: row;
align-items: center;
justify-content: center;
gap: 6px;
height: 36px;
min-width: 36px;
padding: 0 12px;
font-size: var(--text-sm);
font-weight: 500;
border: 1px solid transparent;
border-radius: var(--radius-default);
background: transparent;
color: var(--text-primary);
cursor: pointer;
transition:
background-color var(--duration-fast) var(--ease-state),
border-color var(--duration-fast) var(--ease-state),
transform var(--duration-faster) var(--ease-state);
}
.blinc-toggle:hover:not(:disabled) {
background: color-mix(in srgb, var(--text-primary) 5%, transparent);
}
.blinc-toggle:active:not(:disabled) {
background: color-mix(in srgb, var(--text-primary) 10%, transparent);
transform: scale(0.97);
}
.blinc-toggle[data-state="on"] {
background: color-mix(in srgb, var(--text-primary) 10%, var(--background));
}
.blinc-toggle[data-state="on"]:hover:not(:disabled) {
background: color-mix(in srgb, var(--text-primary) 14%, var(--background));
}
.blinc-toggle:disabled {
opacity: 0.5;
cursor: not-allowed;
}
.blinc-toggle[data-variant="outline"],
.blinc-toggle-group[data-variant="outline"] > .blinc-toggle {
border-color: var(--border-secondary);
}
.blinc-toggle[data-size="sm"],
.blinc-toggle-group[data-size="sm"] > .blinc-toggle {
height: 32px;
min-width: 32px;
padding: 0 8px;
font-size: var(--text-xs);
border-radius: var(--radius-sm);
}
.blinc-toggle[data-size="lg"],
.blinc-toggle-group[data-size="lg"] > .blinc-toggle {
height: 40px;
min-width: 40px;
padding: 0 16px;
font-size: var(--text-base);
}
.blinc-toggle > svg {
flex-shrink: 0;
}
.blinc-toggle-group {
flex-direction: row;
align-items: center;
gap: 4px;
}
.cn-toggle {
font-family: var(--font-sans);
}
.cn-toggle:focus-visible {
outline: 2px solid var(--focus-ring);
outline-offset: 2px;
}
.cn-toggle[data-state="on"] {
background: var(--cn-toggle-selected-bg, color-mix(in srgb, var(--text-primary) 10%, var(--background))) !important;
color: var(--cn-toggle-selected-color, var(--text-primary)) !important;
}
.cn-toggle[data-state="on"]:hover:not(:disabled) {
background: var(--cn-toggle-selected-hover-bg, color-mix(in srgb, var(--text-primary) 14%, var(--background))) !important;
}
}
Usage and properties
Choose one item in a compact group of toggle buttons. Apply CSS after the component layer to restyle the documented parts.
Use the installation guide to add blinc_cn and its component stylesheet. Create the fixture bindings once, and return the demo from your UI builder. Values marked Bound accept Signal/Computed sources where the API supports them; structural options configure the component at construction.
| Property | Type | Update model | This example |
|---|---|---|---|
value | Signal<String> | Bound | values.choice |
item | ToggleItem | Construction | TS / Rust / Py |
disabled | bool or IntoReactive<bool> | Bound | values.disabled |
Keyboard and interaction
Tab reaches each toggle; Enter or Space selects it. :focus-visible marks keyboard focus.
Customizing it
Add application CSS after the default component layer. These selectors are the restyling surface for this component:
.cn-toggle-group.cn-toggle
Theme and component variables: --primary, --text-primary, --text-secondary, --surface, --border, --radius-default, --duration-fast, --ease-state.
Built-in themes
The Live theme control installs Blinc's own theme bundles, including their colours, focus rings, corner shapes and motion tokens.
pub fn theme_bundle_for(name: &str) -> blinc_theme::ThemeBundle {
match name {
"restrained" => blinc_theme::RestrainedTheme::bundle(),
"expressive" => blinc_theme::ExpressiveTheme::bundle(),
_ => blinc_theme::HybridTheme::bundle(),
}
.with_css(blinc_cn::cn_styles::CN_STYLES)
}Download the default widget and component stylesheets. Sample assets and licenses are available in the asset guide.
Documentation
From the canonical component guide.
A row of toggles where one value is selected, such as text alignment. The
group reads and writes a Signal<String>:
let align = ctx.use_signal("left".to_string());
toggle_group(align)
.variant(ToggleVariant::Outline)
.item(toggle_item("left").label("Left"))
.item(toggle_item("center").label("Centre"))
.item(toggle_item("right").label("Right"))
.on_change(|value| println!("align: {value}"))
// Items take an icon too, with or without a label
toggle_item("add").icon(to_svg(icons::PLUS, 16.0)).label("Add")
Clicking the selected item leaves it selected; to clear the selection, set the
signal to "" yourself. .size(..), .disabled(..) for the group (a bool, Signal or Computed) and
toggle_item(..).disabled(true) for one item work as on a toggle.
Each item is a toggle, so the rules above apply to it. The group sets
data-variant and data-size for its items, and its rules (.blinc-toggle-group)
give a 4px gap; .gap(..) overrides it.
Platforms and version
The component API is available in Blinc 0.6.0. The Live example runs in a dedicated worker and requires a compatible GPU surface. Preview and Code remain available when Live cannot start. The canvas has a descriptive label; a full screen-reader DOM mirror is not provided. The gallery integration is based on revision e2e55c24e078.
Recordings and live demos use the default Hybrid theme with bundled Noto Sans. The recording uses a 560 × 320 logical viewport at twice that resolution. Live follows its container and actual display density. Source base revision · Exact build source · Artifact versions and checksums · Font license.