Skip to content
Material Design 3
Main Navigation
v3
v2
v1

English

简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

English

简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

Appearance

Sidebar Navigation

Foundations

Accessibility

Overview: Principles

Overview: Assistive technology

Designing: Overview

Designing: Color contrast

Designing: Structure

Designing: Flow

Designing: Elements

Writing and text: Best practices

Writing and text: Text truncation

Writing and text: Text resizing

Building for all: User needs

Building for all: Co-design

Content design

Overview

Alt text

Global writing: Overview

Global writing: Word choice

Notifications

Style guide: UX writing best practices

Style guide: Word choice

Style guide: Grammar and punctuation

Customizing Material

Devices

Watches: Overview

Watches: Foundations

Watches: Styles

Watches: Layout

XR

Design: Overview

Design: Interaction

Design: Layout

Design: Accessibility

Components: Overview

Components: App bars

Components: Dialogs

Components: Nav bar

Components: Nav rail

Components: Toolbars

Design tokens: Overview

Design tokens: How to use tokens

Interaction

Gestures

Inputs

Selection

States: Overview

States: State layers

States: Applying states

Layout

Overview: Overview

Overview: Parts of layout

Overview: Adaptive design

Scaffold: Overview

Scaffold: Bars

Scaffold: Rails

Scaffold: Panes

Grids & spacing: Overview

Grids & spacing: Grids

Grids & spacing: Spacing

Grids & spacing: Density

Breakpoints: Overview

Breakpoints: Compact

Breakpoints: Medium

Breakpoints: Expanded

Breakpoints: Large & extra-large

Bidirectionality & RTL

Canonical examples: Overview

Canonical examples: Feed

Canonical examples: List-detail

Canonical examples: Supporting pane

Usability: Overview

Usability: Applying M3 Expressive

Material A-Z

Styles

Color

Color system: Overview

Color system: How the system works

Color roles

Color schemes

Choosing a scheme

Static: Baseline

Static: Custom brand

Dynamic: Choosing a source

Dynamic: User-generated source

Dynamic: Content-based source

Advanced: Overview

Advanced: Apply colors

Advanced: Define new colors

Advanced: Adjust existing colors

Color resources

Elevation: Overview

Elevation: Applying elevation

Elevation: Tokens

Icons: Overview

Icons: Designing icons

Icons: Applying icons

Motion

Motion physics system: How it works

Motion physics system: Specs

Easing and duration: Applying easing and duration

Easing and duration: Tokens & specs

Transitions: Transition patterns

Transitions: Applying transitions

Shape: Overview & principles

Shape: Corner radius scale

Shape: Shape morph

Spacing: Overview

Spacing: Applying spacing

Spacing: Tokens

Typography: Overview

Typography: Fonts

Typography: Type scale & tokens

Typography: Applying type

Typography: Editorial treatments

Components

App bars: Overview

App bars: Specs

App bars: Guidelines

App bars: Accessibility

Badges: Overview

Badges: Specs

Badges: Guidelines

Badges: Accessibility

Buttons

All buttons

Button groups: Overview

Button groups: Specs

Button groups: Guidelines

Button groups: Accessibility

Buttons: Overview

Buttons: Specs

Buttons: Guidelines

Buttons: Accessibility

Extended FABs: Overview

Extended FABs: Specs

Extended FABs: Guidelines

Extended FABs: Accessibility

FAB menu: Overview

FAB menu: Specs

FAB menu: Guidelines

FAB menu: Accessibility

FABs: Overview

FABs: Specs

FABs: Guidelines

FABs: Accessibility

Icon buttons: Overview

Icon buttons: Specs

Icon buttons: Guidelines

Icon buttons: Accessibility

Segmented buttons: Overview

Segmented buttons: Specs

Segmented buttons: Guidelines

Segmented buttons: Accessibility

Split button: Overview

Split button: Specs

Split button: Guidelines

Split button: Accessibility

Cards: Overview

Cards: Specs

Cards: Guidelines

Cards: Accessibility

Carousel: Overview

Carousel: Specs

Carousel: Guidelines

Carousel: Accessibility

Checkbox: Overview

Checkbox: Specs

Checkbox: Guidelines

Checkbox: Accessibility

Chips: Overview

Chips: Specs

Chips: Guidelines

