Lewati ke konten

Kosong, memuat, dan error

Unduh .md

Selain “terisi”, setiap list dan kartu punya tiga state lagi. Tampilkan state itu di tempat isinya seharusnya muncul, dengan ukuran yang sama, supaya halaman tidak melompat.

  • Kosong: kumpulan datanya belum ada isinya, atau tidak ada baris yang cocok dengan filter.
  • Memuat: data sedang diambil. Tampilkan skeleton yang bentuknya mengikuti isi.
  • Error: data gagal dimuat. Sebutkan apa yang gagal dan beri cara untuk mencoba lagi.
React

Belum ada rilis

Rilis pertamamu akan muncul di sini.

Vue

Belum ada rilis

Rilis pertamamu akan muncul di sini.

Isinya judul, satu kalimat tentang apa yang nanti muncul, dan satu aksi untuk mengisinya. Kalau filter menyembunyikan semua baris, aksinya adalah menghapus filter.

React
Memuat rilis…
Vue
Memuat rilis…

Isinya skeleton yang bentuknya mengikuti baris yang akan muncul, aria-busy="true" di wadahnya, dan satu kalimat untuk screen reader. Kalau proses memuat lebih cepat dari sekitar 300 ms, skeleton tidak perlu ditampilkan.

import { Skeleton } from "@/components/ui/skeleton"
/** Loading: skeletons in the shape of the rows that are coming, and a sentence for screen readers. */
export default function LoadingStateDemo() {
return (
<div aria-busy="true" className="grid w-full max-w-md gap-4 rounded-xl border border-border bg-card p-4">
<span className="sr-only">Memuat rilis…</span>
{[0, 1, 2].map((row) => (
<div key={row} className="flex items-center gap-3" aria-hidden="true">
<Skeleton className="size-10 rounded-md" />
<div className="grid flex-1 gap-2">
<Skeleton className="h-4 w-2/3" />
<Skeleton className="h-3 w-1/3" />
</div>
</div>
))}
</div>
)
}
React
Vue

Isinya role="alert", apa yang gagal, apa yang perlu dilakukan, dan tombol “Coba lagi”. Kalau backend mengirim pesan, pakai pesan itu.

import { RefreshCwIcon, TriangleAlertIcon } from "lucide-react"
import { Button } from "@/components/ui/button"
/** Loading failed: what failed, what to do next, and a way to try again. */
export default function ErrorStateDemo() {
return (
<div
role="alert"
className="flex w-full max-w-md flex-col items-center gap-4 rounded-xl border border-border bg-card px-6 py-10 text-center"
>
<span className="grid size-12 place-items-center rounded-lg bg-destructive-soft text-destructive">
<TriangleAlertIcon className="size-6" />
</span>
<div className="grid gap-1">
<h2 className="text-lg font-semibold">Rilis belum bisa dimuat</h2>
<p className="text-sm text-muted-foreground">Cek koneksimu, lalu coba lagi.</p>
</div>
<Button variant="outline">
<RefreshCwIcon />
Coba lagi
</Button>
</div>
)
}
import { DiscIcon, PlusIcon } from "lucide-react"
import { Button } from "@/components/ui/button"
/** Nothing here yet: what will appear, in one sentence, and the one action that fills it. */
export default function EmptyStateDemo() {
return (
<div className="flex w-full max-w-md flex-col items-center gap-4 rounded-xl border border-dashed border-border px-6 py-10 text-center">
<span className="grid size-12 place-items-center rounded-lg bg-muted text-muted-foreground">
<DiscIcon className="size-6" />
</span>
<div className="grid gap-1">
<h2 className="text-lg font-semibold">Belum ada rilis</h2>
<p className="text-sm text-muted-foreground">Rilis pertamamu akan muncul di sini.</p>
</div>
<Button>
<PlusIcon />
Rilis baru
</Button>
</div>
)
}

Button dan Skeleton, yang ikut terpasang bersama Sidebar.

shadcn_ui tidak punya widget skeleton. Kotak berwarna muted dengan radius tema sudah cukup. Bungkus state error dengan Semantics(liveRegion: true).