Skip to content
On this page

Divider

A divider is a thin line that groups content in lists and containers.

Dividers can reinforce tapability, such as when used to separate list items or define tappable regions in an accordion.

Usage

Use full width dividers to separate larger sections of unrelated content.

A full width divider separating two paragraphs of "Lorem ipsum"

html
<section>
  <p>Lorem ipsum...</p>
  <md-divider></md-divider>
  <p>Lorem ipsum...</p>
</section>

Inset dividers

Use inset dividers to separate related content within a section.

A list of design system names separated by an inset divider

html
<section>
  <p>Material 2</p>
  <md-divider inset></md-divider>
  <p>Material 3</p>
</section>

Inset dividers are equally indented from both sides of the screen by default. Use inset-start or inset-end to change this.

A list of design system names separated by a leading inset divider

html
<section>
  <p>Material 2</p>
  <md-divider inset-start></md-divider>
  <p>Material 3</p>
</section>

Accessibility

Dividers are decorative by default and not announced by assistive technology.

Add a role="separator" attribute to non-decorative dividers that should be announced.

html
<ul>
  <li>Item one</li>
  <md-divider inset></md-divider>
  <li>Item two</li>
  <md-divider role="separator"></md-divider>
  <li>Item three</li>
  <md-divider inset></md-divider>
  <li>Item four</li>
</ul>

Theming

Divider supports theming and can be customized with CSS custom property tokens.

Tokens

TokenDefault value
--md-divider-color--md-sys-color-outline-variant
--md-divider-thickness1px

Example

A customized divider with a different color and thickness

html
<style>
:root {
  --md-sys-color-outline-variant: #BEC9C8;
  --md-divider-thickness: 2px;
}
</style>

<section>
  <p>Lorem ipsum...</p>
  <md-divider></md-divider>
  <p>Lorem ipsum...</p>
</section>

API

MdDivider <md-divider>

Properties

PropertyAttributeTypeDefaultDescription
insetinsetbooleanfalseIndents the divider with equal padding on both sides.
insetStartinset-startbooleanfalseIndents the divider with padding on the leading side.
insetEndinset-endbooleanfalseIndents the divider with padding on the trailing side.
Divider has loaded