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.

tag
string
'div'
Root HTML element. The component always injects role="tablist" on top of this.
variant
TTabVariant
'default'
Visual treatment of the tab strip. default uses the standard indicator; pills gives each tab a pill background; underline shows a bottom border.
fixed
boolean
false
Distributes tab items with equal width across the full container (justify-evenly).
centered
boolean
false
Centers the tab strip within the container.
id
string
class
string | Array<string> | object
style
string | Array<string> | object | StyleValue
direction
TDirection
'horizontal'
Layout direction of the tab strip. Vertical switches aria-orientation accordingly.
density
TDensity
'default'
Controls the padding density of each Tab element.
rounded
boolean | number | string | TRounded | null | undefined
Border-radius token applied to the tab strip container.
roundedTopRight
boolean | number | string
roundedTopLeft
boolean | number | string
roundedBottomLeft
boolean | number | string
roundedBottomRight
boolean | number | string
roundedStartStart
boolean | number | string
roundedStartEnd
boolean | number | string
roundedEndStart
boolean | number | string
roundedEndEnd
boolean | number | string
color
TColor
Active tab indicator and text color.
bgColor
TColor
Background color of the tab strip container.
disabled
boolean
modelValue
any
Value of the currently selected tab. Bind with v-model.
multiple
boolean
mandatory
boolean
true
Ensures exactly one tab is always selected (WAI-ARIA tablist convention). Defaults to true.
max
number
selectedClass
string

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:modelValue
any
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

vue

Visual variants

vue

Tabs with icons

vue

Ecosystem

Family

Components from the same folder that share conventions and often compose together.