id: tabs
label: Tabs
family: family-b-selection
category: Navigation
intent: Switch between related content panels
description: Tabbed navigation
composable: true
capabilities: Active
required_parts: ["TabsList", "TabsTrigger", "TabsContent"]
optional_parts: []
tags: ["tabs", "navigation", "tab", "sections", "panels"]
keywords:
pain: Tabs require manual state sync between triggers and panels
promise: Active state governs trigger and content without manual wiring
why: |
TabsPrimitive uses ActivityState to synchronize triggers and panels. ARIA roles and visibility are derived automatically. This guarantees consistent tab behavior.
rules: ["CR-001", "CR-004"]
use_cases: ["panel navigation", "settings"]
related: ["table_of_contents"]
file: tabs_ui.css
tokens: tabs-*, tab-*, space-*, radius-*, font-*, motion-*
foundation: spacing, radius, motion, typography
states: ["active", "inactive", "disabled"]
island: tabs_boundary.rs
pillar: tabs
badges: ["SSR Safe", "Hydration Safe", "Token Driven", "Deterministic API", "Zero Drift", "Island Architecture"]
before: |
// ❌ Typical
view! {
<button>"Tab"</button>
<div>"Content"</div>
}
after: |
// ✅ CanonRS
view! {
<Tabs>
<TabsList>
<TabsTrigger value="a" active=true>"Tab"</TabsTrigger>
</TabsList>
<TabsContent value="a" active=true>"Content"</TabsContent>
</Tabs>
}
boundary_type: interaction
ix_group: ix_nav
block: []
blocks_primitives: [stack]