Sidebar
Sidebar adalah navigasi utama dasbor Sosialoka, di sisi kiri setiap halaman.
Kapan dipakai
Section titled “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.
Anatomi
Section titled “Anatomi”- 1Logo produk
- 2Item aktif
- 3Kartu pencarian
- 4Isi
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
Section titled “Varian”collapsible="offcanvas"(bawaan): bergeser keluar di layar kecil.collapsible="icon": menyusut menjadi ikon saja.collapsible="none": selalu tampil, seperti di preview.
| 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. |
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> )}<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>// 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
Section titled “Pasang”npx shadcn@latest add https://design.sosialoka.tech/r/react/sidebar.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/sidebar.jsonPerintah ini juga memasang sheet, separator, skeleton, tooltip, input, dan button versi Sosialoka.
Aksesibilitas
Section titled “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.
