Navigation
Step indicator
Ein Balken pro Schritt und eine Blase mit dem Namen, die zum Schritt gleitet, auf den du zeigst.
Angepasst von Watermelon UI (MIT) und neu geschrieben mit Tastatur, Beschriftungen und reduzierter Bewegung.
Vorschau
Verwendung
step-indicator-demo.tsx
import { CreditCard, PackageCheck, ShoppingBag, Truck } from 'lucide-react'
import { useState } from 'react'
import { StepIndicator } from '@/components/step-indicator'
const steps = [
{ id: 'bag', label: 'Bag', icon: <ShoppingBag /> },
{ id: 'shipping', label: 'Shipping', icon: <Truck /> },
{ id: 'payment', label: 'Payment', icon: <CreditCard /> },
{ id: 'done', label: 'Confirmation', icon: <PackageCheck /> },
]
export default function StepIndicatorDemo() {
const [current, setCurrent] = useState(1)
return (
<div className="mx-auto flex w-full max-w-sm flex-col gap-8 pt-12">
<StepIndicator label="Checkout" steps={steps} current={current} onStepChange={setCurrent} />
<div className="flex items-center justify-between text-sm">
<span className="text-muted-foreground">
Step {current + 1} of {steps.length}: <span className="text-foreground">{steps[current].label}</span>
</span>
<div className="flex gap-2">
<button type="button" disabled={current === 0} onClick={() => setCurrent((c) => c - 1)} className="min-h-11 rounded-xl px-3 hover:bg-muted disabled:opacity-40">
Back
</button>
<button
type="button"
disabled={current === steps.length - 1}
onClick={() => setCurrent((c) => c + 1)}
className="min-h-11 rounded-xl bg-foreground px-4 text-background disabled:opacity-40"
>
Next
</button>
</div>
</div>
</div>
)
}Quellcode
step-indicator.tsx
// Based on Watermelon UI's “Step indicator” (MIT, © 2026 Watermelon Platform Contributors,
// github.com/WatermelonCorp/watermelon-platform). Rewritten with a current step, one moving label and no hidden measuring row.
import { AnimatePresence, MotionConfig, motion } from 'motion/react'
import { useRef, useState, type ReactNode } from 'react'
import { cn } from '@/lib/utils'
export type StepIndicatorStep = { id: string; label: string; icon?: ReactNode }
export type StepIndicatorProps = {
steps: StepIndicatorStep[]
/** Index of the step the person is on. Earlier steps are filled. */
current: number
onStepChange?: (index: number) => void
label?: string
className?: string
}
/** A row of bars for a multi-step flow. Hover or focus a bar and its name slides over to it. */
export function StepIndicator({ steps, current, onStepChange, label = 'Progress', className }: StepIndicatorProps) {
const [hover, setHover] = useState<number | null>(null)
const [x, setX] = useState(0)
const row = useRef<HTMLDivElement>(null)
const bars = useRef<(HTMLButtonElement | null)[]>([])
const [slide, setSlide] = useState(false)
const show = (i: number) => {
const b = bars.current[i]
const r = row.current
if (!b || !r) return
setSlide(hover !== null)
setX(b.offsetLeft + b.offsetWidth / 2)
setHover(i)
}
const step = hover === null ? null : steps[hover]
return (
<MotionConfig reducedMotion="user">
<nav aria-label={label} className={cn('w-full', className)}>
<div ref={row} className="relative flex h-3 items-center gap-2.5" onPointerLeave={() => setHover(null)}>
<AnimatePresence>
{step && (
<motion.div
key="tip"
aria-hidden
initial={{ opacity: 0, x, y: 4 }}
animate={{ opacity: 1, x, y: 0 }}
exit={{ opacity: 0, y: 4 }}
transition={{ type: 'spring', bounce: 0, duration: slide ? 0.4 : 0 }}
className="pointer-events-none absolute bottom-6 left-0"
>
<div className="-translate-x-1/2 overflow-hidden rounded-full bg-foreground px-4 py-2 text-background">
<AnimatePresence mode="popLayout" initial={false}>
<motion.span
key={step.id}
initial={{ opacity: 0, filter: 'blur(4px)' }}
animate={{ opacity: 1, filter: 'blur(0px)' }}
exit={{ opacity: 0, filter: 'blur(4px)' }}
transition={{ duration: 0.25 }}
className="flex items-center gap-2 text-sm font-medium whitespace-nowrap [&_svg]:size-4"
>
{step.icon}
{step.label}
</motion.span>
</AnimatePresence>
</div>
</motion.div>
)}
</AnimatePresence>
{steps.map((s, i) => (
<button
key={s.id}
ref={(el) => {
bars.current[i] = el
}}
type="button"
aria-label={`${i + 1}. ${s.label}`}
aria-current={i === current ? 'step' : undefined}
onPointerEnter={() => show(i)}
onFocus={() => show(i)}
onBlur={() => setHover(null)}
onClick={() => onStepChange?.(i)}
className="group relative h-3 flex-1 outline-none before:absolute before:-inset-y-3 before:inset-x-0"
>
<span
className={cn(
'absolute inset-0 rounded-full transition-colors duration-300',
'group-focus-visible:ring-2 group-focus-visible:ring-ring group-focus-visible:ring-offset-2 group-focus-visible:ring-offset-background',
i <= current ? 'bg-foreground' : 'bg-muted',
hover === i && i > current && 'bg-muted-foreground/40',
)}
/>
</button>
))}
</div>
</nav>
</MotionConfig>
)
}Installieren
npx shadcn@latest add https://mikkelmanniche.dk/lab/r/step-indicator.jsonMit eingetragener Registry (components.json)
npx shadcn@latest add @manniche/step-indicator