Lewati ke konten

Progress

Unduh .md

Progress menunjukkan sejauh mana tugas yang panjangnya diketahui sudah berjalan, misalnya mengunggah file master.

  • Pakai untuk unggahan, impor, dan tugas lain yang melaporkan persentase.
  • Pakai Spinner kalau panjangnya tidak diketahui.
  • Selalu tampilkan label di atas bar, dan persentasenya bila membantu.
React
Mengunggah master.wav
x
Vue
Mengunggah master.wav64%
1234
  1. 1Label
  2. 2Nilai
  3. 3Track
  4. 4Indikator

Label dan nilai opsional di atas track berbentuk pil setinggi 8px (h-2) berwarna muted, terisi primary sampai nilainya.

Hanya ada satu gaya.

React Vue Flutter Tipe Default Kegunaan
value model-value value (0 sampai 1) angka React: tidak ada, yang membuat bar indeterminate; Vue: 0 Kemajuan tugas, 0 sampai 100 di web.
ProgressLabel aria-labelledby ke label yang terlihat semanticsLabel teks tidak ada Nama tugasnya.
ProgressValue teks di samping label semanticsValue teks tidak ada Menampilkan persentase.
import { Progress, ProgressLabel, ProgressValue } from "@/components/ui/progress"
export default function ProgressDemo() {
return (
<Progress value={64} className="w-full max-w-sm">
<ProgressLabel>Mengunggah master.wav</ProgressLabel>
<ProgressValue />
</Progress>
)
}
Terminal window
npx shadcn@latest add https://design.sosialoka.tech/r/react/progress.json
  • Punya role="progressbar" dengan aria-valuenow, aria-valuemin, dan aria-valuemax.
  • Beri nama lewat label yang terlihat.
  • Jangan umumkan setiap persen; beri tahu saat tugas selesai, misalnya lewat toast.