Tabs
Navigation
stable
WAI-ARIA-compliant tablist container that orchestrates a group of OrigamTab elements with optional matching OrigamTabPanels for content switching.
API
Props
All props accepted by this component, with their type, default value and description.
- tagstring'div'
- Root HTML element. The component always injects role="tablist" on top of this.
- variantTTabVariant'default'
- Visual treatment of the tab strip. default uses the standard indicator; pills gives each tab a pill background; underline shows a bottom border.
- fixedbooleanfalse
- Distributes tab items with equal width across the full container (justify-evenly).
- centeredbooleanfalse
- Centers the tab strip within the container.
- idstring
- classstring | Array<string> | object
- stylestring | Array<string> | object | StyleValue
- directionTDirection'horizontal'
- Layout direction of the tab strip. Vertical switches aria-orientation accordingly.
- densityTDensity'default'
- Controls the padding density of each Tab element.
- roundedboolean | number | string | TRounded | null | undefined
- Border-radius token applied to the tab strip container.
- roundedTopRightboolean | number | string
- roundedTopLeftboolean | number | string
- roundedBottomLeftboolean | number | string
- roundedBottomRightboolean | number | string
- roundedStartStartboolean | number | string
- roundedStartEndboolean | number | string
- roundedEndStartboolean | number | string
- roundedEndEndboolean | number | string
- colorTColor
- Active tab indicator and text color.
- bgColorTColor
- Background color of the tab strip container.
- disabledboolean
- modelValueany
- Value of the currently selected tab. Bind with v-model.
- multipleboolean
- mandatorybooleantrue
- Ensures exactly one tab is always selected (WAI-ARIA tablist convention). Defaults to true.
- maxnumber
- selectedClassstring
API
Slots
Content slots exposed by this component.
- #default
- Tab items. Receives the group API (select, next, prev…) for programmatic navigation.
API
Emits
Events emitted by this component.
- @update:modelValueany
- Fired when the active tab changes. Bind with v-model.
Interactive
Playground
Edit props live and see the component update in real time. The generated code snippet updates as you change values.
Rendering the live preview…
Usage
Examples
Ready-to-paste code snippets for your templates.
Basic tabs
Visual variants
Tabs with icons
Ecosystem
Family
Components from the same folder that share conventions and often compose together.