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

Scaffold: Panes ​

A fundamental UI design structure that provides a standard platform for assembling key components

Panes ​

All layouts are made up of 1–3 panes. The type of layout and amount of panes you choose should depend on the breakpointBreakpoints are opinionated window sizes where a layout changes to match available space, device conventions, and ergonomics (previously window size classes).More on breakpoints (previously window size classes) and the type of product being built.

A two-pane layout on desktop.
Layouts often include multiple panes that work together

All layouts are made up of 1–3 visible panes. The type of layout and amount of panes you choose should depend on the breakpointBreakpoints are opinionated window sizes where a layout changes to match available space, device conventions, and ergonomics (previously window size classes).More on breakpoints and the type of product you're building.

BreakpointRecommended pane totalOther pane totals
Compact1--
Medium12
Expanded21
Large21
Extra-large21, 3

Panes can be:

  • Fixed: Width doesn’t change based on available space
  • Flexible: Width changes based on available space, and can grow and shrink

All layouts need at least one flexible pane.

A device with 2 panes: 1 fixed and 1 flexible.
  1. Fixed pane
  2. Flexible pane

Panes can be permanent or temporary. Temporary panes can appear and be dismissed when necessary, affecting the layout and size of other panes.

2 permanent panes.
Panes can be displayed permanently side by side
Temporary panes can be dismissed

Single-pane layouts

Single-pane layouts use one flexible pane that extends to fit the available space in a layout’s width. They can be used at any breakpointBreakpoints are opinionated window sizes where a layout changes to match available space, device conventions, and ergonomics (previously window size classes).More on breakpoints, but are recommended for compactWindow widths smaller than 600dp, such as a phone in portrait orientation.More on compact breakpoints and mediumWindow widths from 600dp to 839dp, such as a tablet or foldable in portrait orientation.More on medium breakpoints.

A mobile screen with 1 flexible pane.
A single flexible pane adapts to fit any breakpoint

Two-pane layouts

Split-pane layout

A split-pane layout keeps the spacer visually centered. It’s best for foldable devices and dynamic layouts.

When a navigation railNavigation rails let people switch between UI views on mid-sized devices.More on navigation rails or drawerNavigation drawers let people switch between UI views on larger devices. In the expressive update, use an expanded navigation rail.More on navigation drawers is present, it only reduces the size of one pane. The other pane remains at 50% of the window width.

2 flexible panes in a split-pane layout.
The navigation and first pane should be 50% of the window width to keep the spacer centered

With a navigation barNavigation bars let people switch between UI views on smaller devices.More on navigation bars, or no navigation, both panes span 50% of the window width by default.

2 flexible panes at 50% width, with a navigation bar below them spanning the whole window.
With no navigation rail visible, split-pane layouts set each pane to 50% width by default

Fixed-and-flexible layout

This layout is common for expandedWindow widths 840dp to 1199dp, such as a tablet or foldable in landscape orientation, or desktop.More on expanded breakpoints, largeWindow widths 1200dp to 1599dp, such as desktop.More on large breakpoints, and extra-largeWindow widths 1600dp and larger, such as ultra-wide monitors.More on extra-large breakpoints breakpoints. The fixed-and-flexible panes can appear in whichever order is best for the content.

The fixed pane is often temporary, and used for side sheets or lists with light information density.

Fixed and flexible panes arranged 2 different ways.
  1. Fixed pane
  2. Flexible pane

Three-pane layouts

While less common, the extra-large breakpoint supports using a standard side sheetSide sheets show secondary content anchored to the side of the screen.More on side sheets as a third pane. When the side sheet is present, the expanded navigation rail can remain visible, change into a collapsed navigation rail, or hide completely. Don't use more than three panes.

Note: Fixed panes at this breakpoint are recommended to be 412dp, but side sheets have a default maximum width of 400dp.

Extra large breakpoint with 2 panes and a side sheet acting as a third pane.
  1. A standard side sheet can be used as a third pane

Pane expansion & resizing ​

Panes can be resized, expanded, and collapsed using drag handlesA drag handle adjusts the layout when there are 2 or more panes.More on drag handles.

  • In a split-pane layout, both flexible panes can be freely adjusted, or can snap to certain widths.
  • In a fixed-and-flexible layout, the drag handle can fully collapse and expand the fixed pane. This makes it easy to switch between a single-pane and two-pane layout.

The drag handle should also toggle between layout sizes when selected. This can be a tap, double tap, or long press.

Drag handles can adjust pane size in a list-detail layout

At expanded, large, and extra-large breakpoints, two-pane layouts can be customized to snap to set widths when resized.

The recommended custom widths are:

  • 360dp
  • 412dp
  • Split-pane with spacer centered visually
Panes can snap to custom widths when releasing the drag handle

Persistent pane resizing

The persistent resizing behavior remembers a person's pane width preference. Use this for most resizable layouts.

Pane widths persist even after a person closes the app

The width persists even after a breakpointBreakpoints are opinionated window sizes where a layout changes to match available space, device conventions, and ergonomics (previously window size classes).More on breakpoints change. This means that if a two-pane layout is collapsed to one pane at any size, it’ll remain collapsed even when changing breakpoints.

When a two-pane layout is resized to a single full-width pane, that pane should remain at full-width after switching breakpoints

