VTab API

Props

name	type	default
`active-color`	string	undefined
The applied color when the component is in an active state.
`append-icon`	\| string \| (string \| [string, number])[] \| (new () => any) \| FunctionalComponent	undefined
Creates a v-icon component after default content in the append slot.
`base-color`	string	undefined
Sets the color of component when not focused.
`border`	string \| number \| boolean	false
Applies utility border classes to the component. To use it, you need to omit the `border-` prefix, (for example use `border-sm` as `border="sm"`). Find a list of the built-in border classes on the borders page.
`color`	string	undefined
Applies specified color to the control - supports utility colors with or without `text-` prefix (for example `success`, `purple` or `text-purple`) or CSS color (`#033` or `rgba(255, 0, 0, 0.5)`). Find a list of built-in classes on the colors page.
`density`	'default' \| 'comfortable' \| 'compact'	'default'
Adjusts the vertical height used by the component.
`direction`	'vertical' \| 'horizontal'	'horizontal'
Changes the direction of the tabs. Can be either `horizontal` or `vertical`.
`disabled`	boolean	false
Removes the ability to click or target the component.
`elevation`	string \| number	undefined
Designates an elevation applied to the component between 0 and 5. You can find more information on the elevation page.
`exact`	boolean	false
Exactly match the link. Without this, ‘/’ will match every route. You can find more information about the exact prop on the vue-router documentation.
`fixed`	boolean	false
Forces component to take up all available space up to their maximum width (300px), and centers it.
`height`	string \| number	undefined
Sets the height for the component.
`hide-slider`	boolean	false
Hides the active tab slider component (no exit or enter animation).
`href`	string	undefined
Designates the component as anchor and applies the href attribute.
`icon`	\| boolean \| string \| (string \| [string, number])[] \| (new () => any) \| FunctionalComponent	false
Apply a specific icon using the v-icon component. The button will become round.
`inset` New in v3.11.2	boolean	false
Changes the slider to take full height. Automatically propagated from VTabs.
`loading`	string \| boolean	false
Displays linear progress bar. Can either be a String which specifies which color is applied to the progress bar (any material color or theme color - primary, secondary, success, info, warning, error) or a Boolean which uses the component color (set by color prop - if it’s supported by the component) or the primary color.
`max-height`	string \| number	undefined
Sets the maximum height for the component.
`max-width`	string \| number	undefined
Sets the maximum width for the component.
`min-height`	string \| number	undefined
Sets the minimum height for the component.
`min-width`	string \| number	undefined
Sets the minimum width for the component.
`prepend-icon`	\| string \| (string \| [string, number])[] \| (new () => any) \| FunctionalComponent	undefined
Creates a v-icon component in the prepend slot before default content.
`readonly`	boolean	false
Puts the button in a readonly state. Cannot be clicked or navigated to by keyboard.
`replace`	boolean	false
Setting replace prop will call `router.replace()` instead of `router.push()` when clicked, so the navigation will not leave a history record. You can find more information about the replace prop on the vue-router documentation.
`ripple`	boolean \| { class: string; keys: string[] }	true
Applies the v-ripple directive.
`rounded`	string \| number \| boolean	undefined
Designates the border-radius applied to the component. This can be 0, xs, sm, true, lg, xl, pill, circle, and shaped. Find more information on available border radius classes on the Border Radius page.
`selected-class`	string	'v-tab--selected'
Configure the active CSS class applied when an item is selected.
`size`	string \| number	'default'
Sets the height and width of the component. Default unit is px. Can also use the following predefined sizes: x-small, small, default, large, and x-large.
`slider-color`	string	undefined
Applies specified color to the slider when active on that component - supports utility colors (for example `success` or `purple`) or css color (`#033` or `rgba(255, 0, 0, 0.5)`). Find a list of built-in classes on the colors page.
`slider-transition` New in v3.11.0	'shift' \| 'grow' \| 'fade'	undefined
Changes slider transition to one of the predefined animation presets.
`slider-transition-duration` New in v3.11.0	string \| number	undefined
Applies custom slider transition duration. Default duration depends on transition type (fade: 400, grow: 350, shift: 225).
`slim`	boolean	false
Reduces padding to 0 8px.
`spaced` New in v3.10.0	'end' \| 'start' \| 'both'	undefined
Extends content to the edges to move main content from prepend and append slots.
`stacked`	boolean	false
Displays the tab as a flex-column.
`tag`	string \| (new () => any) \| FunctionalComponent	'button'
Specify a custom tag used on the root element.
`text` New in v3.2.0	string \| number \| boolean	undefined
Specify content text for the component.
`theme`	string	undefined
Specify a theme for this component and all of its children.
`tile`	boolean	false
Removes any applied border-radius from the component.
`to`	string \| RouteLocationAsRelativeGeneric \| RouteLocationAsPathGeneric	undefined
Denotes the target route of the link. You can find more information about the to prop on the vue-router documentation.
`value`	any	undefined
The value used when the component is selected in a group. If not provided, a unique ID will be used.
`variant`	'text' \| 'flat' \| 'elevated' \| 'tonal' \| 'outlined' \| 'plain'	'text'
Applies a distinct style to the component.
`width`	string \| number	undefined
Sets the width for the component.

Slots

never

never

never

never

`append`
Adds an item inside the input and after input content.
`default`
The default Vue slot.
`loader`
Slot for custom loader (displayed when loading prop is equal to true).
`prepend`
Adds an item outside the input and before input content.

Exposed

{
  id: string
  isSelected: boolean
  isFirst: boolean
  isLast: boolean
  toggle: () => void
  select: (value: boolean) => void
  selectedClass: false | (string | undefined)[]
  value: unknown
  disabled: boolean | undefined
  group: {
    register: (item: GroupItem, cmp: ComponentInternalInstance) => void
    unregister: (id: string) => void
    select: (id: string, value: boolean) => void
    selected: readonly string[]
    isSelected: (id: string) => boolean
    prev: () => void
    next: () => void
    selectedClass: string | undefined
    items: { id: string; value: unknown; disabled: boolean | undefined }[]
    disabled: boolean | undefined
    getItemIndex: (value: unknown) => number
  }
  register: () => void
  unregister: () => void
}

`group`
Internal representation when used in VBtnToggle.

#VTab API

VTab API