Progress
Progress menunjukkan sejauh mana tugas yang panjangnya diketahui sudah berjalan, misalnya mengunggah file master.
Kapan dipakai
Section titled “Kapan dipakai”- 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.
Mengunggah master.wav
Mengunggah master.wav64%
Anatomi
Section titled “Anatomi”- 1Label
- 2Nilai
- 3Track
- 4Indikator
Label dan nilai opsional di atas track berbentuk pil setinggi 8px (h-2) berwarna muted, terisi primary sampai nilainya.
Varian
Section titled “Varian”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> )}<script setup lang="ts">import { useId } from "vue"import { Progress } from "@/components/ui/progress"
const id = useId()</script>
<template> <div class="grid w-full max-w-sm gap-3"> <div class="flex text-sm"> <span :id="`${id}-label`" class="font-medium">Mengunggah master.wav</span> <span class="ml-auto text-muted-foreground tabular-nums">64%</span> </div> <Progress :model-value="64" :aria-labelledby="`${id}-label`" /> </div></template>import 'package:flutter/widgets.dart';import 'package:shadcn_ui/shadcn_ui.dart';
class ProgressDemo extends StatelessWidget { const ProgressDemo({super.key});
@override Widget build(BuildContext context) { final theme = ShadTheme.of(context); return ConstrainedBox( constraints: const BoxConstraints(maxWidth: 384), child: Column( mainAxisSize: MainAxisSize.min, spacing: 12, children: [ Row( children: [ Text('Mengunggah master.wav', style: theme.textTheme.small), const Spacer(), Text('64%', style: theme.textTheme.muted), ], ), ShadProgress(value: 0.64, minHeight: 8, semanticsLabel: 'Mengunggah master.wav', semanticsValue: '64%'), ], ), ); }}Pasang
Section titled “Pasang”npx shadcn@latest add https://design.sosialoka.tech/r/react/progress.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/progress.jsonAksesibilitas
Section titled “Aksesibilitas”- Punya
role="progressbar"denganaria-valuenow,aria-valuemin, danaria-valuemax. - Beri nama lewat label yang terlihat.
- Jangan umumkan setiap persen; beri tahu saat tugas selesai, misalnya lewat toast.
