Skip to main content

List of Menu controls

In this article you'll find the controls you can use in DHTMLX Menu. Their descriptions contain lists of attributes and examples of adding the controls into Menu on the fly.

To operate Menu controls, you can use Menu API and Tree Collection API. Check the related article.

MenuItem is a drop-down list of options.

Menu Item

Adding menuItem​

You can add a MenuItem control into the menu with the help of the add() method of Tree Collection:

menu.data.add({
    type:"menuItem", value:"Menu", items:[
        { type:"menuItem", value:"Option 1" },
        { type:"menuItem", value:"Option 2" },
        { type:"separator"},
        { type:"menuItem", value:"Option Infinite" }
    ]
});

Related sample: Menu. Menu Item

Properties​

See the full list of properties that you can provide in the configuration object of a MenuItem control.

This is a default control for navigation-related components, can contain any other controls as nested items.

Adding NavItem​

A navItem can be easily added to a menu with the help of the add() method of Tree Collection:

menu.data.add({
    type:"navItem", value:"My NavItem"
});

Related sample: Menu. Navigation type. Click or pointer (hover)

Properties​

See the full list of properties that you can provide in the configuration object of a NavItem control.

Adding an icon​

A navItem can have an icon which is set through the corresponding option icon:

{
    type:"navItem", value:"Some",
    icon:"dxi-check"
}

Adding a badge with a number​

You can add a number badge to the navItem to display information like the number of new messages. The badge is set via the count property:

{
    type:"navItem", value:"Some",
    icon:"dxi-check",
    count:10
}

Adding HTML content​

You can add a custom image into the navItem with the help of the html property:

{
    type: "navItem",
    id: "spline",
    html: "<img src='..img/chart-spline.svg'/>"
}

Related sample: Menu. Item HTML content

Showing/hiding a navItem​

To hide/show a navItem, you should pass the ID of the navItem to the hide() / show() Menu methods:

menu.show(id);
menu.hide(id);

Enabling/disabling a navItem​

Any navItem in the menu can be enabled/disabled:

menu.enable(id);
menu.disable(id);

Custom HTML​

This is an item that contains any custom HTML content (for example, an image, icon or other element).

Adding Custom HTML​

Any custom HTML content can be easily added to a menu with the help of the add() method of Tree Collection:

menu.data.add({
    id: "input",
    parent: "edit",
    type: "customHTML",
    html: "<img src='../logo.svg' alt=''/>",
    css: "custom-image"
});

Related sample: Menu. Custom HTML

Properties​

See the full list of properties that you can provide in the configuration object of a Custom HTML control.

Separator​

This is a horizontal (between menu options) or vertical (between menu items) line separating items/groups of items from each other.

Adding Separator​

A new Separator can be created with the help of the add() method of Tree Collection:

menu.data.add({
    type:"separator"
});

Related sample: Menu. Separator

Properties​

See the full list of properties that you can provide in the configuration object of a Separator control.

Spacer​

This item takes space on the toolbar and is used for aligning controls.

DHX Toolbar spacer

Adding Spacer​

A new Spacer can be created with the help of the add() method of Tree Collection:

menu.data.add({
    type:"spacer"
});

Related sample: Menu. Spacer

Properties​

See the full list of properties that you can provide in the configuration object of a Spacer control.