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

Load the real component preview when you are ready to interact with its responsive, theme, and direction controls.

Radix UI counterpart

Load the separately installable Radix counterpart when you are ready to interact with its real behavior.

Editable source

The registry payload stays off the initial page request.

The registry payload stays off the initial page request.