tab-hero
image
Tab Block

Tabbed panels for content switching.

Section decorator that organizes content into clickable tabbed panels. Only one panel visible at a time, reducing scroll and improving focus.
inline-text-overlay
16.0
10.0
9.0
16.0
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