Skip to content
WebJs
Menu

A set of layered sections of content, known as tab panels, that are displayed one at a time.

Overview
View your key metrics and recent project activity. Track progress across all your active projects.
You have 12 active projects and 3 pending tasks.
import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import {
  cardClass, cardHeaderClass, cardTitleClass, cardDescriptionClass, cardContentClass,
} from '#components/ui/card.ts';

export default function TabsDemo() {
  return html`
    <ui-tabs value="overview" class="w-[400px]">
      <ui-tabs-list>
        <ui-tabs-trigger value="overview">Overview</ui-tabs-trigger>
        <ui-tabs-trigger value="analytics">Analytics</ui-tabs-trigger>
        <ui-tabs-trigger value="reports">Reports</ui-tabs-trigger>
        <ui-tabs-trigger value="settings">Settings</ui-tabs-trigger>
      </ui-tabs-list>
      <ui-tabs-content value="overview">
        <div data-slot="card" data-size="default" class=${cardClass()}>
          <div data-slot="card-header" class=${cardHeaderClass()}>
            <div data-slot="card-title" class=${cardTitleClass()}>Overview</div>
            <div data-slot="card-description" class=${cardDescriptionClass()}>
              View your key metrics and recent project activity. Track progress
              across all your active projects.
            </div>
          </div>
          <div data-slot="card-content" class=${cn(cardContentClass(), 'text-sm text-muted-foreground')}>
            You have 12 active projects and 3 pending tasks.
          </div>
        </div>
      </ui-tabs-content>
      <ui-tabs-content value="analytics">
        <div data-slot="card" data-size="default" class=${cardClass()}>
          <div data-slot="card-header" class=${cardHeaderClass()}>
            <div data-slot="card-title" class=${cardTitleClass()}>Analytics</div>
            <div data-slot="card-description" class=${cardDescriptionClass()}>
              Track performance and user engagement metrics. Monitor trends and
              identify growth opportunities.
            </div>
          </div>
          <div data-slot="card-content" class=${cn(cardContentClass(), 'text-sm text-muted-foreground')}>
            Page views are up 25% compared to last month.
          </div>
        </div>
      </ui-tabs-content>
      <ui-tabs-content value="reports">
        <div data-slot="card" data-size="default" class=${cardClass()}>
          <div data-slot="card-header" class=${cardHeaderClass()}>
            <div data-slot="card-title" class=${cardTitleClass()}>Reports</div>
            <div data-slot="card-description" class=${cardDescriptionClass()}>
              Generate and download your detailed reports. Export data in
              multiple formats for analysis.
            </div>
          </div>
          <div data-slot="card-content" class=${cn(cardContentClass(), 'text-sm text-muted-foreground')}>
            You have 5 reports ready and available to export.
          </div>
        </div>
      </ui-tabs-content>
      <ui-tabs-content value="settings">
        <div data-slot="card" data-size="default" class=${cardClass()}>
          <div data-slot="card-header" class=${cardHeaderClass()}>
            <div data-slot="card-title" class=${cardTitleClass()}>Settings</div>
            <div data-slot="card-description" class=${cardDescriptionClass()}>
              Manage your account preferences and options. Customize your
              experience to fit your needs.
            </div>
          </div>
          <div data-slot="card-content" class=${cn(cardContentClass(), 'text-sm text-muted-foreground')}>
            Configure notifications, security, and themes.
          </div>
        </div>
      </ui-tabs-content>
    </ui-tabs>
  `;
}
View Code

Installation

pnpm dlx @webjsdev/ui add tabs

Usage

The tabs are custom elements. Importing the module registers them, and the page renders them by tag.

import '#components/ui/tabs.ts';
<ui-tabs value="account" class="w-[400px]">
  <ui-tabs-list>
    <ui-tabs-trigger value="account">Account</ui-tabs-trigger>
    <ui-tabs-trigger value="password">Password</ui-tabs-trigger>
  </ui-tabs-list>
  <ui-tabs-content value="account">Make changes to your account here.</ui-tabs-content>
  <ui-tabs-content value="password">Change your password here.</ui-tabs-content>
</ui-tabs>

Composition

Use the following composition to build <ui-tabs>:

ui-tabs
├── ui-tabs-list
│   ├── ui-tabs-trigger
│   └── ui-tabs-trigger
├── ui-tabs-content
└── ui-tabs-content

Line

Use the variant="underline" attribute on <ui-tabs-list> for a line style.

import { html } from '@webjsdev/core';

