ui/docs/content/3.components/tabs.md

description, links

description	links
A set of tab panels that are displayed one at a time.	label icon to Tabs i-custom-radix-vue https://www.radix-vue.com/components/tabs.html label icon to GitHub i-simple-icons-github https://github.com/nuxt/ui/tree/v3/src/runtime/components/Tabs.vue

Usage

Items

Use the items prop as an array of objects with the following properties:

• label?: string{lang="ts-type"}
• icon?: string{lang="ts-type"}
• avatar?: AvatarProps{lang="ts-type"}
• content?: string{lang="ts-type"}
• value?: string | number{lang="ts-type"}
• disabled?: boolean{lang="ts-type"}
• slot?: string{lang="ts-type"}

::component-code

ignore:

• items
• class external:
• items props: items:
  • label: Account icon: 'i-heroicons-user' content: 'This is the account content.'
  • label: Password icon: 'i-heroicons-lock-closed' content: 'This is the password content.' class: 'w-full'

---

::

Content

Use the content prop to control how the Tabs are rendered.

You can set it to false to prevent the Tabs from rendering any content and act as a toggle.

::component-code

ignore:

• content
• items
• class external:
• items props: content: false items:
  • label: Account icon: 'i-heroicons-user' content: 'This is the account content.'
  • label: Password icon: 'i-heroicons-lock-closed' content: 'This is the password content.' class: 'w-full'

---

::

You can also choose to only render the content of the active tab by setting content.forceMount to false.

::component-code

prettier: true ignore:

• content.forceMount
• items
• class external:
• items props: content: forceMount: false items:
  • label: Account icon: 'i-heroicons-user' content: 'This is the account content.'
  • label: Password icon: 'i-heroicons-lock-closed' content: 'This is the password content.' class: 'w-full'

---

::

::note You can inspect the DOM to see that the content of the inactive tab is not rendered. ::

Color

Use the color prop to change the color of the Tabs.

::component-code

ignore:

• content
• items
• class external:
• items props: color: gray content: false items:
  • label: Account
  • label: Password class: 'w-full'

---

::

Variant

Use the variant prop to change the variant of the Tabs.

::component-code

ignore:

• content
• items
• class external:
• items props: color: gray variant: link content: false items:
  • label: Account
  • label: Password class: 'w-full'

---

::

Size

Use the size prop to change the size of the Tabs.

::component-code

ignore:

• content
• items
• class external:
• items props: size: md variant: pill content: false items:
  • label: Account
  • label: Password class: 'w-full'

---

::

Orientation

Use the orientation prop to change the orientation of the Tabs. Defaults to horizontal.

::component-code

ignore:

• content
• items
• class external:
• items props: orientation: vertical variant: pill content: false items:
  • label: Account
  • label: Password class: 'w-full'

---

::

Examples

Control active item

You can control the active item by using the default-value prop or the v-model directive with the index of the item.

:component-example{name="tabs-model-value-example"}

::tip You can also pass the value of one of the items if provided. ::

With content slot

Use the #content slot to customize the content of each item.

:component-example{name="tabs-content-slot-example"}

With custom slot

Use the slot property to customize a specific item.

:component-example{name="tabs-custom-slot-example"}

API

Props

:component-props

Slots

:component-slots

Emits

:component-emits

Theme

:component-theme