Navigation
Tab Group
Organises content into a row of tabs and matching panels, with full keyboard support, a sliding active indicator, and four placements.
Preview
Section titled “Preview”<nana-tab-group variant="segmented" style="width: 100%">
<nana-tab slot="nav" panel="a">First</nana-tab>
<nana-tab slot="nav" panel="b">Second</nana-tab>
<nana-tab-panel name="a">Panel one.</nana-tab-panel>
<nana-tab-panel name="b">Panel two.</nana-tab-panel>
</nana-tab-group> <script lang="ts">
import { NanaTab, NanaTabList, NanaTabPanel, NanaTabs } from '$lib/components/ui/tabs';
</script>
<div class="flex w-full flex-col gap-6">
{#each ['underline', 'pill', 'segmented'] as const as variant (variant)}
<NanaTabs value="general" {variant}>
<NanaTabList>
<NanaTab value="general">General</NanaTab>
<NanaTab value="billing">Billing</NanaTab>
<NanaTab value="advanced">Advanced</NanaTab>
</NanaTabList>
<NanaTabPanel value="general">General settings ({variant})</NanaTabPanel>
<NanaTabPanel value="billing">Billing settings</NanaTabPanel>
<NanaTabPanel value="advanced">Advanced settings</NanaTabPanel>
</NanaTabs>
{/each}
</div> Installation
Section titled “Installation”Install the package for a versioned dependency:
npm install @nana-tec/ui-componentsOr copy the source in and own it:
npx @nana-tec/ui add tab-group --framework web-componentsnpx @nana-tec/ui add tabs --framework svelteLands in src/lib/components/ui/tabs/ as NanaTabs.svelte, NanaTabList.svelte, NanaTab.svelte and NanaTabPanel.svelte, styled with Tailwind
classes that resolve to the design tokens. Requires Tailwind v4.
Import the autoloader once, in your app's entry point. Every <nana-*> tag then works anywhere, and
each component downloads only the first time a page uses it:
import "@nana-tec/ui-components/autoloader";import "@nana-tec/ui-components/theme";The second line gives every component the Nana look and the design tokens behind it. Leave it out to style the components entirely yourself.
Import a component directly when it must be ready at once: on screen at first paint, or when you call its methods straight away. The two mix freely:
import "@nana-tec/ui-components/tab-group";
Copied in with npx @nana-tec/ui add tab-group? Import your project's own
@/lib/nana-ui/autoloader.js once instead; the CLI keeps it up to date.
<nana-tab-group style="width:100%"> <nana-tab slot="nav" panel="a">First</nana-tab> <nana-tab slot="nav" panel="b">Second</nana-tab> <nana-tab-panel name="a">Panel one.</nana-tab-panel> <nana-tab-panel name="b">Panel two.</nana-tab-panel></nana-tab-group><script lang="ts"> import { NanaTabs, NanaTabList, NanaTab, NanaTabPanel } from '$lib/components/ui/tabs';
let tab = $state('general');</script>
<NanaTabs bind:value={tab} variant="segmented"> <NanaTabList> <NanaTab value="general">General</NanaTab> <NanaTab value="advanced">Advanced</NanaTab> </NanaTabList> <NanaTabPanel value="general">General content</NanaTabPanel> <NanaTabPanel value="advanced">Advanced content</NanaTabPanel></NanaTabs>value is $bindable and required. The list handles arrow keys, Home and End;
only the selected panel is rendered.
Variants
Section titled “Variants”The variant attribute sets the tab styling — underline (default), pill,
segmented, filled, ghost, or card.
<nana-tab-group variant="pill" style="width: 100%">
<nana-tab slot="nav" panel="a">First</nana-tab>
<nana-tab slot="nav" panel="b">Second</nana-tab>
<nana-tab-panel name="a">Pill panel one.</nana-tab-panel>
<nana-tab-panel name="b">Pill panel two.</nana-tab-panel>
</nana-tab-group>
<nana-tab-group variant="segmented" style="width: 100%">
<nana-tab slot="nav" panel="a">First</nana-tab>
<nana-tab slot="nav" panel="b">Second</nana-tab>
<nana-tab-panel name="a">Segmented panel one.</nana-tab-panel>
<nana-tab-panel name="b">Segmented panel two.</nana-tab-panel>
</nana-tab-group>
<nana-tab-group variant="filled" style="width: 100%">
<nana-tab slot="nav" panel="a">First</nana-tab>
<nana-tab slot="nav" panel="b">Second</nana-tab>
<nana-tab-panel name="a">Filled panel one.</nana-tab-panel>
<nana-tab-panel name="b">Filled panel two.</nana-tab-panel>
</nana-tab-group>
<nana-tab-group variant="card" style="width: 100%">
<nana-tab slot="nav" panel="a">First</nana-tab>
<nana-tab slot="nav" panel="b">Second</nana-tab>
<nana-tab-panel name="a">Card panel one.</nana-tab-panel>
<nana-tab-panel name="b">Card panel two.</nana-tab-panel>
</nana-tab-group>
<nana-tab-group variant="ghost" style="width: 100%">
<nana-tab slot="nav" panel="a">First</nana-tab>
<nana-tab slot="nav" panel="b">Second</nana-tab>
<nana-tab-panel name="a">Ghost panel one.</nana-tab-panel>
<nana-tab-panel name="b">Ghost panel two.</nana-tab-panel>
</nana-tab-group> Placement
Section titled “Placement”Set placement to top (default), bottom, start, or end.
<nana-tab-group placement="start" style="width: 100%">
<nana-tab slot="nav" panel="a">First</nana-tab>
<nana-tab slot="nav" panel="b">Second</nana-tab>
<nana-tab-panel name="a">Panel one.</nana-tab-panel>
<nana-tab-panel name="b">Panel two.</nana-tab-panel>
</nana-tab-group> Properties
| Property | Attribute | Type | Default | Description |
|---|---|---|---|---|
activation | activation | TabGroupActivation | 'auto' | auto activates a tab as it's focused; manual waits for Enter / Space / click. |
noIndicator | no-indicator | boolean | false | Hide the sliding active indicator. |
placement | placement | TabGroupPlacement | 'top' | Where the tabs sit relative to the panels. |
size | size | TabSize | 'md' | Size applied to every tab in the group. |
variant | variant | TabVariant | 'underline' | Visual style applied to every tab in the group. |
Methods
| Method | Description |
|---|---|
show(name: string): void | Show the panel (and tab) with the given name. |
Events
| Event | Description |
|---|---|
nana-tab-show | Emitted when a tab is shown (detail.name). |
nana-tab-hide | Emitted when a tab is hidden (detail.name). |
Slots
| Slot | Description |
|---|---|
nav | The nana-tab elements. |
(default) | The nana-tab-panel elements. |
CSS parts
| Part | Description |
|---|---|
::part(base) | The host container. |
::part(nav) | The tab navigation region. |
::part(tablist) | The scrollable tab list. |
::part(indicator) | The active-tab indicator. |
::part(thumb) | The segmented and pill variants' active thumb, which flows between tabs. |
::part(body) | The panel container. |
CSS custom properties
| Property | Description |
|---|---|
--nana-tab-group-indicator-color | Colour of the active indicator. |
--nana-tab-group-border-color | Colour of the divider line. |
--nana-tab-group-track-bg | Segmented variant's track fill. Defaults to a translucent tint of the text colour, so it reads on any surface; set an opaque colour to pin it. |
--nana-tab-group-track-radius | Corner radius of the segmented / pill track. The active thumb derives its own radius from this so the two stay concentric. |
--nana-tab-group-track-pad | Inset between the track and the active thumb. |
--nana-tab-group-indicator-size | Thickness of the active indicator bar |
--nana-tab-active-bg | Fill of the segmented variant's thumb. |
--nana-tab-thumb-bg | Theme slot for the segmented thumb fill, set by the light and dark themes. |
--nana-tab-thumb-line | Theme slot for the segmented thumb edge. |
NanaTab
| Prop | Type |
|---|---|
valuerequired | string |
children | Snippet |
Also accepts Omit<
HTMLButtonAttributes,
'class' | 'value'
>.
NanaTabPanel
| Prop | Type |
|---|---|
valuerequired | string |
children | Snippet |
Also accepts Omit<
HTMLAttributes<HTMLDivElement>,
'class'
>.
NanaTabs
| Prop | Type | Default |
|---|---|---|
valuerequiredbind: | string | undefined |
variant | TabVariant | 'underline' |
size | TabSize | 'md' |
orientation | TabsOrientation | 'horizontal' |
activation | TabsActivation | 'auto' |
onValueChange | (value: string) => void | |
children | Snippet |
Also accepts Omit<HTMLAttributes<HTMLDivElement>, 'class'>.