SplitButtonComponent
23 Sep 20254 minutes to read
Represents the Angular SplitButton Component.
<ejs-splitbutton content='Split Button'></ejs-splitbutton>Properties
animationSettings DropDownMenuAnimationSettingsModel
Specifies the animation settings for opening the sub menu in the DropDownMenu.
The settings control the duration, easing, and effect of the animation applied when the sub menu opens.
Defaults to { effect: ‘None’ }
closeActionEvents string
Specifies the event to close the DropDownButton popup.
Defaults to ””
content string
Defines the content of the SplitButton primary action button 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 SplitButton element. The SplitButton
size and styles can be customized by using this.
Defaults to ””
disabled boolean
Specifies a value that indicates whether the SplitButton 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 SplitButton that is used to include an
icon. SplitButton can also include font icon and sprite image.
Defaults to ””
iconPosition SplitButtonIconPosition
Positions the icon before/top of the text content in the SplitButton. 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”
itemTemplate string|Function
Specifies the template content to be displayed.
Defaults to null
items ItemModel[]
Specifies action items with its properties which will be rendered as SplitButton secondary button popup.
Defaults to []
locale string
Overrides the global culture and localization value for this component. Default global culture is ‘en-US’.
Defaults to ’’
popupWidth string|number
This property defines the width of the dropdown popup for the DropDownButton component.
Defaults to “auto”
target string|Element
Allows to specify the SplitButton 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
focusIn
Sets the focus to SplitButton
its native method
Returns void
getPersistData
Get the properties to be maintained in the persisted state.
Returns string
onPropertyChanged
Called internally if any of the property value changed.
| Parameter | Type | Description |
|---|---|---|
| newProp | SplitButtonModel |
Specifies new properties |
| oldProp | SplitButtonModel |
Specifies old properties |
Returns void
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 SplitButton popup based on current state of the SplitButton.
Returns void
Events
beforeClose EmitType<BeforeOpenCloseMenuEventArgs>
Triggers before closing the SplitButton popup.
beforeItemRender EmitType<MenuEventArgs>
Triggers while rendering each Popup item of SplitButton.
beforeOpen EmitType<BeforeOpenCloseMenuEventArgs>
Triggers before opening the SplitButton popup.
click EmitType<ClickEventArgs>
Triggers when the primary button of SplitButton has been clicked.
close EmitType<OpenCloseMenuEventArgs>
Triggers while closing the SplitButton popup.
created EmitType<Event>
Triggers once the component rendering is completed.
open EmitType<OpenCloseMenuEventArgs>
Triggers while opening the SplitButton popup.
select EmitType<MenuEventArgs>
Triggers while selecting action item of SplitButton popup.