Since Shoelace 2.0 Code stable Pattern stable Figma ready

Divider

sl-divider

Dividers are used to visually separate or group elements.

Examples

Basic Divider 

<sl-divider></sl-divider>

sl-divider

Width

Use the --width custom property to change the width of the divider.

<sl-divider style="--width: 4px;"></sl-divider>

sl-divider style="--width: 4px;"

Color

Use the --color custom property to change the color of the divider.

<sl-divider style="--color: var(--sl-color-teal-300);"></sl-divider>

sl-divider style="--color: tomato;"

Spacing

Use the --spacing custom property to change the amount of space between the divider and it’s neighboring elements.

Above Below 
<div style="text-align: center;">
  Above
  <sl-divider style="--spacing: 2rem;"></sl-divider>
  Below
</div>

div style="text-align: center;"
  | Above
  sl-divider style="--spacing: 2rem;"
  | Below

Vertical

Add the vertical attribute to draw the divider in a vertical orientation. The divider will span the full height of its container. Vertical dividers work especially well inside of a flex container.

First Middle Last 
<div style="display: flex; align-items: center; height: 2rem;">
  First
  <sl-divider vertical></sl-divider>
  Middle
  <sl-divider vertical></sl-divider>
  Last
</div>

div style="display: flex; align-items: center; height: 2rem;"
  | First
  sl-divider vertical=true
  | Middle
  sl-divider vertical=true
  | Last

Use dividers in menus to visually group menu items.

Option 1 Option 2 Option 3 Option 4 Option 5 Option 6 
<sl-menu style="max-width: 200px;">
  <sl-menu-item value="1">Option 1</sl-menu-item>
  <sl-menu-item value="2">Option 2</sl-menu-item>
  <sl-menu-item value="3">Option 3</sl-menu-item>
  <sl-divider></sl-divider>
  <sl-menu-item value="4">Option 4</sl-menu-item>
  <sl-menu-item value="5">Option 5</sl-menu-item>
  <sl-menu-item value="6">Option 6</sl-menu-item>
</sl-menu>

sl-menu style="max-width: 200px;"
  sl-menu-item value="1" Option 1
  sl-menu-item value="2" Option 2
  sl-menu-item value="3" Option 3
  sl-divider
  sl-menu-item value="4" Option 4
  sl-menu-item value="5" Option 5
  sl-menu-item value="6" Option 6

Component Props

Property Default Details
vertical false

boolean

Draws the divider in a vertical orientation.
updateComplete A read-only promise that resolves when the component has finished updating.

Learn more about attributes and properties.

Custom Properties

Name Details
--color

The color of the divider.
--width

The width of the divider.
--spacing

The spacing of the divider.

Learn more about customizing CSS custom properties.