Class MenuDivider

A horizontal line that separates menu items into distinct groups.

Inheritance
object
CallbackEventHandler
Focusable
VisualElement
BaseVisualElement
Divider
MenuDivider
Implements
Inherited Members
VisualElement.Focus()
VisualElement.Overlaps(Rect)
VisualElement.ToString()
VisualElement.TryGetBinding(BindingId, out Binding)
VisualElement.TryGetDataSourceContext(BindingId, out DataSourceContext)
VisualElement.TryGetLastBindingToUIResult(in BindingId, out BindingResult)
VisualElement.TryGetLastBindingToSourceResult(in BindingId, out BindingResult)
VisualElement.GetFirstOfType<T>()
VisualElement.GetFirstAncestorOfType<T>()
VisualElement.canGrabFocus
VisualElement.focusController
VisualElement.cacheAsBitmap
CallbackEventHandler.RegisterCallback<TEventType>(EventCallback<TEventType>, TrickleDown)
CallbackEventHandler.RegisterCallbackOnce<TEventType>(EventCallback<TEventType>, TrickleDown)
CallbackEventHandler.RegisterCallback<TEventType, TUserArgsType>(EventCallback<TEventType, TUserArgsType>, TUserArgsType, TrickleDown)
CallbackEventHandler.RegisterCallbackOnce<TEventType, TUserArgsType>(EventCallback<TEventType, TUserArgsType>, TUserArgsType, TrickleDown)
CallbackEventHandler.RegisterCallback<TEventType>(EventCallback<TEventType>, CallbackOptions)
CallbackEventHandler.RegisterCallback<TEventType, TUserArgsType>(EventCallback<TEventType, TUserArgsType>, TUserArgsType, CallbackOptions)
CallbackEventHandler.UnregisterCallback<TEventType>(EventCallback<TEventType>, TrickleDown)
CallbackEventHandler.UnregisterCallback<TEventType>(EventCallback<TEventType>, CallbackOptions)
CallbackEventHandler.UnregisterCallback<TEventType, TUserArgsType>(EventCallback<TEventType, TUserArgsType>, TrickleDown)
CallbackEventHandler.UnregisterCallback<TEventType, TUserArgsType>(EventCallback<TEventType, TUserArgsType>, CallbackOptions)
CallbackEventHandler.NotifyPropertyChanged(in BindingId)
Namespace: Unity.AppUI.UI
Assembly: Unity.AppUI.dll
Syntax
[UxmlElement]
public class MenuDivider : Divider, IEventHandler, IResolvedStyle, ITransform, ITransitionAnimations, IExperimentalFeatures, IVisualElementScheduler, IContextOverrideElement, IAdditionalDataHolder
Remarks

MenuDivider is a specialized version of the Divider component designed specifically for use within Menu elements. It creates a visual separation between menu items, helping to organize actions into logical groups.

Menu dividers inherit all properties from the base Divider component, including direction, size, and spacing, but are styled specifically for menu contexts with appropriate margins and appearance.

Use dividers to separate different types of actions or to create visual breaks between related groups of menu items. This improves menu scanability and helps users quickly locate the action they need.

Note: MenuDivider is always horizontal and is non-interactive (picking mode set to ignore).

Examples

Basic Menu with Dividers

Using dividers to separate logical groups of actions.

<ui:Menu>
    <ui:MenuItem label="New" icon="file" />
    <ui:MenuItem label="Open" icon="folder-open" />
    <ui:MenuDivider />
    <ui:MenuItem label="Save" icon="save" />
    <ui:MenuItem label="Save As" />
    <ui:MenuDivider />
    <ui:MenuItem label="Exit" icon="exit" />
</ui:Menu>

Dividers Between Sections

Using dividers to separate major sections in a complex menu.

<ui:Menu>
    <ui:MenuSection title="Edit">
        <ui:MenuItem label="Undo" shortcut="Ctrl+Z" />
        <ui:MenuItem label="Redo" shortcut="Ctrl+Y" />
    </ui:MenuSection>
    <ui:MenuDivider />
    <ui:MenuSection title="Selection">
        <ui:MenuItem label="Select All" shortcut="Ctrl+A" />
        <ui:MenuItem label="Deselect" />
    </ui:MenuSection>
    <ui:MenuDivider />
    <ui:MenuSection title="View">
        <ui:MenuItem label="Zoom In" shortcut="Ctrl++" />
        <ui:MenuItem label="Zoom Out" shortcut="Ctrl+-" />
    </ui:MenuSection>
</ui:Menu>

Creating Dividers Programmatically

Building menus with dividers in code, including custom styling.

var menu = new Menu();

// Add file operations
menu.Add(new MenuItem { label = "New", icon = "file" });
menu.Add(new MenuItem { label = "Open", icon = "folder-open" });


// Add divider
menu.Add(new MenuDivider());


// Add edit operations
menu.Add(new MenuItem { label = "Cut", icon = "scissors" });
menu.Add(new MenuItem { label = "Copy", icon = "copy" });
menu.Add(new MenuItem { label = "Paste", icon = "clipboard" });


// Add another divider with custom styling
var divider = new MenuDivider ;
menu.Add(divider);

Subtle vs Prominent Dividers

Using different divider styles to create varying levels of visual separation.

<ui:Menu>
    <ui:MenuItem label="Common Action 1" />
    <ui:MenuItem label="Common Action 2" />
    <!-- Subtle divider for minor separation -->
    <ui:MenuDivider size="XS" spacing="S" />
    <ui:MenuItem label="Less Common Action 1" />
    <ui:MenuItem label="Less Common Action 2" />
    <!-- Prominent divider for major separation -->
    <ui:MenuDivider size="M" spacing="L" />
    <ui:MenuItem label="Destructive Action" icon="trash" />
</ui:Menu>

Constructors

MenuDivider()

Default constructor.

Declaration
public MenuDivider()

Fields

dividerClassName

The MenuDivider main styling class.

Declaration
public const string dividerClassName = "appui-menu__divider"
Field Value
Type Description
string

Implements

Extension Methods