Lewati ke konten

Dasbor

Unduh .md

Kerangka dasbor adalah tempat kedua yang membuat semua produk Sosialoka terlihat satu keluarga (Alternatif A). Menu, pencarian, dan akun ada di tempat yang sama di setiap produk, jadi orang yang memakai lebih dari satu produk tidak perlu mencarinya lagi.

  • Pakai untuk semua halaman aplikasi web setelah orang masuk.
  • Taruh list, detail, dan form di dalamnya. Jangan bikin header atau sidebar kedua.
LakukanBatasi aksi header berupa ikon, masing-masing dinamai tooltip, dengan avatar paling akhir.
JanganJangan isi header dengan tombol teks; tombol itu mendesak pencarian dan sesak di layar kecil.
123456
  1. 1Sidebar dengan logo produk
  2. 2Kartu header, melayang di atas blur
  3. 3Pencarian: membuka command palette
  4. 4Dropdown kode bahasa, lalu aksi ikon dengan tooltip
  5. 5Avatar dan menu akun, selalu paling akhir
  6. 6Isi di background
  • Sidebar: lebar 16rem di permukaan putih sidebar, dengan logo produk di atas. Menu yang aktif memakai sidebar-accent dan punya aria-current="page".
  • Kartu header: satu kartu setinggi 56px (h-14 rounded-lg border-border bg-card shadow-md) yang tetap di atas saat halaman digulir di bawah blur. Isinya pencarian, aksi ikon, dan avatar, seperti header Cover Clearance.
  • Pencarian: mengisi sisi kiri kartu tanpa kotak sendiri dan membuka command palette. ⌘K atau Ctrl+K juga membukanya.
  • Aksi: bahasa berupa pill bergaris berisi kodenya, lalu tombol ikon ghost 36px berwarna muted-foreground, masing-masing dinamai tooltip.
  • Akun: avatar, selalu paling akhir, membuka menu akun.
  • Isi: halamanmu, di atas background.
  • Satu pencarian: kartu dan ⌘K membuka palette yang sama. Blok ini hanya mendengarkan ⌘K sekali per halaman, jadi tidak akan muncul palette kedua di atas kartu pencarian dari Command.
  • Menu: lima sampai tujuh item dengan ikon. Pengaturan ditaruh paling bawah. Produk dengan lebih banyak halaman mengikuti Menu navigasi.
  • Aksi: bahasa paling depan, lalu maksimal tiga aksi ikon dengan urutan: mode, bantuan, notifikasi. Susun mode dengan DashboardModeSelect dan aksi lain dengan DashboardIconButton; label-nya jadi tooltip dan nama tombol.
  • Mode: DashboardModeSelect, menu berisi Terang, Gelap, dan Auto. Auto mengikuti pengaturan perangkat dan jadi pilihan awal pengguna baru. Selama di Auto, halaman ikut berganti saat perangkat berganti mode, tanpa reload. Ikonnya menunjukkan pilihan (matahari, bulan, atau monitor untuk Auto) dan tooltip menyebutnya, misalnya “Mode: Auto”. useColorMode() memasang data-theme di <html> dan mengingat pilihannya; pasang mode yang sama lewat script inline di <head> supaya halaman tidak berkedip. Flutter: ThemeMode.light, ThemeMode.dark, dan ThemeMode.system (Auto).
  • Bahasa: DashboardLanguageSelect, seperti di Lokasign: pemicu dropdown bergaris berisi kode bahasa saat ini, “ID” atau “EN”, dalam huruf mono dan chevron. Pemicu ini membuka menu bahasa, dengan bahasa aktif ditandai. Bentuknya pill (rounded-full), satu-satunya pill di header, dan tetap berupa menu supaya bahasa lain bisa ditambahkan.
  • Notifikasi: badge menampilkan jumlah yang belum dibaca; jangan tampilkan saat nol. Lonceng membuka panel dari Notifikasi.
  • Menu akun: tampilkan nama dan satu baris keterangan, lalu aksinya. “Keluar” ditaruh paling akhir sebagai item destruktif.
  • Layar kecil: di bawah md, sidebar berubah menjadi sheet yang dibuka dari tombol menu.
  • Bingkai pratinjau: collapsible="none" menjaga sidebar tetap di alur halaman, misalnya di dalam bingkai di halaman dokumentasi.
