• 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

    Split Button

    A button component that combines a primary action with a dropdown menu for additional actions.

    • npm
    • source
    import { SplitButton, MenuItem } from '@cerberus/react'

    Usage

    The SplitButton component combines a primary action button with a dropdown menu for additional related actions.

    It's ideal for situations where you have a primary action that users perform most often, but also want to provide quick access to related secondary actions.

    Save
    Save As
    Export

    Main Action

    The SplitButton accepts all standard Button props for the primary action button, allowing you to customize its behavior.

    Save
    Save As...
    Export

    Primitives

    The SplitButton component is built using the following primitive components:

    ComponentDescription
    ButtonGroupGroups the primary button and dropdown trigger together
    ButtonThe primary action button
    MenuThe dropdown menu container. Renders within parent context.
    MenuTriggerThe dropdown trigger (IconButton)
    MenuContentThe dropdown menu content container
    MenuItemIndividual menu items within the dropdown

    API

    SplitButton

    The SplitButton component accepts the following props:

    NameDefaultDescription
    childrenMenuItem components to display in the dropdown
    actionTextThe text for the primary action button

    The SplitButton component internally uses:

    • ButtonGroup for layout
    • Button for the primary action
    • Menu for the dropdown functionality
    • IconButton for the dropdown trigger

    MenuItem

    Use MenuItem components as children of SplitButton to define the available actions in the dropdown menu. See the Menu documentation for more details on MenuItem props.

    Note

    The SplitButton component uses an attached ButtonGroup layout to ensure the primary button and dropdown trigger appear as a single unified control.

    On this page

    • Edit this page on Github
    Cerberus Design System | Docs