# Stepper

> Menunjukkan langkah-langkah alur dan langkah yang sedang dijalani.

Stepper menunjukkan langkah-langkah sebuah alur, mana yang sudah selesai, dan langkah yang sedang dijalani, misalnya saat mengajukan clearance.

## Kapan dipakai

- Pakai untuk alur 3 sampai 6 langkah yang dijalani berurutan.
- Beri nama setiap langkah dengan kata benda singkat: "Data rilis", "Dokumen".
- Simpan draf di setiap langkah, supaya orang bisa berhenti dan kembali lagi: "Simpan dulu, lanjutkan kapan saja."
- Kalau formnya pendek, pakai satu halaman dengan beberapa bagian saja.

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

## Anatomi

1. Langkah selesai
2. Langkah saat ini
3. Langkah berikutnya
4. Penghubung

Daftar langkah berurut. Setiap langkah berupa lingkaran 32px dengan namanya di bawah, disambung ke langkah berikutnya dengan garis 1px.

| Status | Lingkaran | Garis ke langkah berikutnya |
| --- | --- | --- |
| Selesai | `primary-soft` dengan centang, warna `primary-text` | `primary` |
| Saat ini | `primary` dengan nomor, warna `primary-foreground` | `border` |
| Berikutnya | `muted` dengan nomor, warna `muted-foreground` | `border` |

Di bawah `sm`, hanya nama langkah saat ini yang tampil, dengan baris seperti "Langkah 2 dari 4" di bawah stepper; pembaca layar tetap membacakan semua nama.

## Varian

Hanya ada satu gaya, mendatar.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `value` | `v-model` | dibangun dari `Row` (`shadcn_ui` belum punya stepper) | angka | tidak ada (React), `1` (Vue) | Langkah saat ini, mulai dari 1. |
| `completedText` | `completed-text` | `Semantics label` | teks | `completed` | Dibacakan setelah setiap langkah yang selesai, misalnya "selesai". |
| `StepperItem step` | `StepperItem :step` | indeksnya | angka | tidak ada | Nomor langkah. |
| `StepperTitle`, `StepperDescription` | sama | `Text` | teks | tidak ada | Nama langkah dan baris tambahan opsional. |

## Kode