Temporary pane resizing

The temporary resizing behavior doesn't remember a person’s preferences for pane width. This is primarily used in supporting pane layouts where resizing is uncommon.

Supporting pane layouts can have a pane drag handle to temporarily resize the secondary content

With temporary resizing, panes should always return to the default layout after the pane or product is closed and reopened. This ensures content is a suitable size for most interactions.

The pane width can be temporarily adjusted using the drag handle, but will return to the default layout

Displaying multiple panes ​

Multiple panes can be displayed in three ways: co-planar, floating, or docked. The layout depends on breakpoint, what the pane does, and how people interact with it:

  • Co-planar: Two side-by-side panes. To stay accessible, persistent utilities like tool panels should be co-planar with primary content.
  • Floating: A small pane displays above larger panes. Temporary tasks should remain floating regardless of breakpoint, such as a dialog.
  • Docked: A small pane pinned to the edge of a window. For example, a bottom sheetBottom sheets show secondary content anchored to the bottom of the screen.More on bottom sheets can be docked to show additional actions.
A foldable open screen with 2 co-planar panes displayed side by side.
Co-planar: Panes are displayed side by side
A foldable open screen with a floating pane displayed above other elements.
Floating: A pane is displayed above other panes or content, like a dialog
A foldable open screen with a docked pane to the bottom of the screen displayed above other elements.
Docked: A pane is displayed above other panes and one of its edges extends beyond one side of the screen, like a bottom sheet

How panes adapt ​

Pane layouts can adapt using three strategies: show and hide, levitate, or reflow. When a window is resized or changes orientation, these strategies allow panes to reorganize themselves to preserve context and meaning.

Show and hide

As the breakpointBreakpoints are opinionated window sizes where a layout changes to match available space, device conventions, and ergonomics (previously window size classes).More on breakpoints size or orientation changes, panes can enter and exit the screen or appear next to one another.

A pane can be shown or hidden depending on the available space and orientation

Levitate

Panes can be elevated above other content as floating or docked panes. This strategy helps panes appear relative to their triggers.

Floating panes:

  • Appear in front of the body content
  • Can be customized to be dragged or resized

When adding controls that resize or move a floating pane, provide accessible controls.

A co-planar pane can float when switching breakpoint or orientation

On large screens:

  • Floating panes are the default
  • The scrim behind a floating pane is optional
2 ways of showing floating panes on large screens, with and without a scrim.
  1. Floating pane with a scrim
  2. Floating pane without a scrim

Docked panes are usually at the bottom of the window, like a bottom sheetBottom sheets show secondary content anchored to the bottom of the screen.More on bottom sheets.

At mediumWindow widths from 600dp to 839dp, such as a tablet or foldable in portrait orientation.More on medium breakpoints and expanded breakpointsWindow widths 840dp to 1199dp, such as a tablet or foldable in landscape orientation, or desktop.More on expanded breakpoints, docked panes can adapt into floating panes.

A docked pane can adapt into a floating pane at medium and expanded breakpoints

Alternatively, at medium and expanded breakpoints, a docked pane can adapt into a co-planar pane.

A docked pane can also adapt into a co-planar pane at medium and expanded breakpoints

On large screens, consider changing docked panes into co-planar panes.

A docked pane on mobile and a co-planar pane on a tablet.
  1. A compact screen can have a docked pane
  2. On a large screen, it should change to a co-planar pane

Reflow

Panes can be reorganized on screen as the breakpoint or orientation changes, also known as reflow.

For example, in a vertical orientation, the supporting pane can move underneath the primary pane.

In a vertical orientation, the supporting pane can move below the primary pane

Reflow also applies to breakpoints. When there’s not enough horizontal space for panes, they can stack vertically instead.

Panes can change size, location, and orientation when switching screen sizes

Spatial panels ​

On XR devices, pane layouts can be presented in disconnected spatial panelsIn Android XR, a spatial panel is a container for UI elements, interactive components, and immersive content.More on spatial panels. These panels must have clear containment to make them easy to see on any background.

The content in a spatial panel can use implicit groupingImplicit grouping uses close proximity and open space to group related items.More on implicit grouping when the pane has an explicit container to distinguish it from the environment.

2-pane layout in XR with implicit content grouping and a virtual reality background.
When a pane uses explicit containment, content can use implicit grouping

Accessibility considerations ​

Coplanar panes

  • The focus order should match the visual arrangement of the panes on screen

Floating panes

Modal floating pane:

  • When active, the elements behind it can’t be interacted with
  • Focus moves automatically to the first element in the pane, and when the pane is closed, focus moves back to the element that triggered it, like a dialog
  • If triggered automatically, focus should still move to it, but when it’s closed, focus should go to the next most logical element on screen
  • It disappears when a person interacts with something behind it.

Non-modal floating pane:

  • When open, other parts of a product can be interacted with
  • Focus should be able to move to and from the pane
  • The pane should be available in a logical reading order of the screen

Docked panes

  • Have the same focus requirements as modal and non-modal panes
  • The focus order should match the visual arrangement of the panes on screen
Pager
Previous pageScaffold: Rails
Next pageGrids & spacing: Overview

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google

https://m3.material.io/foundations/layout/scaffold/panes

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google