React Vue Flutter Tipe Bawaan Kegunaan
nav nav daftar ShadButton.ghost halaman, induk, atau bagian tidak ada Menu. Untuk bagian, sub menu, dan hitungan, lihat Menu navigasi.
logo slot #logo widget elemen tidak ada Logo produk di atas sidebar.
account account ShadAvatar { name, initials, detail?, menu } tidak ada Avatar dan menunya. Item menu boleh punya onSelect dan destructive.
actions slot #actions ShadButton.outline dan ShadIconButton.ghost di dalam ShadTooltip elemen tidak ada Aksi di antara pencarian dan avatar: DashboardLanguageSelect (value, options, onValueChange, label; Vue v-model), DashboardModeSelect (value, onValueChange, labels; Vue v-model) bersama useColorMode(storageKey?), lalu DashboardIconButton (label, badge?, ikonnya sebagai anak).
search search ShadInput di dalam ShadCard { groups: { heading, items }[] } tidak ada Isi palette. Item menjalankan onSelect miliknya.
collapsible collapsible tidak ada offcanvas, icon, none offcanvas Cara sidebar menutup.
labels labels Text { search, empty, account, menu } bahasa Inggris Teks kartu pencarian, palette, dan screen reader. Contohnya mengisi bahasa Indonesia.
children slot bawaan anak Expanded elemen tidak ada Isi halaman.
import { useState } from "react"
import { BarChart3Icon, BellIcon, DiscIcon, FileTextIcon, HomeIcon, SettingsIcon } from "lucide-react"
import {
DashboardIconButton,
DashboardLanguageSelect,
DashboardModeSelect,
DashboardShell,
useColorMode,
} from "@/components/blocks/dashboard-shell"
import { Card, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"
const nav = [
{ title: "Dasbor", href: "#", icon: HomeIcon, active: true },
{ title: "Rilis", href: "#rilis", icon: DiscIcon },
{ title: "Royalti", href: "#royalti", icon: BarChart3Icon },
{ title: "Dokumen", href: "#dokumen", icon: FileTextIcon },
{ title: "Pengaturan", href: "#pengaturan", icon: SettingsIcon },
]
const stats = [
{ label: "Rilis aktif", value: "24" },
{ label: "Streaming bulan ini", value: "182.430" },
{ label: "Royalti bulan ini", value: "Rp4.812.500,00" },
]
export default function DashboardShellDemo() {
const [mode, setMode] = useColorMode()
const [language, setLanguage] = useState("id")
return (
<DashboardShell
nav={nav}
actions={
<>
<DashboardLanguageSelect
label="Bahasa"
value={language}
onValueChange={setLanguage}
options={[
{ code: "id", label: "Bahasa Indonesia" },
{ code: "en", label: "English" },
]}
/>
<DashboardModeSelect
value={mode}
onValueChange={setMode}
labels={{ mode: "Mode", light: "Terang", dark: "Gelap", auto: "Auto" }}
/>
<DashboardIconButton label="Notifikasi" badge={3}>
<BellIcon />
</DashboardIconButton>
</>
}
labels={{ search: "Cari rilis, artis, atau dokumen", empty: "Tidak ada yang cocok.", account: "Akun {name}", menu: "Buka menu" }}
logo={
<span className="flex items-center gap-2 font-semibold">
<span className="size-7 rounded-md bg-primary" />
Produkmu
</span>
}
account={{
name: "Raka Pratama",
initials: "RP",
detail: "raka@contoh.id",
menu: [{ label: "Profil" }, { label: "Pengaturan akun" }, { label: "Keluar", destructive: true }],
}}
search={{
groups: [
{ heading: "Rilis", items: [{ label: "Senja di Kota" }, { label: "Kaset Pertama" }] },
{ heading: "Menu", items: nav.map((item) => ({ label: item.title })) },
],
}}
>
<h1 className="text-2xl font-semibold">Dasbor</h1>
<p className="mt-1 text-sm text-muted-foreground">Ringkasan katalogmu minggu ini.</p>
<div className="mt-6 grid gap-4 sm:grid-cols-3">
{stats.map((stat) => (
<Card key={stat.label}>
<CardHeader>
<CardDescription>{stat.label}</CardDescription>
<CardTitle className="text-2xl tabular-nums">{stat.value}</CardTitle>
</CardHeader>
</Card>
))}
</div>
</DashboardShell>
)
}
Terminal window
npx shadcn@latest add https://design.sosialoka.tech/r/react/dashboard-shell.json

Blok ini dipasang di components/blocks/. Sidebar, Command, Dropdown Menu, dan Avatar versi Sosialoka ikut terpasang.

Flutter tidak punya blok. Kode Flutter-nya menyusun kerangka yang sama dari widget: kolom sidebar, kartu header berisi pencarian, aksi ikon, dan avatar, lalu isi. Di ponsel, pindahkan menu ke sheet.

  • Menu yang aktif punya aria-current="page".
  • Pencarian berupa tombol, dan namanya adalah teks pencariannya. Petunjuk ⌘K tampil di sebelahnya.
  • Setiap aksi ikon dinamai label-nya, dan hitungannya ikut dibacakan, misalnya “Notifikasi (3)”.
  • Tombol mode dibacakan beserta pilihannya, misalnya “Mode: Auto”, dan menunya menandai pilihan itu.
  • Tombol avatar bernama “Akun” diikuti nama akunnya.