**React**
```tsx
import { useState } from "react"
import { Button } from "@/components/ui/button"
import { Stepper, StepperIndicator, StepperItem, StepperSeparator, StepperTitle } from "@/components/ui/stepper"

const steps = ["Pilih lagu", "Data rilis", "Dokumen", "Kirim"]

export default function StepperDemo() {
  const [step, setStep] = useState(2)
  return (
    <div className="grid w-full max-w-xl gap-6">
      <Stepper value={step} completedText="selesai" aria-label="Ajukan clearance">
        {steps.map((title, index) => (
          <StepperItem key={title} step={index + 1}>
            <StepperIndicator />
            <StepperTitle>{title}</StepperTitle>
            {index < steps.length - 1 && <StepperSeparator />}
          </StepperItem>
        ))}
      </Stepper>
      <p className="text-center text-sm text-muted-foreground sm:hidden">
        Langkah {step} dari {steps.length}
      </p>
      <div className="flex justify-between">
        <Button variant="outline" disabled={step === 1} onClick={() => setStep((s) => s - 1)}>
          Kembali
        </Button>
        <Button disabled={step === steps.length} onClick={() => setStep((s) => s + 1)}>
          Lanjut
        </Button>
      </div>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { ref } from "vue"
import { Button } from "@/components/ui/button"
import { Stepper, StepperIndicator, StepperItem, StepperSeparator, StepperTitle } from "@/components/ui/stepper"

const steps = ["Pilih lagu", "Data rilis", "Dokumen", "Kirim"]
const step = ref(2)
</script>

<template>
  <div class="grid w-full max-w-xl gap-6">
    <Stepper v-model="step" completed-text="selesai" aria-label="Ajukan clearance">
      <StepperItem v-for="(title, index) in steps" :key="title" :step="index + 1">
        <StepperIndicator />
        <StepperTitle>{{ title }}</StepperTitle>
        <StepperSeparator v-if="index < steps.length - 1" />
      </StepperItem>
    </Stepper>
    <p class="text-center text-sm text-muted-foreground sm:hidden">Langkah {{ step }} dari {{ steps.length }}</p>
    <div class="flex justify-between">
      <Button variant="outline" :disabled="step === 1" @click="step--">Kembali</Button>
      <Button :disabled="step === steps.length" @click="step++">Lanjut</Button>
    </div>
  </div>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

const clearanceSteps = ['Pilih lagu', 'Data rilis', 'Dokumen', 'Kirim'];

// shadcn_ui has no stepper: circles joined by lines, drawn from the theme. On phones only the current
// step's name shows, with "Langkah 2 dari 4" under the steps; every name stays in the semantics.
class StepperDemo extends StatefulWidget {
  const StepperDemo({super.key});

  @override
  State<StepperDemo> createState() => _StepperDemoState();
}

class _StepperDemoState extends State<StepperDemo> {
  int step = 2;

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    final c = context.sosialoka;
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 576),
      child: LayoutBuilder(
        builder: (context, constraints) {
          final compact = constraints.maxWidth < 640;
          return Column(
            mainAxisSize: MainAxisSize.min,
            spacing: 16,
            children: [
              Row(
                crossAxisAlignment: CrossAxisAlignment.start,
                children: [
                  for (var i = 0; i < clearanceSteps.length; i++)
                    Expanded(
                      child: Semantics(
                        label: '${clearanceSteps[i]}${i + 1 < step ? ', selesai' : ''}',
                        selected: i + 1 == step,
                        child: ExcludeSemantics(
                          child: Stack(
                            children: [
                              // The line to the next step: primary once this step is done.
                              if (i < clearanceSteps.length - 1)
                                Positioned(
                                  top: 15.5,
                                  left: 0,
                                  right: 0,
                                  child: FractionalTranslation(
                                    translation: const Offset(0.5, 0),
                                    child: Padding(
                                      padding: const EdgeInsets.symmetric(horizontal: 24),
                                      child: Container(height: 1, color: i + 1 < step ? theme.colorScheme.primary : theme.colorScheme.border),
                                    ),
                                  ),
                                ),
                              Column(
                                children: [
                                  Container(
                                    width: 32,
                                    height: 32,
                                    alignment: Alignment.center,
                                    decoration: BoxDecoration(
                                      shape: BoxShape.circle,
                                      color: i + 1 < step
                                          ? c.primarySoft
                                          : i + 1 == step
                                              ? theme.colorScheme.primary
                                              : theme.colorScheme.muted,
                                    ),
                                    child: i + 1 < step
                                        ? Icon(LucideIcons.check, size: 16, color: c.primaryText)
                                        : Text(
                                            '${i + 1}',
                                            style: theme.textTheme.small.copyWith(
                                              color: i + 1 == step ? theme.colorScheme.primaryForeground : theme.colorScheme.mutedForeground,
                                            ),
                                          ),
                                  ),
                                  if (!compact || i + 1 == step) ...[
                                    const SizedBox(height: 8),
                                    Text(
                                      clearanceSteps[i],
                                      textAlign: TextAlign.center,
                                      style: i + 1 == step ? theme.textTheme.small : theme.textTheme.muted,
                                    ),
                                  ],
                                ],
                              ),
                            ],
                          ),
                        ),
                      ),
                    ),
                ],
              ),
              if (compact) Text('Langkah $step dari ${clearanceSteps.length}', style: theme.textTheme.muted),
              Row(
                mainAxisAlignment: MainAxisAlignment.spaceBetween,
                children: [
                  ShadButton.outline(enabled: step > 1, onPressed: () => setState(() => step--), child: const Text('Kembali')),
                  ShadButton(enabled: step < clearanceSteps.length, onPressed: () => setState(() => step++), child: const Text('Lanjut')),
                ],
              ),
            ],
          );
        },
      ),
    );
  }
}
```

## Pasang

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

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

## Aksesibilitas

- Stepper berupa daftar berurut; langkah saat ini punya `aria-current="step"`.
- Langkah yang selesai memberi tahu pembaca layar, misalnya "selesai".
- Beri nama daftarnya lewat `aria-label`, misalnya "Ajukan clearance".
- Lingkaran dan garis hanya hiasan; maknanya ada di nama langkah.
