• Docs
  • Blog
    • 0.24.0

    • Switch to dark mode
    Get Started
    Components
    Styling
    Theming

    Concepts

    OverviewCompositionTesting

    Layout

    Aspect RatioBleedBoxCenterContainerDividerFlexFloatGridLink OverlayScrollableStackWrap

    Components

    AccordionAdmonitionAvatarButtonCarouselCheckboxClipboardCollapsibleComboboxConfirm ModalCTAModalDate PickerDialogFieldFieldsetFile UploaderIcon ButtonInputLoading StatesMenuNotificationsNumber InputPin InputProgressPrompt ModalRadioRatingSelectSplit ButtonSwitchTableTabsTagTextTextareaToggleTooltip

    Utilities

    Feature FlagsForLocal StoragePortalShowsplitPropsTheme

    Switch

    The Switch component is a toggle input that allows users to switch between two states.

    • npm
    • source
    • recipe
    • Ark
    import { Switch, SwitchParts } from '@cerberus/react'

    Usage

    With Field

    To use the Switch within a form, wrap it with the Field component.

    Sizes

    Primitives

    You can utilize the primitive components or the css prop to customize the checkbox.

    ComponentDescription
    SwitchRootThe context provider for the switch parts
    SwitchLabelThe label of the switch
    SwitchControlThe visual input of the switch
    SwitchThumbThe thumb of the switch state
    SwitchHiddenInputThe native input for the switch

    API

    Props

    The Switch component is an abstraction of the primitives and accepts the following props:

    NameDefaultDescription
    sizesmThis size of the Switch.

    The Switch component also accepts all the props of the SwitchRoot primitive props

    Parts

    The SwitchParts API is an Object containing the full family of components.

    Note

    It is best to only use the SwitchParts if you are building a custom solution. Importing Object based components will ship every property it includes into your bundle, regardless if you use it or not.

    NameDescription
    RootThe SwitchRoot component which is the Provider for the family.
    LabelThe SwitchLabel component which displays the label.
    ControlThe SwitchControl component which is the visual field.
    ThumbThe SwitchThumb component which displays the thumb of the switch.
    HiddenInputThe SwitchHiddenInput component which displays the native input.

    On this page

    • Edit this page on Github
    Cerberus Design System | Docs