# Sidebar

> Navigasi utama sebuah dasbor.

Sidebar adalah navigasi utama dasbor Sosialoka, di sisi kiri setiap halaman.

## Kapan dipakai

- Pakai untuk 4 sampai 8 bagian utama sebuah produk.
- Kelompokkan item yang terkait di bawah label kalau jumlahnya lebih dari enam.
- Aksi untuk satu halaman ditaruh di halaman itu, bukan di sidebar.

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

## Anatomi

1. Logo produk
2. Item aktif
3. Kartu pencarian
4. Isi

Ini sidebar dari kerangka dasbor Alternatif A: panel putih (`sidebar`) selebar 16rem, dengan item ikon dan label ber-`radius-md`. Item aktif memakai `sidebar-accent` dengan teks `sidebar-accent-foreground`, yaitu warna lembut produknya. Di layar kecil, sidebar berubah menjadi sheet yang bergeser masuk.

## Varian

- `collapsible="offcanvas"` (bawaan): bergeser keluar di layar kecil.
- `collapsible="icon"`: menyusut menjadi ikon saja.
- `collapsible="none"`: selalu tampil, seperti di preview.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `SidebarProvider` | `SidebarProvider` | tidak ada | elemen | tidak ada | Menyimpan status buka-tutup; membungkus layout. |
| `collapsible` | `collapsible` | tidak ada | lihat Varian | `offcanvas` | Cara menyusut. |
| `SidebarMenuButton isActive` | `SidebarMenuButton :is-active` | `backgroundColor` dari `sidebar-accent` | boolean | `false` | Menandai bagian yang sedang dibuka. |
| `SidebarMenuButton render` | `SidebarMenuButton as-child` | `onPressed` | elemen | button | Merender item sebagai link. |

## Kode

**React**
```tsx
import { BarChart3Icon, DiscIcon, FileTextIcon, HomeIcon, SettingsIcon } from "lucide-react"
import {
  Sidebar,
  SidebarContent,
  SidebarGroup,
  SidebarGroupContent,
  SidebarMenu,
  SidebarMenuButton,
  SidebarMenuItem,
  SidebarProvider,
} from "@/components/ui/sidebar"

const items = [
  { title: "Dasbor", icon: HomeIcon, active: true },
  { title: "Rilis", icon: DiscIcon },
  { title: "Royalti", icon: BarChart3Icon },
  { title: "Dokumen", icon: FileTextIcon },
  { title: "Pengaturan", icon: SettingsIcon },
]

export default function SidebarDemo() {
  return (
    <SidebarProvider className="min-h-0 w-auto">
      <div className="h-96 overflow-hidden rounded-lg border border-border">
        <Sidebar collapsible="none">
          <SidebarContent>
            <SidebarGroup>
              <SidebarGroupContent>
                <SidebarMenu>
                  {items.map((item) => (
                    <SidebarMenuItem key={item.title}>
                      <SidebarMenuButton
                        isActive={item.active}
                        render={<a href="#" aria-current={item.active ? "page" : undefined} />}
                      >
                        <item.icon />
                        <span>{item.title}</span>
                      </SidebarMenuButton>
                    </SidebarMenuItem>
                  ))}
                </SidebarMenu>
              </SidebarGroupContent>
            </SidebarGroup>
          </SidebarContent>
        </Sidebar>
      </div>
    </SidebarProvider>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { BarChart3, Disc, FileText, Home, Settings } from "@lucide/vue"
import {
  Sidebar,
  SidebarContent,
  SidebarGroup,
  SidebarGroupContent,
  SidebarMenu,
  SidebarMenuButton,
  SidebarMenuItem,
  SidebarProvider,
} from "@/components/ui/sidebar"

const items = [
  { title: "Dasbor", icon: Home, active: true },
  { title: "Rilis", icon: Disc },
  { title: "Royalti", icon: BarChart3 },
  { title: "Dokumen", icon: FileText },
  { title: "Pengaturan", icon: Settings },
]
</script>

<template>
  <SidebarProvider class="min-h-0 w-auto">
    <div class="h-96 overflow-hidden rounded-lg border border-border">
      <Sidebar collapsible="none">
        <SidebarContent>
          <SidebarGroup>
            <SidebarGroupContent>
              <SidebarMenu>
                <SidebarMenuItem v-for="item in items" :key="item.title">
                  <SidebarMenuButton as-child :is-active="item.active">
                    <a href="#" :aria-current="item.active ? 'page' : undefined">
                      <component :is="item.icon" />
                      <span>{{ item.title }}</span>
                    </a>
                  </SidebarMenuButton>
                </SidebarMenuItem>
              </SidebarMenu>
            </SidebarGroupContent>
          </SidebarGroup>
        </SidebarContent>
      </Sidebar>
    </div>
  </SidebarProvider>
</template>
```

**Flutter**
```dart
// shadcn_ui has no sidebar widget: build it from a Column of ShadButton.ghost items,
// and mark the active one with the primary-soft and primary-text colors of the Sosialoka theme.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

const items = ['Dasbor', 'Rilis', 'Royalti', 'Dokumen', 'Pengaturan'];

class SidebarDemo extends StatelessWidget {
  const SidebarDemo({super.key, this.active = 'Dasbor'});

  final String active;

  @override
  Widget build(BuildContext context) {
    final scheme = ShadTheme.of(context).colorScheme;
    final c = context.sosialoka;
    return Container(
      width: 256,
      color: scheme.card,
      padding: const EdgeInsets.all(8),
      child: Column(
        crossAxisAlignment: CrossAxisAlignment.stretch,
        children: [
          for (final item in items)
            ShadButton.ghost(
              mainAxisAlignment: MainAxisAlignment.start,
              backgroundColor: item == active ? c.primarySoft : null,
              foregroundColor: item == active ? c.primaryText : scheme.foreground,
              onPressed: () {},
              child: Text(item),
            ),
        ],
      ),
    );
  }
}
```

## Pasang

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

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

Perintah ini juga memasang sheet, separator, skeleton, tooltip, input, dan button versi Sosialoka.

## Aksesibilitas

- Render item sebagai link, dan pasang `aria-current="page"` di item yang aktif.
- Tombol buka-tutup butuh `aria-label`. Sidebar juga bisa dibuka-tutup dengan ⌘B atau Ctrl+B.
