MenuComponent

23 Sep 20258 minutes to read

Represents the EJ2 Angular Menu Component.

<ejs-menu [items]='menuItems'></ejs-menu>

Properties

animationSettings MenuAnimationSettingsModel

Specifies the animation settings for the sub menu open.

Defaults to { duration: 400, easing: ‘ease’, effect: ‘SlideDown’ }

cssClass string

Defines class/multiple classes separated by a space in the Menu wrapper.

Defaults to ’’

enableHtmlSanitizer boolean

Specifies whether to enable the rendering of untrusted HTML values in the Menu component.
If ‘enableHtmlSanitizer’ set to true, the component will sanitize any suspected untrusted strings and scripts before rendering them.

Defaults to true

enablePersistence boolean

Enable or disable persisting component’s state between page reloads.

Defaults to false

enableRtl boolean

Enable or disable rendering component in right to left direction.

Defaults to false

enableScrolling boolean

Specifies whether to enable / disable the scrollable option in Menu.

Defaults to false

fields FieldSettingsModel

Specifies mapping fields from the dataSource.

Defaults to { itemId: “id”, text: “text”, parentId: “parentId”, iconCss: “iconCss”, url: “url”, separator: “separator”,children: “items” }

hamburgerMode boolean

Specifies whether to enable / disable the hamburger mode in Menu.

Defaults to false

hoverDelay number

If hoverDelay is set by particular number, the menu will open after that period.

Defaults to 0

items MenuItemModel[]| { : }[]

Specifies menu items with its properties which will be rendered as Menu.

Defaults to []

locale string

Overrides the global culture and localization value for this component. Default global culture is ‘en-US’.

Defaults to ’’

orientation Orientation

Specified the orientation of Menu whether it can be horizontal or vertical.

Defaults to ‘Horizontal’

showItemOnClick boolean

Specifies whether to show the sub menu or not on click.
When set to true, the sub menu will open only on mouse click.

Defaults to false

target string

Specifies target element to open/close Menu while click in Hamburger mode.

Defaults to ’’

template any

Specifies the template for Menu item.

Defaults to null

title string

Specifies the title text for hamburger mode in Menu.

Defaults to ‘Menu’

Methods

close

Closes the Menu if it is opened in hamburger mode.

Returns void

destroy

Destroys the widget.

Returns void

enableItems

This method is used to enable or disable the menu items in the Menu based on the items and enable argument.

Parameter	Type	Description
items	`string[]`	Text items that needs to be enabled/disabled.
enable (optional)	`boolean`	Set `true`/`false` to enable/disable the list items.
isUniqueId (optional)	`boolean`	Set `true` if it is a unique id.

Returns void

getItemIndex

This method is used to get the index of the menu item in the Menu based on the argument.

Parameter	Type	Description
item	`MenuItem` \| `string`	item be passed to get the index	id to be passed to get the item index.
isUniqueId (optional)	`boolean`	Set `true` if it is a unique id.

Returns number[]

hideItems

This method is used to hide the menu items in the Menu based on the items text.

Parameter	Type	Description
items	`string[]`	Text items that needs to be hidden.
isUniqueId (optional)	`boolean`	Set `true` if it is a unique id.

Returns void

insertAfter

It is used to insert the menu items after the specified menu item text.

Parameter	Type	Description
items	`MenuItemModel[]`	Items that needs to be inserted.
text	`string`	Text item after that the element to be inserted.
isUniqueId (optional)	`boolean`	Set `true` if it is a unique id.

Returns void

insertBefore

It is used to insert the menu items before the specified menu item text.

Parameter	Type	Description
items	`MenuItemModel[]`	Items that needs to be inserted.
text	`string`	Text item before that the element to be inserted.
isUniqueId (optional)	`boolean`	Set `true` if it is a unique id.

Returns void

open

This method is used to open the Menu in hamburger mode.

Returns void

removeItems

It is used to remove the menu items from the Menu based on the items text.

Parameter	Type	Description
items	`string[]`	Text items that needs to be removed.
isUniqueId (optional)	`boolean`	Set `true` if it is a unique id.

Returns void

setItem

This method is used to set the menu item in the Menu based on the argument.

Parameter	Type	Description
item	`MenuItem`	item need to be updated.
id (optional)	`string`	id / text to be passed to update the item.
isUniqueId (optional)	`boolean`	Set `true` if it is a unique id.