Chips: Accessibility

Date & time pickers

Date pickers: Overview

Date pickers: Specs

Date pickers: Guidelines

Date pickers: Accessibility

Time pickers: Overview

Time pickers: Specs

Time pickers: Guidelines

Time pickers: Accessibility

Dialogs: Overview

Dialogs: Specs

Dialogs: Guidelines

Dialogs: Accessibility

Divider: Overview

Divider: Specs

Divider: Guidelines

Divider: Accessibility

Lists: Overview

Lists: Specs

Lists: Guidelines

Lists: Accessibility

Loading & progress

Loading indicator: Overview

Loading indicator: Specs

Loading indicator: Guidelines

Loading indicator: Accessibility

Progress indicators: Overview

Progress indicators: Specs

Progress indicators: Guidelines

Progress indicators: Accessibility

Menus: Overview

Menus: Specs

Menus: Guidelines

Menus: Accessibility

Navigation

Navigation bar: Overview

Navigation bar: Specs

Navigation bar: Guidelines

Navigation bar: Accessibility

Navigation drawer: Overview

Navigation drawer: Specs

Navigation drawer: Guidelines

Navigation drawer: Accessibility

Navigation rail: Overview

Navigation rail: Specs

Navigation rail: Guidelines

Navigation rail: Accessibility

Radio button: Overview

Radio button: Specs

Radio button: Guidelines

Radio button: Accessibility

Search: Overview

Search: Specs

Search: Guidelines

Search: Accessibility

Sheets

Bottom sheets: Overview

Bottom sheets: Specs

Bottom sheets: Guidelines

Bottom sheets: Accessibility

Side sheets: Overview

Side sheets: Specs

Side sheets: Guidelines

Side sheets: Accessibility

Sliders: Overview

Sliders: Specs

Sliders: Guidelines

Sliders: Accessibility

Snackbar: Overview

Snackbar: Specs

Snackbar: Guidelines

Snackbar: Accessibility

Switch: Overview

Switch: Specs

Switch: Guidelines

Switch: Accessibility

Tabs: Overview

Tabs: Specs

Tabs: Guidelines

Tabs: Accessibility

Text fields: Overview

Text fields: Specs

Text fields: Guidelines

Text fields: Accessibility

Toolbars: Overview

Toolbars: Specs

Toolbars: Guidelines

Toolbars: Accessibility

Tooltips: Overview

Tooltips: Specs

Tooltips: Guidelines

Tooltips: Accessibility

On this page

Split buttons: Specs ​

Split buttons open a menu to give people more options related to an action

Variants ​

1 type of split button.

VariantM3M3 Expressive
Split button--Available

Configurations ​

4 colors and 5 sizes of split buttons.
  1. Color configurations: Elevated, filled, tonal, outlined
  2. Size configurations: XS, S, M, L, XL

CategoryConfigurationM3M3 Expressive
SizeXS, S, M, L, XL--Available
ColorElevated, filled, tonal, outlined--Available

Tokens & specs ​

Use the table's menu to select a token set. Split button token sets are organized by size. Learn about design tokens

Split button - Size - Xsmall ​

TokenValue
Split button xsmall container height32dp
Split button xsmall between space2dp
Split button xsmall container shapeCircular
Split button xsmall inner corner size4dp
Split button xsmall outer corner size50%
Split button xsmall leading button leading space12dp
Split button xsmall leading button trailing space10dp
Split button xsmall trailing button icon size22dp
Split button xsmall trailing button leading space13dp
Split button xsmall trailing button trailing space13dp
Split button xsmall inner corner hovered size8dp
Split button xsmall inner corner pressed size8dp
Split button xsmall trailing button inner corner selected size50%

Split button - Size - Small ​

TokenValue
Split button small container height40dp
Split button small between space2dp
Split button small container shapeCircular
Split button small inner corner size4dp
Split button small leading button leading space16dp
Split button small leading button trailing space12dp
Split button small trailing button icon size22dp
Split button small trailing button leading space13dp
Split button small trailing button trailing space13dp
Split button small inner corner hovered size12dp
Split button small inner corner pressed size12dp
Split button small trailing button inner corner selected size50%

Split button - Size - Medium ​

