Sketchbook
On this page

Tag <sb-tabs> · status stable · version 0.1.0

Example

Overview Activity Settings

A summary of the project.

Recent changes appear here.

Configuration options.

<sb-tabs value="overview" style="display:block;width:400px">
  <sb-tabs-list aria-label="Project sections">
    <sb-tabs-trigger value="overview">Overview</sb-tabs-trigger>
    <sb-tabs-trigger value="activity">Activity</sb-tabs-trigger>
    <sb-tabs-trigger value="settings">Settings</sb-tabs-trigger>
  </sb-tabs-list>
  <sb-tabs-content value="overview"><p>A summary of the project.</p></sb-tabs-content>
  <sb-tabs-content value="activity"><p>Recent changes appear here.</p></sb-tabs-content>
  <sb-tabs-content value="settings"><p>Configuration options.</p></sb-tabs-content>
</sb-tabs>

Properties

Name Type Default Notes
value text `` Value of the selected tab. When empty, the first enabled tab is selected.
orientation horizontal, vertical horizontal Direction of the tab list. Vertical lists use Arrow Up and Down.
activation automatic, manual automatic automatic selects a tab as soon as it takes focus; manual moves focus only, and Enter or Space selects.

Events

Name Notes
change Fires on the sb-tabs host after a person selects a different tab. Not fired for changes made from code. A change from a form control inside a panel also bubbles to the host: listen with event.target === host (that one has no detail).

Parts

<sb-tabs-list>

The row or column that holds the tabs.

Name Type Default Notes
variant primary, line primary primary is a filled track with a raised selected tab; line is transparent with an indicator bar under the selected tab.

<sb-tabs-trigger>

One tab. Renders a native button with role tab.

Name Type Default Notes
value text `` Links the tab to the panel with the same value. Unique within the tabs.
disabled boolean false Not focusable and not selectable.
Event Notes
click Selects the tab.

<sb-tabs-content>

The panel of one tab; only the selected panel is displayed.

Name Type Default Notes
value text `` The tab value this panel belongs to.

Keyboard

Key Does
Tab enters the list on the selected tab, then moves to the selected panel
ArrowRight next enabled tab (previous in right-to-left); wraps
ArrowLeft previous enabled tab (next in right-to-left); wraps
ArrowDown next enabled tab in a vertical list
ArrowUp previous enabled tab in a vertical list
Home first enabled tab
End last enabled tab
Enter select the focused tab (manual activation)
Space select the focused tab (manual activation)

Accessibility

  • Role: tablist, tab and tabpanel
  • Native element: button
  • Accessible name: Tab text. A panel is named by its tab. Name the tab list with aria-label when the context does not.

View as Markdown