Forms and selection · stable · MIT

Toggle

A pressed-state button for one independent option.

Install editable source

Add Toggle

Base UI / canonicalnpx shadcn@latest add https://gummyui.dev/r/gummy-toggle.json

Radix UI counterpartnpx shadcn@latest add https://gummyui.dev/r/gummy-radix-toggle.json

Canonical dependency: @base-ui/react. Radix counterpart: @radix-ui/react-toggle. Registry dependencies are resolved automatically.

Behavior contract

Base UI toggle renders a button with aria-pressed.

Enter or Space toggles.

Light and dark themes, logical RTL layout, reduced motion, responsive content, and forwarded public refs.

Source-derived reference

These public React parts are read directly from the canonical source during the documentation build.

Composes Toggle.Props & { variant?: "quiet" | "fruit"; }

Troubleshooting

If the material is missing, confirm the registry-installed shared and component CSS files are imported once.
If interaction differs, preserve this contract: Enter or Space toggles.
If assistive output differs, preserve this semantic foundation: Base UI toggle renders a button with aria-pressed.
If dark, RTL, or reduced-motion behavior is missing, verify the nearest theme, direction, and media-query boundaries rather than adding page-local overrides.

Live product source

The Component Lab exercises real source across default, focus, disabled, responsive, dark, reduced-motion, and RTL contexts.

Interactive inspection

Resize the canvas, switch its theme, or reverse its reading direction without changing the rest of the page.

Radix UI counterpart

This is the real separately installable Radix source using the same Gummy material and behavior contract.

Editable source

Loading editable source…

Loading editable source…