TokenValue
Split button medium container height56dp
Split button medium between space2dp
Split button medium container shapeCircular
Split button medium inner corner size4dp
Split button medium leading button leading space24dp
Split button medium leading button trailing space24dp
Split button medium trailing button icon size26dp
Split button medium trailing button leading space15dp
Split button medium trailing button trailing space15dp
Split button medium inner corner hovered size12dp
Split button medium inner corner pressed size12dp
Split button medium trailing button inner corner selected size50%

Split button - Size - Large ​

TokenValue
Split button large container height96dp
Split button large between space2dp
Split button large container shapeCircular
Split button large inner corner size8dp
Split button large leading button leading space48dp
Split button large leading button trailing space48dp
Split button large trailing button icon size38dp
Split button large trailing button leading space29dp
Split button large trailing button trailing space29dp
Split button large inner corner hovered size20dp
Split button large inner corner pressed size20dp
Split button large trailing button inner corner selected size50%

Split button - Size - Xlarge ​

TokenValue
Split button xlarge container height136dp
Split button xlarge between space2dp
Split button xlarge container shapeCircular
Split button xlarge inner corner size12dp
Split button xlarge leading button leading space64dp
Split button xlarge leading button trailing space64dp
Split button xlarge trailing button icon size50dp
Split button xlarge trailing button leading space43dp
Split button xlarge trailing button trailing space43dp
Split button xlarge inner corner hovered size20dp
Split button xlarge inner corner pressed size20dp
Split button xlarge trailing button inner corner selected size50%

Anatomy ​

4 elements of a split button.
  1. Leading button
  2. Icon
  3. Label text
  4. Trailing button

The leading button in split buttons can have an icon, label text, or both. The trailing button should always have a menu icon.

3 customizations of the leading button in the split button.
  1. Label + icon
  2. Label
  3. Icon

Color ​

Color values are implemented through design tokensDesign tokens are the building blocks of all UI elements. The same tokens are used in designs, tools, and code.More on tokens. For designers, this means working with color values that correspond with tokens; in implementation, a color value will be a token that references a value.

Split buttons use the same color schemes as standard buttonsButtons let people take action and make choices with one tap.More on buttons. However, unlike toggle buttons, the split button color doesn’t change when selected—only a state layer is applied.

Split buttons use the same colors and state layers as buttons, shown in the following token module. Go to buttons for more details.

4 color roles of the split button when unselected and selected in light and dark theme.

A: Unselected, B: Selected trailing icon

  1. Elevated
  2. Filled
  3. Tonal
  4. Outlined

Button - Color - Elevated ​

Theme
Contrast

Button - Color - Filled ​

Theme
Contrast

Button - Color - Tonal ​

Theme
Contrast

Button - Color - Outlined ​

Theme
Contrast

States ​

StatesStates show the interaction status of a component or UI element.More on states are visual representations used to communicate the status of a component or an interactive element.

Split button states use the same colors and state layers as buttonsButtons let people take action and make choices with one tap.More on buttons and icon buttonsIcon buttons help people take minor actions with one tap.More on icon buttons. Go to those specs for details.

Leading button shape ​

The inner corners change shape for hovered, focused, and pressed states.

5 states of the leading button in the split button.
  1. Enabled
  2. Disabled
  3. Hovered
  4. Focused
  5. Pressed, pressed with focus

Trailing button shape ​

The inner corners change shape for hovered, focused, and pressed states, and the icon becomes centered when selected.

6 states of the trailing menu button in the split button.
  1. Enabled
  2. Disabled
  3. Hovered
  4. Focused
  5. Pressed, pressed with focus
  6. Selected, selected with focus

Measurements ​

Text and icons are optically centered when the buttons are asymmetrical. They’re centered normally when symmetrical.

Padding and size measurements of the split button.

Menu icon offset when unselected:

  1. XS: -1dp from center
  2. S: -1dp from center
  3. M: -2dp from center
  4. L: -3dp from center
  5. XL: -6dp from center

The inner corner radius changes depending on button sizing. The space should always be 2dp.

Inner padding and inner corner measurements of the split button.
  1. Extra small 4dp
  2. Small 4dp
  3. Medium 4dp
  4. Large 8dp
  5. Extra large 12dp
Pager
Previous pageSplit button: Overview
Next pageSplit button: Guidelines

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google

https://m3.material.io/components/split-button/specs

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google