Tabs
Build fast websites, faster with Astro’s next-gen island architecture.
The React framework for production-grade applications that scale.
---import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";---
<Tabs defaultValue="astro" class="max-w-[400px]"> <TabsList> <TabsTrigger value="astro">Astro</TabsTrigger> <TabsTrigger value="next">Next.js</TabsTrigger> </TabsList> <TabsContent value="astro"> Build fast websites, faster with Astro's next-gen island architecture. </TabsContent> <TabsContent value="next"> The React framework for production-grade applications that scale. </TabsContent></Tabs>import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";
export function Example() { return ( <> <Tabs defaultValue="astro" className="max-w-[400px]"> <TabsList> <TabsTrigger value="astro">Astro</TabsTrigger> <TabsTrigger value="next">Next.js</TabsTrigger> </TabsList> <TabsContent value="astro"> Build fast websites, faster with Astro's next-gen island architecture. </TabsContent> <TabsContent value="next"> The React framework for production-grade applications that scale. </TabsContent> </Tabs> </> );}<script setup lang="ts">import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";</script>
<template> <Tabs defaultValue="astro" class="max-w-[400px]"> <TabsList> <TabsTrigger value="astro">Astro</TabsTrigger> <TabsTrigger value="next">Next.js</TabsTrigger> </TabsList> <TabsContent value="astro"> Build fast websites, faster with Astro's next-gen island architecture. </TabsContent> <TabsContent value="next"> The React framework for production-grade applications that scale. </TabsContent> </Tabs></template><script lang="ts"> import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/starwind/tabs";</script>
<div> <Tabs defaultValue="astro" class="max-w-[400px] max-w-full"> <TabsList> <TabsTrigger value="astro">Astro</TabsTrigger> <TabsTrigger value="next">Next.js</TabsTrigger> </TabsList> <TabsContent value="astro"> Build fast websites, faster with Astro's next-gen island architecture. </TabsContent> <TabsContent value="next"> The React framework for production-grade applications that scale. </TabsContent> </Tabs></div>Installation
pnpx starwind@latest add tabs --framework astronpx starwind@latest add tabs --framework astroyarn dlx starwind@latest add tabs --framework astropnpx starwind@latest add tabs --framework reactnpx starwind@latest add tabs --framework reactyarn dlx starwind@latest add tabs --framework reactpnpx starwind@latest add tabs --framework vuenpx starwind@latest add tabs --framework vueyarn dlx starwind@latest add tabs --framework vuepnpx starwind@latest add tabs --framework sveltenpx starwind@latest add tabs --framework svelteyarn dlx starwind@latest add tabs --framework svelteUsage
---import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";---
<Tabs defaultValue="astro" class="max-w-[400px]"> <TabsList> <TabsTrigger value="astro">Astro</TabsTrigger> <TabsTrigger value="next">Next.js</TabsTrigger> </TabsList> <TabsContent value="astro"> Build fast websites, faster with Astro's next-gen island architecture. </TabsContent> <TabsContent value="next"> The React framework for production-grade applications that scale. </TabsContent></Tabs>import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";
export function Example() { return ( <> <Tabs defaultValue="astro" className="max-w-[400px]"> <TabsList> <TabsTrigger value="astro">Astro</TabsTrigger> <TabsTrigger value="next">Next.js</TabsTrigger> </TabsList> <TabsContent value="astro"> Build fast websites, faster with Astro's next-gen island architecture. </TabsContent> <TabsContent value="next"> The React framework for production-grade applications that scale. </TabsContent> </Tabs> </> );}<script setup lang="ts">import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";</script>
<template> <Tabs defaultValue="astro" class="max-w-[400px]"> <TabsList> <TabsTrigger value="astro">Astro</TabsTrigger> <TabsTrigger value="next">Next.js</TabsTrigger> </TabsList> <TabsContent value="astro"> Build fast websites, faster with Astro's next-gen island architecture. </TabsContent> <TabsContent value="next"> The React framework for production-grade applications that scale. </TabsContent> </Tabs></template><script lang="ts"> import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";</script>
<Tabs defaultValue="astro" class="max-w-[400px]"> <TabsList> <TabsTrigger value="astro">Astro</TabsTrigger> <TabsTrigger value="next">Next.js</TabsTrigger> </TabsList> <TabsContent value="astro"> Build fast websites, faster with Astro's next-gen island architecture. </TabsContent> <TabsContent value="next"> The React framework for production-grade applications that scale. </TabsContent></Tabs>Composition
Match each trigger value to one content value:
Tabs├── TabsList│ ├── TabsTrigger│ └── TabsTrigger├── TabsContent└── TabsContentSynced Tabs
Use the syncKey prop to synchronize multiple tab groups. All tabs with the same syncKey will update together.
React is a JavaScript library for building user interfaces.
Vue is a progressive framework for building user interfaces.
React’s virtual DOM optimizes rendering performance.
Vue’s reactivity system makes state management intuitive.
---import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";---
<Tabs defaultValue="react" syncKey="frameworks" class="max-w-[400px]"> <TabsList> <TabsTrigger value="react">React</TabsTrigger> <TabsTrigger value="vue">Vue</TabsTrigger> </TabsList> <TabsContent value="react"> React is a JavaScript library for building user interfaces. </TabsContent> <TabsContent value="vue"> Vue is a progressive framework for building user interfaces. </TabsContent></Tabs>
<Tabs defaultValue="react" syncKey="frameworks" class="max-w-[400px]"> <TabsList> <TabsTrigger value="react">React</TabsTrigger> <TabsTrigger value="vue">Vue</TabsTrigger> </TabsList> <TabsContent value="react"> React's virtual DOM optimizes rendering performance. </TabsContent> <TabsContent value="vue"> Vue's reactivity system makes state management intuitive. </TabsContent></Tabs>import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";
export function Example() { return ( <> <Tabs defaultValue="react" syncKey="frameworks" className="max-w-[400px]"> <TabsList> <TabsTrigger value="react">React</TabsTrigger> <TabsTrigger value="vue">Vue</TabsTrigger> </TabsList> <TabsContent value="react"> React is a JavaScript library for building user interfaces. </TabsContent> <TabsContent value="vue"> Vue is a progressive framework for building user interfaces. </TabsContent> </Tabs>
<Tabs defaultValue="react" syncKey="frameworks" className="max-w-[400px]"> <TabsList> <TabsTrigger value="react">React</TabsTrigger> <TabsTrigger value="vue">Vue</TabsTrigger> </TabsList> <TabsContent value="react"> React's virtual DOM optimizes rendering performance. </TabsContent> <TabsContent value="vue"> Vue's reactivity system makes state management intuitive. </TabsContent> </Tabs> </> );}<script setup lang="ts">import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";</script>
<template> <Tabs defaultValue="react" syncKey="frameworks" class="max-w-[400px]"> <TabsList> <TabsTrigger value="react">React</TabsTrigger> <TabsTrigger value="vue">Vue</TabsTrigger> </TabsList> <TabsContent value="react"> React is a JavaScript library for building user interfaces. </TabsContent> <TabsContent value="vue"> Vue is a progressive framework for building user interfaces. </TabsContent> </Tabs>
<Tabs defaultValue="react" syncKey="frameworks" class="max-w-[400px]"> <TabsList> <TabsTrigger value="react">React</TabsTrigger> <TabsTrigger value="vue">Vue</TabsTrigger> </TabsList> <TabsContent value="react"> React's virtual DOM optimizes rendering performance. </TabsContent> <TabsContent value="vue"> Vue's reactivity system makes state management intuitive. </TabsContent> </Tabs></template><script lang="ts"> import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";</script>
<Tabs defaultValue="react" syncKey="frameworks" class="max-w-[400px]"> <TabsList> <TabsTrigger value="react">React</TabsTrigger> <TabsTrigger value="vue">Vue</TabsTrigger> </TabsList> <TabsContent value="react"> React is a JavaScript library for building user interfaces. </TabsContent> <TabsContent value="vue"> Vue is a progressive framework for building user interfaces. </TabsContent></Tabs><Tabs defaultValue="react" syncKey="frameworks" class="max-w-[400px]"> <TabsList> <TabsTrigger value="react">React</TabsTrigger> <TabsTrigger value="vue">Vue</TabsTrigger> </TabsList> <TabsContent value="react"> React's virtual DOM optimizes rendering performance. </TabsContent> <TabsContent value="vue"> Vue's reactivity system makes state management intuitive. </TabsContent></Tabs>Disabled Triggers
Use the disabled attribute to prevent a tab from being selected.
---import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";---
<Tabs defaultValue="active" class="max-w-[400px]"> <TabsList> <TabsTrigger value="active">Active</TabsTrigger> <TabsTrigger value="disabled" disabled>Disabled</TabsTrigger> <TabsTrigger value="pending">Pending</TabsTrigger> </TabsList> <TabsContent value="active">Active tab content</TabsContent> <TabsContent value="disabled">Disabled tab content</TabsContent> <TabsContent value="pending">Pending tab content</TabsContent></Tabs>import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";
export function Example() { return ( <> <Tabs defaultValue="active" className="max-w-[400px]"> <TabsList> <TabsTrigger value="active">Active</TabsTrigger> <TabsTrigger value="disabled" disabled>Disabled</TabsTrigger> <TabsTrigger value="pending">Pending</TabsTrigger> </TabsList> <TabsContent value="active">Active tab content</TabsContent> <TabsContent value="disabled">Disabled tab content</TabsContent> <TabsContent value="pending">Pending tab content</TabsContent> </Tabs> </> );}<script setup lang="ts">import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";</script>
<template> <Tabs defaultValue="active" class="max-w-[400px]"> <TabsList> <TabsTrigger value="active">Active</TabsTrigger> <TabsTrigger value="disabled" disabled>Disabled</TabsTrigger> <TabsTrigger value="pending">Pending</TabsTrigger> </TabsList> <TabsContent value="active">Active tab content</TabsContent> <TabsContent value="disabled">Disabled tab content</TabsContent> <TabsContent value="pending">Pending tab content</TabsContent> </Tabs></template><script lang="ts"> import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";</script>
<Tabs defaultValue="active" class="max-w-[400px]"> <TabsList> <TabsTrigger value="active">Active</TabsTrigger> <TabsTrigger value="disabled" disabled>Disabled</TabsTrigger> <TabsTrigger value="pending">Pending</TabsTrigger> </TabsList> <TabsContent value="active">Active tab content</TabsContent> <TabsContent value="disabled">Disabled tab content</TabsContent> <TabsContent value="pending">Pending tab content</TabsContent></Tabs>Nested Tabs
Show how tabs can be nested by placing a Tabs component inside a TabsContent panel.
Outer Tab 1 content
This tab contains nested tabs:
---import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";---
<Tabs defaultValue="outer-1"> <TabsList> <TabsTrigger value="outer-1">Outer Tab 1</TabsTrigger> <TabsTrigger value="outer-2">Outer Tab 2</TabsTrigger> </TabsList> <TabsContent value="outer-1"> Outer Tab 1 content </TabsContent> <TabsContent value="outer-2"> <div class="space-y-2"> This tab contains nested tabs: <Tabs defaultValue="inner-a"> <TabsList> <TabsTrigger value="inner-a">Inner A</TabsTrigger> <TabsTrigger value="inner-b">Inner B</TabsTrigger> </TabsList> <TabsContent value="inner-a">Inner tab A content</TabsContent> <TabsContent value="inner-b">Inner tab B content</TabsContent> </Tabs> </div> </TabsContent></Tabs>import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";
export function Example() { return ( <> <Tabs defaultValue="outer-1"> <TabsList> <TabsTrigger value="outer-1">Outer Tab 1</TabsTrigger> <TabsTrigger value="outer-2">Outer Tab 2</TabsTrigger> </TabsList> <TabsContent value="outer-1"> Outer Tab 1 content </TabsContent> <TabsContent value="outer-2"> <div className="space-y-2"> This tab contains nested tabs: <Tabs defaultValue="inner-a"> <TabsList> <TabsTrigger value="inner-a">Inner A</TabsTrigger> <TabsTrigger value="inner-b">Inner B</TabsTrigger> </TabsList> <TabsContent value="inner-a">Inner tab A content</TabsContent> <TabsContent value="inner-b">Inner tab B content</TabsContent> </Tabs> </div> </TabsContent> </Tabs> </> );}<script setup lang="ts">import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";</script>
<template> <Tabs defaultValue="outer-1"> <TabsList> <TabsTrigger value="outer-1">Outer Tab 1</TabsTrigger> <TabsTrigger value="outer-2">Outer Tab 2</TabsTrigger> </TabsList> <TabsContent value="outer-1"> Outer Tab 1 content </TabsContent> <TabsContent value="outer-2"> <div class="space-y-2"> This tab contains nested tabs: <Tabs defaultValue="inner-a"> <TabsList> <TabsTrigger value="inner-a">Inner A</TabsTrigger> <TabsTrigger value="inner-b">Inner B</TabsTrigger> </TabsList> <TabsContent value="inner-a">Inner tab A content</TabsContent> <TabsContent value="inner-b">Inner tab B content</TabsContent> </Tabs> </div> </TabsContent> </Tabs></template><script lang="ts"> import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";</script>
<Tabs defaultValue="outer-1"> <TabsList> <TabsTrigger value="outer-1">Outer Tab 1</TabsTrigger> <TabsTrigger value="outer-2">Outer Tab 2</TabsTrigger> </TabsList> <TabsContent value="outer-1">Outer Tab 1 content</TabsContent> <TabsContent value="outer-2"> <div class="space-y-2"> This tab contains nested tabs: <Tabs defaultValue="inner-a"> <TabsList> <TabsTrigger value="inner-a">Inner A</TabsTrigger> <TabsTrigger value="inner-b">Inner B</TabsTrigger> </TabsList> <TabsContent value="inner-a">Inner tab A content</TabsContent> <TabsContent value="inner-b">Inner tab B content</TabsContent> </Tabs> </div> </TabsContent></Tabs>Animated Panels
Place panels in the same grid cell and add an opacity transition. Tabs exposes data-starting-style on an entering panel and data-ending-style on an exiting panel. The outgoing panel stays visible until its transition finishes, then receives hidden.
Inactive panels are inert, so their links and controls cannot receive input during the fade. Use motion-reduce:transition-none to respect reduced-motion preferences. keepMounted preserves mounted content; it does not make inactive panels permanently visible.
Your workspace is ready.
Set up a componentReview recent changes in your workspace.
Read the changelog---import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";---
<Tabs defaultValue="overview" class="w-full max-w-md"> <TabsList aria-label="Workspace information"> <TabsTrigger value="overview">Overview</TabsTrigger> <TabsTrigger value="activity">Activity</TabsTrigger> </TabsList> <div class="grid"> <TabsContent value="overview" class="col-start-1 row-start-1 rounded-lg border p-4 opacity-100 transition-opacity duration-300 data-starting-style:opacity-0 data-ending-style:opacity-0 motion-reduce:transition-none"> <p class="mb-3">Your workspace is ready.</p> <a href="#installation" class="underline">Set up a component</a> </TabsContent> <TabsContent value="activity" class="col-start-1 row-start-1 rounded-lg border p-4 opacity-100 transition-opacity duration-300 data-starting-style:opacity-0 data-ending-style:opacity-0 motion-reduce:transition-none"> <p class="mb-3">Review recent changes in your workspace.</p> <a href="#changelog" class="underline">Read the changelog</a> </TabsContent> </div></Tabs>import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";
export function Example() { return ( <Tabs defaultValue="overview" className="w-full max-w-md"> <TabsList aria-label="Workspace information"> <TabsTrigger value="overview">Overview</TabsTrigger> <TabsTrigger value="activity">Activity</TabsTrigger> </TabsList> <div className="grid"> <TabsContent value="overview" className="col-start-1 row-start-1 rounded-lg border p-4 opacity-100 transition-opacity duration-300 data-starting-style:opacity-0 data-ending-style:opacity-0 motion-reduce:transition-none"> <p className="mb-3">Your workspace is ready.</p> <a href="#installation" className="underline">Set up a component</a> </TabsContent> <TabsContent value="activity" className="col-start-1 row-start-1 rounded-lg border p-4 opacity-100 transition-opacity duration-300 data-starting-style:opacity-0 data-ending-style:opacity-0 motion-reduce:transition-none"> <p className="mb-3">Review recent changes in your workspace.</p> <a href="#changelog" className="underline">Read the changelog</a> </TabsContent> </div> </Tabs> );}<script setup lang="ts">import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";</script>
<template> <Tabs defaultValue="overview" class="w-full max-w-md"> <TabsList aria-label="Workspace information"> <TabsTrigger value="overview">Overview</TabsTrigger> <TabsTrigger value="activity">Activity</TabsTrigger> </TabsList> <div class="grid"> <TabsContent value="overview" class="col-start-1 row-start-1 rounded-lg border p-4 opacity-100 transition-opacity duration-300 data-starting-style:opacity-0 data-ending-style:opacity-0 motion-reduce:transition-none"> <p class="mb-3">Your workspace is ready.</p> <a href="#installation" class="underline">Set up a component</a> </TabsContent> <TabsContent value="activity" class="col-start-1 row-start-1 rounded-lg border p-4 opacity-100 transition-opacity duration-300 data-starting-style:opacity-0 data-ending-style:opacity-0 motion-reduce:transition-none"> <p class="mb-3">Review recent changes in your workspace.</p> <a href="#changelog" class="underline">Read the changelog</a> </TabsContent> </div> </Tabs></template><script lang="ts"> import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/starwind/tabs";</script>
<Tabs defaultValue="overview" class="w-full max-w-md"> <TabsList aria-label="Workspace information"> <TabsTrigger value="overview">Overview</TabsTrigger> <TabsTrigger value="activity">Activity</TabsTrigger> </TabsList> <div class="grid"> <TabsContent value="overview" class="col-start-1 row-start-1 rounded-lg border p-4 opacity-100 transition-opacity duration-300 data-starting-style:opacity-0 data-ending-style:opacity-0 motion-reduce:transition-none"> <p class="mb-3">Your workspace is ready.</p> <a href="#installation" class="underline">Set up a component</a> </TabsContent> <TabsContent value="activity" class="col-start-1 row-start-1 rounded-lg border p-4 opacity-100 transition-opacity duration-300 data-starting-style:opacity-0 data-ending-style:opacity-0 motion-reduce:transition-none"> <p class="mb-3">Review recent changes in your workspace.</p> <a href="#changelog" class="underline">Read the changelog</a> </TabsContent> </div></Tabs>When code changes the selected tab, the next Tab-key entry follows the selected enabled trigger. If focus is already in the tab list, Tabs preserves the user’s keyboard position. Selection changes do not move focus from elsewhere on the page.
API Reference
Styled Component API
These props are added or materially changed by the installed styled component. Standard HTML attributes remain available through the inherited interfaces noted below. Expand a prop to see named type definitions and framework-specific imports. Follow the Primitive and Runtime links for lower-level behavior props.
Tabs
Inherits div attributes. Omits `defaultValue`, `onChange`, and `value`.
Contains the following additional props:
defaultValue string | null —
- Description
- Sets the initial value when the component is uncontrolled.
- Classification
- Primitive override
- Type imports
- React
import type { TabsValue } from "@starwind-ui/react"; - Primitive prop
- tabs.Root.defaultValue
orientation "horizontal" | "vertical" "horizontal"
- Description
- Selects the horizontal or vertical layout direction.
- Classification
- Primitive override
- Primitive prop
- tabs.Root.orientation
value string | null —
- Description
- Controls or identifies the component value.
- Classification
- Primitive override
- Type imports
- React
import type { TabsValue } from "@starwind-ui/react"; - Primitive prop
- tabs.Root.value
Tabs List
Inherits div attributes.
Contains the following additional props:
activateOnFocus boolean —
- Description
- Activates the focused item while moving through the collection.
- Classification
- Primitive override
- Primitive prop
- tabs.List.activateOnFocus
loopFocus boolean —
- Description
- Wraps keyboard focus from the last item to the first and vice versa.
- Classification
- Primitive override
- Primitive prop
- tabs.List.loopFocus
Tabs Trigger
Inherits button attributes. Omits `type` and `value`.
Contains the following additional props:
value Required string —
- Description
- Controls or identifies the component value.
- Classification
- Wrapper prop
Tabs Content
Inherits div attributes.
Contains the following additional props:
keepMounted boolean —
- Description
- Keeps hidden content mounted in the DOM.
- Classification
- Primitive override
- Primitive prop
- tabs.Panel.keepMounted
value Required string —
- Description
- Controls or identifies the component value.
- Classification
- Wrapper prop
Primitive And Runtime API
Use these references when you need the lower-level behavior APIs behind Tabs.
Primitive API
Runtime API
- Tabs primitive
createTabsfrom@starwind-ui/runtime/tabs
Changelog
View version history v2.2.0 12 releases
v2.2.0
- In Svelte, a defined
valuethat you pass when Tabs mounts now stays under your control, as in React and Vue. To change it, usebind:or update your state in the change callback. A form reset keeps it. If you passundefinedat mount, Tabs keeps its own state. - In Vue, a Boolean prop that you leave out, such as
activateOnFocus,loopFocus, orkeepMounted, no longer becomesfalse. The default of the underlying component applies.
v2.1.0
- Vue Tabs keeps the selected tab when a selection change is canceled.
- Tabs keeps its initial
syncKeywhile mounted. Remount it to change that key. - Added CSS entrance and exit animations using
data-starting-styleanddata-ending-style. Panels stay visible until their exit animation finishes, while inactive content stops accepting keyboard focus and clicks. - When your code selects a tab, pressing Tab to enter the tab list now focuses that tab. Focus stays in place while someone is already navigating the list.
v2.0.2
- Fixed the active tab indicator position when its container is scrolled or transformed.
v2.0.1
- The default export in
index.tsnow has a name,TabsParts, so framework tools show a clear name.
v2.0.0
- Tabs now gets its behavior from Starwind Runtime. Runtime handles selection, focus movement, and groups of tabs that stay in sync.
- See the Tabs Primitive for the unstyled parts and the behavior API.
v1.4.3
- The Tailwind variants now live in their own
variants.tsfile in the component folder.
v1.4.1
- Add
starwind:initevent listener to enable initialization of additional Tabs loaded after an initial page load, such as when using server islands
v1.4.0
- style and focus state updates
v1.3.0
- Add a
data-slotattribute to all components to enable global styling updates
v1.2.0
- Add support for nested tabs
v1.1.1
- Small script cleanup
v1.1.0
tailwind-variantsnow implemented. This usestailwind-mergeunder the hood to merge Tailwind classes without style conflicts, allowing you to override any existing classes using the “class” prop.