# Progress

> Menunjukkan sejauh mana tugas yang panjangnya diketahui sudah berjalan.

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

## Kapan dipakai

- Pakai untuk unggahan, impor, dan tugas lain yang melaporkan persentase.
- Pakai [Spinner](https://design.sosialoka.tech/id/components/spinner/) kalau panjangnya tidak diketahui.
- Selalu tampilkan label di atas bar, dan persentasenya bila membantu.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/progress/_

## Anatomi

1. Label
2. Nilai
3. Track
4. Indikator

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

## Varian

Hanya ada satu gaya.

## Props

| 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. |

## Kode

**React**
```tsx
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>
  )
}
```

**Vue**
```vue
<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>
```

**Flutter**
```dart
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

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/progress.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/progress.json
```

## Aksesibilitas

- 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.
