Lewati ke konten

Stepper

Unduh .md

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

  • 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.
React
  1. selesaiPilih lagu
  2. 2Data rilis
  3. 3Dokumen
  4. 4Kirim

Langkah 2 dari 4

Vue
  1. selesaiPilih lagu
  2. 2Data rilis
  3. 3Dokumen
  4. 4Kirim
Step 2 of 0

Langkah 2 dari 4

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

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.

Hanya ada satu gaya, mendatar.

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.
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>
)
}
Terminal window
npx shadcn@latest add https://design.sosialoka.tech/r/react/stepper.json
  • 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.