Stepper
Stepper menunjukkan langkah-langkah sebuah alur, mana yang sudah selesai, dan langkah yang sedang dijalani, misalnya saat mengajukan clearance.
Kapan dipakai
Section titled “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.
- selesaiPilih lagu
- 2Data rilis
- 3Dokumen
- 4Kirim
Langkah 2 dari 4
- selesaiPilih lagu
- 2Data rilis
- 3Dokumen
- 4Kirim
Step 2 of 0
Langkah 2 dari 4
Anatomi
Section titled “Anatomi”- 1Langkah selesai
- 2Langkah saat ini
- 3Langkah berikutnya
- 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.
Varian
Section titled “Varian”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> )}<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>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
Section titled “Pasang”npx shadcn@latest add https://design.sosialoka.tech/r/react/stepper.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/stepper.jsonAksesibilitas
Section titled “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.
