Switch

Usage

Get this component from a saved library export or the connected CLI. The imports below refer to local files installed in your app.

Import styles/components.css, then styles/theme.css once. Wrap your app in ThemeScope from components/ui/utils so typography, focus and overlays share the theme. The installation guide covers runtime dependencies and React/Next.js setup.

import { Switch } from './components/ui/switch';

<Switch label="Email notifications" defaultChecked/>

Design system

This component consumes your semantic colors, spacing, typography and shape tokens. Import the compiled styles and your theme once as described in Export.

Behavior and accessibility

• Provide meaningful labels for interactive controls.
• Connect action callbacks to your application logic.
• Verify keyboard navigation and contrast in your application.

Status: experimental during early access. Sample previews do not send emails, process payments or upload files to a service.

Source and props

This is the exported source, using the same implementation as the editor.

"use client";
import type { ComponentProps, ReactNode } from "react";
import { Switch as Base } from "@base-ui/react/switch";
import { cx } from "./utils";
export function Switch({
  label,
  className,
  ...props
}: Omit<ComponentProps<typeof Base.Root>, "className"> & {
  label: ReactNode;
  className?: string;
}) {
  return (
    <label
      className="cr-check-label"
      data-disabled={props.disabled || undefined}
    >
      <Base.Root {...props} className={cx("cr-switch", className)}>
        <Base.Thumb className="cr-switch-thumb" />
      </Base.Root>
      <span>{label}</span>
    </label>
  );
}