id: toolbar
label: Toolbar
family: family-d-navigation
category: Layout
intent: Action toolbar region
description: Action toolbar component
composable: true
capabilities:
required_parts: []
optional_parts: []
tags: ["toolbar", "bar", "actions", "tools", "editor", "formatting"]
keywords:
pain: Action groups lack orientation and accessibility semantics
promise: Toolbar role and orientation enforced via contract
why: |
ToolbarPrimitive encodes orientation and role="toolbar". ARIA labeling is explicit. This guarantees accessible grouping of actions.
rules: ["CR-001", "CR-004"]
use_cases: ["editors", "action bars"]
related: ["card", "resizable", "scroll_area", "aspect_ratio", "page_header", "separator"]
file: toolbar_ui.css
tokens: toolbar-*, space-*, radius-*, border-*
foundation: spacing, radius
states: ["active"]
island: toolbar_boundary.rs
pillar: layout
badges: ["SSR Safe", "Hydration Safe", "Token Driven", "Deterministic API", "Zero Drift"]
before: |
// ❌ Typical
view! {
<div class="toolbar">
<button>"Bold"</button>
</div>
}
after: |
// ✅ CanonRS
view! {
<Toolbar aria_label="Editor">
<button>"Bold"</button>
</Toolbar>
}
boundary_type: interaction
ix_group: ix_nav
block: []
blocks_primitives: [flex]