Skip to main content

Tabs

The Tabs component serves as a versatile tool for organizing and presenting content within a tabbed interface. It allows you to toggle between different sections of content. You can also use Tabs component as a pseudo-navigation for a page, where the tabs are links and the tab-items are the content.

info

For more details about Vuetify’s usage of Tabs component, click Tabs page.
For more prop explanations, click Vuetify Tabs API page.

Props

NameDescriptionTypeDefault
activeClassThe active-class applied to children when they are activated.stringundefined
alignWithTitleMake v-tabs lined up with the toolbar titlestringundefined
backgroundColorChanges the background color of the component.stringundefined
centeredCenters the tabsbooleanfalse
centerActiveForces the selected tab to be centeredbooleanfalse
darkApplies the dark themebooleanfalse
classAllows custom properties to take effect.stringundefined
fixedTabsTabsItem min-width 160px, max-width 360pxbooleanfalse
growForce Tab's to take up all available spacebooleanfalse
heightSets the height of the tabs barnumber|stringundefined
iconsAndTextWill stack icon and text verticallybooleanfalse
mobileBreakpointSets the designated mobile breakpoint for the component.string|numberundefined
nextIconRight pagination iconstring'$next'
prevIconLeft pagination iconstring'$prev'
showArrowsShow pagination arrows if the tab items overflow their container. For mobile devices, arrows will only display when using this prop.boolean|stringundefined
verticalstacks tabs on top of each other vertically.booleanfalse
valueThe designated model value for the componentanyundefined
visibleVisibility of Switch componentbooleantrue

Events

NameDescriptionType
changeEmitted when tab is changed by user interaction. Returns a string if href attribute is set and number if it is not.number|string

Component Samples

Centered

image

Icon-and-text

image

Tab

For Mobile Usage

You should not use Tab component alone on mobile, it should be within Tabs.

Props

NameDescriptionTypeDefault
appendIconAppends an icon to the component, uses the same syntax as icon.stringundefined
activeClassConfigure the active CSS class applied when the link is active. You can find more information about the active-class prop on the vue-router documentation.stringundefined
classAllows custom properties to take effect.stringundefined
darkApplies the dark theme.booleanfalse
disabledRemoves the ability to click or target the component.booleanfalse
linkDesignates that the component is a link. This is automatic when using the href or to prop.booleanfalse
prependInnerIconPrepends an icon inside the component’s input, uses the same syntax as v-icon.stringundefined
rippleApplies the v-ripple directive.boolean|objectTrue
replaceSetting 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.booleanfalse
tagSpecify a custom tag used on the root element.stringundefined
targetDesignates the target attribute. This should only be applied when using the href prop.stringundefined
toDenotes the target route of the link. You can find more information about the to prop on the vue-router documentation.string|objectundefined
visibleVisibility of Switch component.booleantrue

Events

NameDescription
changeEmitted when tab becomes active
clickEmitted when the component is clicked

TabItem

The TabItem component represents individual tabs within the tabbed interface. Each TabItem corresponds to a specific section of content and serves as a clickable element that you can interact with to navigate between tabs.

Props

NameDescriptionTypeDefault
classAllows custom properties to take effect.stringundefined
eagerWill force the components content to render on mounted. This is useful if you have content that will not be rendered in the DOM that you want crawled for SEO.booleantrue
valueSets the value of the tab. If not provided, the index will be used.anyundefined
visibleVisibility of Switch componentbooleantrue
For Mobile Usage

You should not use TabItem component alone on mobile, it should be within Tabs.

TabsSlider

The TabsSlider component is responsible for visually indicating the active tab within the tabbed interface. It provides a visual cue to you, highlighting the currently selected tab.

Props

NameDescriptionTypeDefault
classAllows custom properties to take effect.stringundefined
visibleVisibility of Switch componentbooleantrue
For Mobile Usage

You should not use TabsSlider component alone on mobile, it should be within Tabs.

Samples Qjson

tab