export default function TabsLine() {
  return html`
    <ui-tabs value="overview">
      <ui-tabs-list variant="underline">
        <ui-tabs-trigger value="overview">Overview</ui-tabs-trigger>
        <ui-tabs-trigger value="analytics">Analytics</ui-tabs-trigger>
        <ui-tabs-trigger value="reports">Reports</ui-tabs-trigger>
      </ui-tabs-list>
    </ui-tabs>
  `;
}
View Code

Vertical

Use orientation="vertical" for vertical tabs.

import { html } from '@webjsdev/core';

export default function TabsVertical() {
  return html`
    <ui-tabs value="account" orientation="vertical">
      <ui-tabs-list>
        <ui-tabs-trigger value="account">Account</ui-tabs-trigger>
        <ui-tabs-trigger value="password">Password</ui-tabs-trigger>
        <ui-tabs-trigger value="notifications">Notifications</ui-tabs-trigger>
      </ui-tabs-list>
    </ui-tabs>
  `;
}
View Code

Disabled

Add disabled to a <ui-tabs-trigger> to disable it. Its button is disabled, so it cannot be selected, and the arrow keys skip it.

import { html } from '@webjsdev/core';

export default function TabsDisabled() {
  return html`
    <ui-tabs value="home">
      <ui-tabs-list>
        <ui-tabs-trigger value="home">Home</ui-tabs-trigger>
        <ui-tabs-trigger value="settings" disabled>
          Disabled
        </ui-tabs-trigger>
      </ui-tabs-list>
    </ui-tabs>
  `;
}
View Code

Icons

import { html } from '@webjsdev/core';
import { AppWindowIcon, CodeIcon } from '#lib/ui/lucide.ts';

export default function TabsIcons() {
  return html`
    <ui-tabs value="preview">
      <ui-tabs-list>
        <ui-tabs-trigger value="preview">
          ${AppWindowIcon()}
          Preview
        </ui-tabs-trigger>
        <ui-tabs-trigger value="code">
          ${CodeIcon()}
          Code
        </ui-tabs-trigger>
      </ui-tabs-list>
    </ui-tabs>
  `;
}
View Code

RTL

To enable RTL support, see the RTL configuration guide.

نظرة عامة
عرض مقاييسك الرئيسية وأنشطة المشروع الأخيرة. تتبع التقدم عبر جميع مشاريعك النشطة.
لديك ١٢ مشروعًا نشطًا و٣ مهام معلقة.
import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import {
  cardClass, cardHeaderClass, cardTitleClass, cardDescriptionClass, cardContentClass,
} from '#components/ui/card.ts';

const translations = {
  en: {
    dir: 'ltr',
    values: {
      overview: 'Overview',
      analytics: 'Analytics',
      reports: 'Reports',
      settings: 'Settings',
      overviewTitle: 'Overview',
      overviewDesc:
        'View your key metrics and recent project activity. Track progress across all your active projects.',
      overviewContent: 'You have 12 active projects and 3 pending tasks.',
      analyticsTitle: 'Analytics',
      analyticsDesc:
        'Track performance and user engagement metrics. Monitor trends and identify growth opportunities.',
      analyticsContent: 'Page views are up 25% compared to last month.',
      reportsTitle: 'Reports',
      reportsDesc:
        'Generate and download your detailed reports. Export data in multiple formats for analysis.',
      reportsContent: 'You have 5 reports ready and available to export.',
      settingsTitle: 'Settings',
      settingsDesc:
        'Manage your account preferences and options. Customize your experience to fit your needs.',
      settingsContent: 'Configure notifications, security, and themes.',
    },
  },
  ar: {
    dir: 'rtl',
    values: {
      overview: 'نظرة عامة',
      analytics: 'التحليلات',
      reports: 'التقارير',
      settings: 'الإعدادات',
      overviewTitle: 'نظرة عامة',
      overviewDesc:
        'عرض مقاييسك الرئيسية وأنشطة المشروع الأخيرة. تتبع التقدم عبر جميع مشاريعك النشطة.',
      overviewContent: 'لديك ١٢ مشروعًا نشطًا و٣ مهام معلقة.',
      analyticsTitle: 'التحليلات',
      analyticsDesc:
        'تتبع مقاييس الأداء ومشاركة المستخدمين. راقب الاتجاهات وحدد فرص النمو.',
      analyticsContent: 'زادت مشاهدات الصفحة بنسبة ٢٥٪ مقارنة بالشهر الماضي.',
      reportsTitle: 'التقارير',
      reportsDesc:
        'إنشاء وتنزيل تقاريرك التفصيلية. تصدير البيانات بتنسيقات متعددة للتحليل.',
      reportsContent: 'لديك ٥ تقارير جاهزة ومتاحة للتصدير.',
      settingsTitle: 'الإعدادات',
      settingsDesc:
        'إدارة تفضيلات حسابك وخياراته. تخصيص تجربتك لتناسب احتياجاتك.',
      settingsContent: 'تكوين الإشعارات والأمان والسمات.',
    },
  },
  he: {
    dir: 'rtl',
    values: {
      overview: 'סקירה כללית',
      analytics: 'אנליטיקה',
      reports: 'דוחות',
      settings: 'הגדרות',
      overviewTitle: 'סקירה כללית',
      overviewDesc:
        'הצג את המדדים העיקריים שלך ופעילות הפרויקט האחרונה. עקוב אחר התקדמות בכל הפרויקטים הפעילים שלך.',
      overviewContent: 'יש לך 12 פרויקטים פעילים ו-3 משימות ממתינות.',
      analyticsTitle: 'אנליטיקה',
      analyticsDesc:
        'עקוב אחר ביצועים ומדדי מעורבות משתמשים. עקוב אחר מגמות וזהה הזדמנויות צמיחה.',
      analyticsContent: 'צפיות בדף עלו ב-25% בהשוואה לחודש שעבר.',
      reportsTitle: 'דוחות',
      reportsDesc:
        'צור והורד את הדוחות המפורטים שלך. ייצא נתונים בפורמטים מרובים לניתוח.',
      reportsContent: 'יש לך 5 דוחות מוכנים וזמינים לייצוא.',
      settingsTitle: 'הגדרות',
      settingsDesc:
        'נהל את העדפות החשבון והאפשרויות שלך. התאם אישית את החוויה שלך כך שתתאים לצרכים שלך.',
      settingsContent: 'הגדר התראות, אבטחה וערכות נושא.',
    },
  },
};

