overview
Overview
The Tab block organizes content into switchable panels with clickable headers. Only one panel is visible at a time, making it ideal for categorized content that doesn't need to be compared side-by-side.
Each tab panel can contain rich text content or reference a page fragment for more complex layouts. Tabs support horizontal and vertical orientations with multiple visual styles.
features
Features
- Keyboard navigation — Arrow keys move between tabs, Enter/Space activates
- Deep linking — URL hash fragments (#tab-id) activate specific tabs on page load
- Responsive — Tabs stack or scroll horizontally on mobile breakpoints
- Icon support — Add icons alongside or above tab labels for visual context
- ARIA compliant — Full tablist/tab/tabpanel roles for screen readers
best-practices
Best Practices
- Limit to 3-5 tabs — too many tabs overwhelm users and cause horizontal overflow on mobile
- Use concise labels — tab headers should be 1-2 words maximum for scannability
- Keep content balanced — similar volume across panels prevents layout shifts when switching
- Don't nest tabs — nested tab interfaces confuse navigation; use accordion inside tabs instead
- First tab = most important — users often don't explore beyond the default active tab
tab-usage
When to use
- Plan comparison — each tab represents a tier or option. Content shows features and pricing.
- Content categories — organize related content by topic or audience without multiple pages.
- View switching — monthly vs. annual pricing, or different perspectives on the same data.
- Multi-step processes — show steps as tabs for easy reference and navigation.
Key decisions
- Orientation: tab-horizontal for most cases. tab-vertical for sidebar-style navigation with longer content.
- Style: tab-style-default for standard tabs, tab-style-underline for minimal, tab-style-pills for button-like.
- Default tab: First tab (index 0) is usually best. Set a different default if a specific tab is most relevant.
- Content per tab: Keep content volume similar across tabs to avoid jarring height changes.
tab-options
All authoring options
Section decorator
filter: tab
model: tab
name: display name
Behavior
classes_tabDefault: index of initially active tab (0-based)
classes_tabOrientation: tab-horizontal | tab-vertical
Appearance
classes_tabStyle: tab-style-default | tab-style-underline | tab-style-pills
Analytics
trackInview: boolean
trackInviewMeta: text