Search results

DropDownButtonComponent

Represents the Essential JS 2 VueJS DropDownButton Component

<ejs-dropdownbutton>DropDownButton</ejs-dropdownbutton>

Properties

closeActionEvents

string

Specifies the event to close the DropDownButton popup.

Defaults to ""

content

string

Defines the content of the DropDownButton element that can either be a text or HTML elements.

Defaults to ""

createPopupOnClick

boolean

Specifies the popup element creation on open.

Defaults to false

cssClass

string

Defines class/multiple classes separated by a space in the DropDownButton element. The DropDownButton size and styles can be customized by using this.

Defaults to ""

disabled

boolean

Specifies a value that indicates whether the DropDownButton is disabled or not.

Defaults to false.

enableHtmlSanitizer

boolean

Specifies whether to enable the rendering of untrusted HTML values in the DropDownButton 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

iconCss

string

Defines class/multiple classes separated by a space for the DropDownButton that is used to include an icon. DropDownButton can also include font icon and sprite image.

Defaults to ""

iconPosition

SplitButtonIconPosition

Positions the icon before/top of the text content in the DropDownButton. The possible values are:

  • Left: The icon will be positioned to the left of the text content.
  • Top: The icon will be positioned to the top of the text content.

Defaults to “Left”

items

ItemModel[]

Specifies action items with its properties which will be rendered as DropDownButton popup.

Defaults to []

locale

string

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

Defaults to

target

string | Element

Allows to specify the DropDownButton popup item element.

Defaults to ""

Methods

addItems

Adds a new item to the menu. By default, new item appends to the list as the last item, but you can insert based on the text parameter.

Parameter Type Description
items ItemModel[] Specifies an array of JSON data.
text (optional) string Specifies the text to insert the newly added item in the menu.

Returns void

destroy

Destroys the widget.

Returns void

focusIn

Sets the focus to DropDownButton its native method

Returns void

getPersistData

Get the properties to be maintained in the persisted state.

Returns string

removeItems

Removes the items from the menu.

Parameter Type Description
items string[] Specifies an array of string to remove the items.
isUniqueId (optional) boolean Set true if specified items is a collection of unique id.

Returns void

toggle

To open/close DropDownButton popup based on current state of the DropDownButton.

Returns void

Events

beforeClose

EmitType<BeforeOpenCloseMenuEventArgs>

Triggers before closing the DropDownButton popup.

beforeItemRender

EmitType<MenuEventArgs>

Triggers while rendering each Popup item of DropDownButton.

beforeOpen

EmitType<BeforeOpenCloseMenuEventArgs>

Triggers before opening the DropDownButton popup.

close

EmitType<OpenCloseMenuEventArgs>

Triggers while closing the DropDownButton popup.

created

EmitType<Event>

Triggers once the component rendering is completed.

open

EmitType<OpenCloseMenuEventArgs>

Triggers while opening the DropDownButton popup.

select

EmitType<MenuEventArgs>

Triggers while selecting action item in DropDownButton popup.