Split button
controlsGratisMITEn knap, der deler sig i en række valg, med en tilbagepil og fuld tastaturstyring.
Tilpasset fra Watermelon UI (MIT) og skrevet om med tastatur, etiketter og reduceret bevægelse.
npx shadcn@latest add https://mikkelmanniche.dk/lab/r/split-button.jsonPreview
Live demo i det mørke tema.
Kode
Installér
npx shadcn@latest add https://mikkelmanniche.dk/lab/r/split-button.jsonMed registret tilføjet (components.json)
npx shadcn@latest add @manniche/split-buttonBrug
import { useState } from 'react'
import { SplitButton } from '@/components/split-button'
const options = [
{ id: 'pickup', label: 'Pickup' },
{ id: 'delivery', label: 'Delivery' },
{ id: 'locker', label: 'Parcel locker' },
]
export default function SplitButtonDemo() {
const [chosen, setChosen] = useState<string | null>(null)
return (
<div className="flex flex-col items-center gap-3">
<SplitButton label="Choose shipping" options={options} onSelect={setChosen} />
<p className="min-h-5 text-sm text-muted-foreground" aria-live="polite">
{chosen && `Shipping: ${options.find((o) => o.id === chosen)?.label}`}
</p>
</div>
)
}Kilde
// Based on Watermelon UI's “Split button” (MIT, © 2026 Watermelon Platform Contributors,
// github.com/WatermelonCorp/watermelon-platform). Rewritten with keyboard support, focus handling and a choice callback.
import { ChevronLeft } from 'lucide-react'
import { MotionConfig, motion } from 'motion/react'
import { useEffect, useRef, useState } from 'react'
import { cn } from '@/lib/utils'
export type SplitButtonOption = { id: string; label: string }
export type SplitButtonProps = {
/** Text on the main button. */
label: string
/** The choices that open from the button, each with an id and a label. */
options: SplitButtonOption[]
/** Called with the option id when a choice is picked. */
onSelect: (id: string) => void
/** Name of the button that closes the choices. */
backLabel?: string
/** Classes for the button. */
className?: string
}
/** A button that splits into its options. Pick one, or go back with the arrow or Esc. */
export function SplitButton({ label, options, onSelect, backLabel = 'Back', className }: SplitButtonProps) {
const [open, setOpen] = useState(false)
const main = useRef<HTMLButtonElement>(null)
const row = useRef<HTMLDivElement>(null)
const moved = useRef(false)
// Focus follows the buttons, so a keyboard user never lands on one that just faded out.
useEffect(() => {
if (!moved.current) return
if (open) row.current?.querySelector<HTMLButtonElement>('[data-option]')?.focus()
else main.current?.focus()
}, [open])
const toggle = (next: boolean) => {
moved.current = true
setOpen(next)
}
const swap = (shown: boolean) => ({
opacity: shown ? 1 : 0,
filter: shown ? 'blur(0px)' : 'blur(8px)',
})
return (
<MotionConfig reducedMotion="user" transition={{ type: 'spring', bounce: 0.45, duration: 0.8 }}>
<div
className={cn('relative grid min-h-14 place-items-center font-medium', className)}
onKeyDown={(e) => e.key === 'Escape' && open && toggle(false)}
>
<motion.button
ref={main}
type="button"
aria-expanded={open}
inert={open}
onClick={() => toggle(true)}
initial={false}
animate={{ ...swap(!open), scaleX: open ? 1.5 : 1, scaleY: open ? 0.9 : 1 }}
whileTap={{ scale: 1.08 }}
className="col-start-1 row-start-1 min-h-11 rounded-full bg-primary px-7 text-primary-foreground"
>
{label}
</motion.button>
<motion.div
ref={row}
role="group"
aria-label={label}
inert={!open}
initial={false}
animate={{ ...swap(open), scaleX: open ? 1 : 0.3, scaleY: open ? 1 : 0.9 }}
className="col-start-1 row-start-1 flex flex-wrap items-center justify-center gap-2"
>
<motion.button
type="button"
aria-label={backLabel}
onClick={() => toggle(false)}
whileTap={{ scale: 1.1 }}
className="grid size-11 place-items-center rounded-full bg-muted text-foreground"
>
<ChevronLeft className="size-5" aria-hidden />
</motion.button>
{options.map((o) => (
<motion.button
key={o.id}
data-option
type="button"
onClick={() => {
onSelect(o.id)
toggle(false)
}}
whileTap={{ scale: 1.06 }}
className="min-h-11 rounded-full bg-muted px-5 text-foreground transition-colors duration-150 hover:bg-accent hover:text-accent-foreground"
>
{o.label}
</motion.button>
))}
</motion.div>
</div>
</MotionConfig>
)
}Props
SplitButtonProps
| Prop | Type | Standard | Hvad den gør |
|---|---|---|---|
label påkrævet | string | – | Text on the main button. |
options påkrævet | SplitButtonOption[] | – | The choices that open from the button, each with an id and a label. |
onSelect påkrævet | (id: string) => void | – | Called with the option id when a choice is picked. |
backLabel | string | 'Back' | Name of the button that closes the choices. |
className | string | – | Classes for the button. |
A11y
Tastatur
The main button opens the options and moves focus to the first option. Esc, or the back arrow, closes them and returns focus to the main button. Picking an option calls onSelect and closes. The part that is hidden is inert, so Tab never lands on it.
Skærmlæser
The main button sets aria-expanded. The options sit in a group labelled by label, and the back button is named by backLabel with an aria-hidden icon.
Mindre bevægelse
The component is wrapped in MotionConfig with reducedMotion set to user, so Motion follows the system setting for the split.