function panel(value: string, title: string, description: string, content: string) {
  return html`
    <ui-tabs-content value=${value}>
      <div data-slot="card" data-size="default" class=${cardClass()}>
        <div data-slot="card-header" class=${cardHeaderClass()}>
          <div data-slot="card-title" class=${cardTitleClass()}>${title}</div>
          <div data-slot="card-description" class=${cardDescriptionClass()}>${description}</div>
        </div>
        <div data-slot="card-content" class=${cn(cardContentClass(), 'text-sm text-muted-foreground')}>${content}</div>
      </div>
    </ui-tabs-content>
  `;
}

// The provider is the dir attribute: the tabs style themselves with logical
// properties, so dir="rtl" on the root flips the whole layout.
export default function TabsRtl() {
  const lang = 'ar';
  const { dir, values: t } = translations[lang];

  return html`
    <ui-tabs value="overview" dir=${dir} lang=${lang} class="w-full max-w-sm">
      <ui-tabs-list>
        <ui-tabs-trigger value="overview">${t.overview}</ui-tabs-trigger>
        <ui-tabs-trigger value="analytics">${t.analytics}</ui-tabs-trigger>
        <ui-tabs-trigger value="reports">${t.reports}</ui-tabs-trigger>
        <ui-tabs-trigger value="settings">${t.settings}</ui-tabs-trigger>
      </ui-tabs-list>
      ${panel('overview', t.overviewTitle, t.overviewDesc, t.overviewContent)}
      ${panel('analytics', t.analyticsTitle, t.analyticsDesc, t.analyticsContent)}
      ${panel('reports', t.reportsTitle, t.reportsDesc, t.reportsContent)}
      ${panel('settings', t.settingsTitle, t.settingsDesc, t.settingsContent)}
    </ui-tabs>
  `;
}
View Code

API Reference

ui-tabs

The root. It owns the selected value and the orientation, and its triggers and panels read both from it.

AttributeTypeDefault
valuestring""
orientation"horizontal" | "vertical""horizontal"

It dispatches ui-value-change with { detail: { value } } after the selected tab changes.

ui-tabs-list

The tablist. Arrow keys move focus and selection between its triggers, and Home and End jump to the first and last.

AttributeTypeDefault
variant"default" | "underline""default"

ui-tabs-trigger

One tab, rendered as a native <button role="tab">. An icon-only trigger needs an aria-label.

AttributeTypeDefault
valuestring""
disabledbooleanfalse

ui-tabs-content

The panel shown while the trigger with the same value is selected. An inactive panel is hidden and inert.

AttributeTypeDefault
valuestring""