ui5-split-button enables users to trigger actions. It is constructed of two separate actions -
default action and arrow action that can be activated by clicking or tapping, or by
pressing certain keyboard keys - Space or Enter for default action,
and Arrow Down or Arrow Up for arrow action.
for the first one (default action) you can define some text or an icon, or both.
the second one (arrow action) contains only slim-arrow-down icon.
You can choose a design from a set of predefined types (the same as for ui5-button) that offer
different styling to correspond to the triggered action. Both text and arrow actions have the same design.
You can set the ui5-split-button as enabled or disabled. Both parts of an enabled
ui5-split-button can be pressed by clicking or tapping it, or by certain keys, which changes
the style to provide visual feedback to the user that it is pressed or hovered over with
the mouse cursor. A disabled ui5-split-button appears inactive and any of the two buttons
cannot be pressed.
Shift or Escape - if Space is pressed, releases the default action button without triggering the click event.
Arrow Down, Arrow Up, Alt+Arrow Down, Alt+Arrow Up, or F4 - triggers the arrow action
There are separate events that are fired on activating of ui5-split-button parts:
Defines the icon to be displayed as graphical element within the component. The SAP-icons font provides numerous options. Example: See all available icons in the Icon Explorer.
Defines the additional accessibility attributes that will be applied to the component. The accessibilityAttributes property accepts an object with the following optional fields: - root: Attributes that will be applied to the main (text) button. - hasPopup: Indicates the presence and type of popup triggered by the button. Accepts string values: "dialog", "grid", "listbox", "menu", or "tree". - roleDescription: Provides a human-readable description for the role of the button. Accepts any string value. - title: Specifies a tooltip or description for screen readers. Accepts any string value. - arrowButton: Attributes applied specifically to the arrow (split) button. - hasPopup: Indicates the presence and type of popup triggered by the arrow button. Accepts string values: "dialog", "grid", "listbox", "menu", or "tree". - expanded: Indicates whether the popup triggered by the arrow button is currently expanded. Accepts boolean values: true or false.
Defines the text of the component. Note: Although this slot accepts HTML Elements, it is strongly recommended that you only use text in order to preserve the intended design.