# Tabs

> Berpindah antartampilan dari isi yang sama.

Tabs memindahkan tampilan dari isi yang sama, misalnya ringkasan, rilis, dan royalti satu artis.

## Kapan dipakai

- Pakai untuk 2 sampai 6 tampilan yang setara.
- Pastikan isi setiap tab saling terkait. Isi yang tidak terkait ditaruh di halaman terpisah.
- Jangan pakai tabs sebagai langkah-langkah proses; pakai stepper.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/tabs/_

## Anatomi

1. Tab aktif
2. Indikator di primary
3. Tab
4. Panel

Deretan label di atas garis `border`, dan isi tab aktif di bawahnya. Tab aktif memakai teks `foreground` dengan garis 2px `primary` di bawahnya, sedangkan yang lain memakai `muted-foreground`. Tinggi tab 36px, dan tidak pernah berada di atas latar pil.

## Varian

Hanya ada satu gaya, mendatar atau tegak (`orientation="vertical"`). Di tabs tegak, garisnya pindah ke tepi kanan.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `defaultValue` / `value` | `default-value` / `v-model` | `value` | string | tidak ada | Tab yang aktif. |
| `onValueChange` | `@update:model-value` | `onChanged` | function | tidak ada | Jalan saat tab berganti. |
| `orientation` | `orientation` | tidak ada | `horizontal` \| `vertical` | `horizontal` | Arah daftar tab. |

## Kode

**React**
```tsx
import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs"

export default function TabsDemo() {
  return (
    <Tabs defaultValue="ringkasan" className="w-full max-w-md">
      <TabsList>
        <TabsTrigger value="ringkasan">Ringkasan</TabsTrigger>
        <TabsTrigger value="rilis">Rilis</TabsTrigger>
        <TabsTrigger value="royalti">Royalti</TabsTrigger>
      </TabsList>
      <TabsContent value="ringkasan" className="pt-3 text-muted-foreground">12 rilis aktif bulan ini.</TabsContent>
      <TabsContent value="rilis" className="pt-3 text-muted-foreground">3 rilis menunggu dikirim.</TabsContent>
      <TabsContent value="royalti" className="pt-3 text-muted-foreground">Laporan Oktober sudah masuk.</TabsContent>
    </Tabs>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs"
</script>

<template>
  <Tabs default-value="ringkasan" class="w-full max-w-md">
    <TabsList>
      <TabsTrigger value="ringkasan">Ringkasan</TabsTrigger>
      <TabsTrigger value="rilis">Rilis</TabsTrigger>
      <TabsTrigger value="royalti">Royalti</TabsTrigger>
    </TabsList>
    <TabsContent value="ringkasan" class="pt-3 text-muted-foreground">12 rilis aktif bulan ini.</TabsContent>
    <TabsContent value="rilis" class="pt-3 text-muted-foreground">3 rilis menunggu dikirim.</TabsContent>
    <TabsContent value="royalti" class="pt-3 text-muted-foreground">Laporan Oktober sudah masuk.</TabsContent>
  </Tabs>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class TabsDemo extends StatelessWidget {
  const TabsDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return ShadTabs<String>(
      value: 'ringkasan',
      // Tabs share the bar width equally; leave room for the longest label.
      tabBarConstraints: const BoxConstraints(maxWidth: 520),
      tabs: const [
        ShadTab(value: 'ringkasan', content: Text('12 rilis aktif bulan ini.'), child: Text('Ringkasan')),
        ShadTab(value: 'rilis', content: Text('3 rilis menunggu dikirim.'), child: Text('Rilis')),
        ShadTab(value: 'royalti', content: Text('Laporan Oktober sudah masuk.'), child: Text('Royalti')),
      ],
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/tabs.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/tabs.json
```

## Aksesibilitas

- Dirender dengan `role="tablist"`, `tab`, dan `tabpanel`, dengan `aria-selected` di tab aktif.
- Tombol panah berpindah antartab, dan Tab masuk ke panel.
