List
Sebagian besar layar di produk Sosialoka berawal dari list: rilis, kontrak, pembayaran, artis. Bagian-bagian halaman list selalu sama dan urutannya juga sama, jadi orang tahu harus melihat ke mana di produk mana pun.
Kapan dipakai
Section titled “Kapan dipakai”- Pakai untuk kumpulan data yang orang telusuri, cari, dan olah.
- Untuk satu data, pakai halaman Detail. Kalau kumpulannya masih kosong, tampilkan state kosong, bukan tabel kosong.
Anatomi
Section titled “Anatomi”- Header: judul halaman dan satu aksi utama, misalnya “Rilis baru”.
- Statistik: maksimal empat kartu, masing-masing berisi label dan angka.
- Filter: pencarian di atas, lalu chip status (Toggle Group) beserta jumlah tiap status. Letaknya di atas tabel yang difilter.
- Tabel: di dalam kartu, dengan kolom badge status dan satu tombol aksi baris di ujung.
- Pagination: di bawah tabel, masih di dalam kartu yang sama.
Aturan
Section titled “Aturan”- Satu aksi utama di header. Aksi lain ada di menu baris.
- Menu baris: beri tombolnya nama sesuai barisnya (“Aksi untuk Senja di Kota”). Item destruktif ditaruh paling akhir, setelah pemisah.
- Status: pakai badge status (
success,warning,info,destructive), jangan warna brand. - Angka: rata kanan hanya di kolom uang. Pakai
tabular-nums, dan tulis Rupiah dengan dua desimal. - Chip status selalu punya satu status aktif: “Semua” sebagai bawaan, dan klik pada chip yang aktif tetap membuatnya aktif.
- Filter menyimpan nilainya di URL, jadi tautan yang dibagikan membuka tampilan yang sama.
- Di HP, ubah tabel menjadi accordion: lihat Tabel responsif.
import { useState, type MouseEvent } from "react"import { MoreHorizontalIcon, PlusIcon, SearchIcon } from "lucide-react"import { Badge } from "@/components/ui/badge"import { Button } from "@/components/ui/button"import { Card, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger,} from "@/components/ui/dropdown-menu"import { Input } from "@/components/ui/input"import { Pagination, PaginationContent, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious,} from "@/components/ui/pagination"import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group"import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@/components/ui/table"
const stats = [ { label: "Rilis aktif", value: "24" }, { label: "Menunggu dikirim", value: "3" }, { label: "Royalti bulan ini", value: "Rp4.812.500,00" },]
const statuses = [ { label: "Semua", value: "semua", count: 24 }, { label: "Terbit", value: "terbit", count: 12 }, { label: "Menunggu", value: "menunggu", count: 8 }, { label: "Ditolak", value: "ditolak", count: 4 },]
const releases = [ { title: "Senja di Kota", artist: "Raka Pratama", status: "success", label: "Terbit", date: "14 Nov 2026" }, { title: "Kaset Pertama", artist: "Nadia Senja", status: "warning", label: "Menunggu", date: "21 Nov 2026" }, { title: "Pulang Sore", artist: "Bima Laras", status: "info", label: "Dijadwalkan", date: "28 Nov 2026" }, { title: "Lampu Kota", artist: "Sinta Maharani", status: "destructive", label: "Ditolak", date: "2 Nov 2026" },] as const
/** Two pages of four rows; the demo shows the first page's rows on both. */const pages = [1, 2]
/** A list page: title and one main action, stats, filters above the table, row actions in a menu, pages below. */export default function ListPageDemo() { const [page, setPage] = useState(1) const [status, setStatus] = useState("semua") const goTo = (next: number) => (event: MouseEvent) => { event.preventDefault() setPage(next) } return ( <div className="min-h-svh bg-background p-6 text-foreground"> <div className="mx-auto grid max-w-5xl gap-6"> <div className="flex items-center justify-between gap-4"> <h1 className="text-2xl font-semibold">Rilis</h1> <Button> <PlusIcon /> Rilis baru </Button> </div>
<div className="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>
<div className="flex flex-wrap items-center gap-3"> <div className="relative w-full max-w-xs"> <SearchIcon className="pointer-events-none absolute top-1/2 left-2.5 size-4 -translate-y-1/2 text-muted-foreground" /> <Input type="search" aria-label="Cari rilis" placeholder="Cari judul atau artis" className="pl-8" /> </div> </div>
<ToggleGroup variant="outline" spacing={2} aria-label="Filter status" value={[status]} // A status filter always has one value: clicking the active chip keeps it on. onValueChange={(value) => value.length > 0 && setStatus(value[value.length - 1])} > {statuses.map((s) => ( <ToggleGroupItem key={s.value} value={s.value}> {s.label} <span className="tabular-nums text-muted-foreground">{s.count}</span> </ToggleGroupItem> ))} </ToggleGroup>
<div className="rounded-xl border border-border bg-card"> <Table> <TableHeader> <TableRow> <TableHead>Judul</TableHead> <TableHead>Artis</TableHead> <TableHead>Status</TableHead> <TableHead>Tanggal rilis</TableHead> <TableHead className="w-12"> <span className="sr-only">Aksi</span> </TableHead> </TableRow> </TableHeader> <TableBody> {releases.map((r) => ( <TableRow key={r.title}> <TableCell className="font-medium">{r.title}</TableCell> <TableCell className="text-muted-foreground">{r.artist}</TableCell> <TableCell> <Badge variant={r.status}>{r.label}</Badge> </TableCell> <TableCell className="tabular-nums">{r.date}</TableCell> <TableCell> <DropdownMenu> <DropdownMenuTrigger render={<Button variant="ghost" size="icon-sm" aria-label={`Aksi untuk ${r.title}`} />} > <MoreHorizontalIcon /> </DropdownMenuTrigger> <DropdownMenuContent align="end"> <DropdownMenuItem>Lihat</DropdownMenuItem> <DropdownMenuItem>Ubah</DropdownMenuItem> <DropdownMenuSeparator /> <DropdownMenuItem variant="destructive">Hapus</DropdownMenuItem> </DropdownMenuContent> </DropdownMenu> </TableCell> </TableRow> ))} </TableBody> </Table> <Pagination className="border-t border-border py-2"> <PaginationContent> <PaginationItem> <PaginationPrevious href="#" disabled={page === 1} onClick={goTo(page - 1)} /> </PaginationItem> {pages.map((p) => ( <PaginationItem key={p}> <PaginationLink href="#" isActive={p === page} onClick={goTo(p)}> {p} </PaginationLink> </PaginationItem> ))} <PaginationItem> <PaginationNext href="#" disabled={page === pages.length} onClick={goTo(page + 1)} /> </PaginationItem> </PaginationContent> </Pagination> </div> </div> </div> )}<script setup lang="ts">import { ref } from "vue"import { MoreHorizontal, Plus, Search } from "@lucide/vue"import { Badge } from "@/components/ui/badge"import { Button } from "@/components/ui/button"import { Card, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger,} from "@/components/ui/dropdown-menu"import { Input } from "@/components/ui/input"import { Pagination, PaginationContent, PaginationItem, PaginationNext, PaginationPrevious,} from "@/components/ui/pagination"import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group"import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@/components/ui/table"
/** A list page: title and one main action, stats, filters above the table, row actions in a menu, pages below. */const stats = [ { label: "Rilis aktif", value: "24" }, { label: "Menunggu dikirim", value: "3" }, { label: "Royalti bulan ini", value: "Rp4.812.500,00" },]
const statuses = [ { label: "Semua", value: "semua", count: 24 }, { label: "Terbit", value: "terbit", count: 12 }, { label: "Menunggu", value: "menunggu", count: 8 }, { label: "Ditolak", value: "ditolak", count: 4 },]
const releases = [ { title: "Senja di Kota", artist: "Raka Pratama", status: "success", label: "Terbit", date: "14 Nov 2026" }, { title: "Kaset Pertama", artist: "Nadia Senja", status: "warning", label: "Menunggu", date: "21 Nov 2026" }, { title: "Pulang Sore", artist: "Bima Laras", status: "info", label: "Dijadwalkan", date: "28 Nov 2026" }, { title: "Lampu Kota", artist: "Sinta Maharani", status: "destructive", label: "Ditolak", date: "2 Nov 2026" },] as constconst status = ref("semua")// A status filter always has one value: clicking the active chip keeps it on.function pickStatus(value: unknown) { if (typeof value === "string" && value) status.value = value}</script>
<template> <div class="min-h-svh bg-background p-6 text-foreground"> <div class="mx-auto grid max-w-5xl gap-6"> <div class="flex items-center justify-between gap-4"> <h1 class="text-2xl font-semibold">Rilis</h1> <Button><Plus />Rilis baru</Button> </div>
<div class="grid gap-4 sm:grid-cols-3"> <Card v-for="stat in stats" :key="stat.label"> <CardHeader> <CardDescription>{{ stat.label }}</CardDescription> <CardTitle class="text-2xl tabular-nums">{{ stat.value }}</CardTitle> </CardHeader> </Card> </div>
<div class="flex flex-wrap items-center gap-3"> <div class="relative w-full max-w-xs"> <Search class="pointer-events-none absolute top-1/2 left-2.5 size-4 -translate-y-1/2 text-muted-foreground" /> <Input type="search" aria-label="Cari rilis" placeholder="Cari judul atau artis" class="pl-8" /> </div> </div>
<ToggleGroup type="single" variant="outline" :spacing="2" aria-label="Filter status" :model-value="status" @update:model-value="pickStatus"> <ToggleGroupItem v-for="s in statuses" :key="s.value" :value="s.value"> {{ s.label }} <span class="tabular-nums text-muted-foreground">{{ s.count }}</span> </ToggleGroupItem> </ToggleGroup>
<div class="rounded-xl border border-border bg-card"> <Table> <TableHeader> <TableRow> <TableHead>Judul</TableHead> <TableHead>Artis</TableHead> <TableHead>Status</TableHead> <TableHead>Tanggal rilis</TableHead> <TableHead class="w-12"><span class="sr-only">Aksi</span></TableHead> </TableRow> </TableHeader> <TableBody> <TableRow v-for="r in releases" :key="r.title"> <TableCell class="font-medium">{{ r.title }}</TableCell> <TableCell class="text-muted-foreground">{{ r.artist }}</TableCell> <TableCell><Badge :variant="r.status">{{ r.label }}</Badge></TableCell> <TableCell class="tabular-nums">{{ r.date }}</TableCell> <TableCell> <DropdownMenu> <DropdownMenuTrigger as-child> <Button variant="ghost" size="icon-sm" :aria-label="`Aksi untuk ${r.title}`"><MoreHorizontal /></Button> </DropdownMenuTrigger> <DropdownMenuContent align="end"> <DropdownMenuItem>Lihat</DropdownMenuItem> <DropdownMenuItem>Ubah</DropdownMenuItem> <DropdownMenuSeparator /> <DropdownMenuItem variant="destructive">Hapus</DropdownMenuItem> </DropdownMenuContent> </DropdownMenu> </TableCell> </TableRow> </TableBody> </Table> <Pagination v-slot="{ page }" :items-per-page="4" :total="8" :default-page="1" class="border-t border-border py-2"> <PaginationContent v-slot="{ items }"> <PaginationPrevious /> <template v-for="(item, index) in items" :key="index"> <PaginationItem v-if="item.type === 'page'" :value="item.value" :is-active="item.value === page"> {{ item.value }} </PaginationItem> </template> <PaginationNext /> </PaginationContent> </Pagination> </div> </div> </div></template>// A list page: title and one main action, stats, filters above the table, row actions in a menu, pages below.import 'package:flutter/widgets.dart';import 'package:shadcn_ui/shadcn_ui.dart';import 'package:sosialoka_ui/sosialoka_ui.dart';
const _stats = [('Rilis aktif', '24'), ('Menunggu dikirim', '3'), ('Royalti bulan ini', 'Rp4.812.500,00')];const _releases = [ (title: 'Senja di Kota', artist: 'Raka Pratama', status: 'Terbit', date: '14 Nov 2026'), (title: 'Kaset Pertama', artist: 'Nadia Senja', status: 'Menunggu', date: '21 Nov 2026'), (title: 'Pulang Sore', artist: 'Bima Laras', status: 'Dijadwalkan', date: '28 Nov 2026'),];
class ListPageDemo extends StatelessWidget { const ListPageDemo({super.key});
@override Widget build(BuildContext context) { final theme = ShadTheme.of(context); return ConstrainedBox( constraints: const BoxConstraints(maxWidth: 880), child: Column( mainAxisSize: MainAxisSize.min, crossAxisAlignment: CrossAxisAlignment.stretch, children: [ Row( children: [ Expanded(child: Text('Rilis', style: theme.textTheme.h3)), ShadButton( leading: const Icon(LucideIcons.plus, size: 16), onPressed: () {}, child: const Text('Rilis baru'), ), ], ), const SizedBox(height: 16), Row( children: [ for (final (label, value) in _stats) ...[ Expanded( child: ShadCard(description: Text(label), title: Text(value, style: theme.textTheme.h4)), ), if (label != _stats.last.$1) const SizedBox(width: 16), ], ], ), const SizedBox(height: 16), const SizedBox( width: 320, child: ShadInput( placeholder: Text('Cari judul atau artis'), leading: Icon(LucideIcons.search, size: 16), ), ), const SizedBox(height: 12), // A status filter always has one value: allowDeselection keeps the active chip on. ShadToggleGroup<String>( initialValue: 'semua', allowDeselection: false, variant: ShadToggleVariant.outline, spacing: 8, items: [ for (final (value, label, count) in const [('semua', 'Semua', 24), ('terbit', 'Terbit', 12), ('menunggu', 'Menunggu', 8), ('ditolak', 'Ditolak', 4)]) ShadToggleGroupItem( value: value, child: Row( mainAxisSize: MainAxisSize.min, spacing: 6, children: [Text(label), Text('$count', style: theme.textTheme.muted)], ), ), ], ), const SizedBox(height: 16), ShadCard( padding: EdgeInsets.zero, child: SizedBox( height: 200, child: ShadTable.list( columnSpanExtent: (index) => switch (index) { 0 => const FixedTableSpanExtent(220), 1 => const FixedTableSpanExtent(180), 2 => const FixedTableSpanExtent(150), 3 => const FixedTableSpanExtent(150), _ => const RemainingTableSpanExtent(), }, header: const [ ShadTableCell.header(child: Text('Judul')), ShadTableCell.header(child: Text('Artis')), ShadTableCell.header(child: Text('Status')), ShadTableCell.header(child: Text('Tanggal rilis')), ShadTableCell.header(child: SizedBox.shrink()), ], children: _releases.map( (r) => [ ShadTableCell(child: Text(r.title, style: const TextStyle(fontWeight: FontWeight.w500))), ShadTableCell(child: Text(r.artist)), ShadTableCell(child: ShadBadge.outline(child: Text(r.status))), ShadTableCell(child: Text(r.date)), ShadTableCell(child: _RowActions(title: r.title)), ], ), ), ), ), const SizedBox(height: 8), Row( mainAxisAlignment: MainAxisAlignment.center, children: [ ShadButton.ghost(onPressed: () {}, child: const Text('Sebelumnya')), ShadButton.outline(onPressed: () {}, child: const Text('1')), ShadButton.ghost(onPressed: () {}, child: const Text('2')), ShadButton.ghost(onPressed: () {}, child: const Text('Berikutnya')), ], ), ], ), ); }}
/// The row's actions behind one button, with the destructive one last.class _RowActions extends StatefulWidget { const _RowActions({required this.title});
final String title;
@override State<_RowActions> createState() => _RowActionsState();}
class _RowActionsState extends State<_RowActions> { final controller = ShadContextMenuController();
@override void dispose() { controller.dispose(); super.dispose(); }
@override Widget build(BuildContext context) { return ShadContextMenu( controller: controller, items: [ const ShadContextMenuItem(child: Text('Lihat')), const ShadContextMenuItem(child: Text('Ubah')), const ShadSeparator.horizontal(margin: EdgeInsets.symmetric(vertical: 4)), ShadContextMenuItem(child: Text('Hapus', style: TextStyle(color: context.sosialoka.destructive))), ], child: Semantics( label: 'Aksi untuk ${widget.title}', child: ShadIconButton.ghost(icon: const Icon(LucideIcons.ellipsis), onPressed: controller.toggle), ), ); }}Dibangun dari
Section titled “Dibangun dari”Button, Card, Input, Toggle Group, Table, Badge, dan Dropdown Menu.
Flutter
Section titled “Flutter”Baris tabel diisi lewat ShadTable.list. shadcn_ui tidak punya widget pagination, jadi taruh tombol outline dan ghost di bawah tabel. Buka aksi baris lewat ShadContextMenu, dan beri tombolnya label semantik.
