Menu Divider

lightning-menu-divider

Creates a divider in the list of items for lightning-button-menu.

For Use In

Lightning Experience, Experience Builder Sites, Salesforce Mobile App, Lightning Out (Beta), Standalone Lightning App, Mobile Offline

The lightning-menu-divider component creates a dividing line after a menu item in a lightning-button-menu component. Use a menu divider to introduce a break between item categories or separate items into groups, for example.

To draw a line after a menu item, nest the component inside lightning-button-menu after the lightning-menu-item where you want the line. Use lightning-menu-divider as a sibling of lightning-menu-item, not as a child component.

This example shows a dropdown menu with two dividers.

1<template>
2    <lightning-button-menu label="Veggies">
3        <lightning-menu-item label="Spinach"> </lightning-menu-item>
4        <lightning-menu-item label="Kale"> </lightning-menu-item>
5        <lightning-menu-divider> </lightning-menu-divider>
6        <lightning-menu-item label="Zucchini"> </lightning-menu-item>
7        <lightning-menu-item label="Yellow Squash"> </lightning-menu-item>
8        <lightning-menu-divider> </lightning-menu-divider>
9        <lightning-menu-item label="Carrot"> </lightning-menu-item>
10        <lightning-menu-item label="Parsnip"> </lightning-menu-item>
11    </lightning-button-menu>
12</template>

By default, space is added above and below the divider. Use variant="compact" with lightning-menu-divider to reduce the space.

1<template>
2    <lightning-button-menu label="Veggies">
3        <lightning-menu-item label="Spinach"> </lightning-menu-item>
4        <lightning-menu-item label="Kale"> </lightning-menu-item>
5        <lightning-menu-divider variant="compact"> </lightning-menu-divider>
6        <lightning-menu-item label="Zucchini"> </lightning-menu-item>
7        <lightning-menu-item label="Yellow Squash"> </lightning-menu-item>
8        <lightning-menu-divider variant="compact"> </lightning-menu-divider>
9        <lightning-menu-item label="Carrot"> </lightning-menu-item>
10        <lightning-menu-item label="Parsnip"> </lightning-menu-item>
11    </lightning-button-menu>
12</template>

For further customization of button menus, use lightning-menu-subheader to create subheaders in the list of items. You can place dividers under subheaders or menu items.

1<template>
2    <lightning-button-menu label="Veggies">
3        <lightning-menu-subheader label="Leafy Greens">
4        </lightning-menu-subheader>
5        <lightning-menu-item label="Spinach"> </lightning-menu-item>
6        <lightning-menu-item label="Kale"> </lightning-menu-item>
7        <lightning-menu-divider variant="compact"> </lightning-menu-divider>
8        <lightning-menu-subheader label="Summer Squash">
9        </lightning-menu-subheader>
10        <lightning-menu-item label="Zucchini"> </lightning-menu-item>
11        <lightning-menu-item label="Yellow Squash"> </lightning-menu-item>
12        <lightning-menu-divider variant="compact"> </lightning-menu-divider>
13        <lightning-menu-subheader label="Root Vegetables">
14        </lightning-menu-subheader>
15        <lightning-menu-item label="Carrot"> </lightning-menu-item>
16        <lightning-menu-item label="Parsnip"> </lightning-menu-item>
17    </lightning-button-menu>
18</template>

Attributes 

NameDescriptionTypeDefaultRequired
variantThe variant changes the spacing above and below the divider. Accepted variants include standard and compact. The compact variant decreases the space. This value defaults to standard.stringstandard