New to Kendo UI for Angular? Start a free 30-day trial

ToolBarSplitButtonComponent

Represents the Kendo UI ToolBar SplitButton for Angular.

Selector

kendo-toolbar-splitbutton

Export Name

Accessible in templates as #kendoToolBarSplitButtonInstance="kendoToolBarSplitButton"

Inputs

NameTypeDefaultDescription

arrowButtonClass

any

The CSS classes that will be rendered on the button which opens the popup. Supports the type of values that are supported by ngClass.

arrowButtonIcon

string

Specifies the name of the font icon that will be rendered for the button which opens the popup.

arrowButtonSvgIcon

SVGIcon

Specifies the SVGIcon that will be rendered for the button which opens the popup.

buttonClass

string

The CSS classes that will be rendered on the main button. Supports the type of values that are supported by ngClass.

data

any[]

Sets the data of the SplitButton (see example).

The data has to be provided in an array-like list.

disabled

boolean

When set to true, disables a SplitButton item.

fillMode

ButtonFillMode

The fillMode property specifies the background and border styles of the Button.

The available values are:

  • solid (default)
  • flat
  • outline
  • link
  • null

icon

string

Defines the icon that will be rendered next to the button text (see example).

iconClass

string

Defines an icon with a custom CSS class that will be rendered next to the button text.

imageUrl

string

Defines the location of an image that will be displayed next to the button text.

popupSettings

PopupSettings

Configures the popup of the SplitButton.

The available options are:

  • animate:Boolean—Controls the popup animation. By default, the open and close animations are enabled.
  • popupClass:String—Specifies a list of CSS classes that are used to style the popup.

showIcon

DisplayMode

Specifies where button icon should be displayed

showText

DisplayMode

Specifies where button text should be displayed

svgIcon

SVGIcon

Defines an SVGIcon to be rendered within the main button. The input can take either an existing Kendo SVG icon or a custom one.

text

string

Sets the text of the SplitButton (see example.

textField

string

Configures the text field of the button-list popup.

themeColor

ButtonThemeColor

The Button allows you to specify predefined theme colors. The theme color will be applied as a background and border color while also amending the text color accordingly.

The possible values are:

  • base —Applies coloring based on the base theme color. (default)
  • primary —Applies coloring based on the primary theme color.
  • secondary—Applies coloring based on the secondary theme color.
  • tertiary— Applies coloring based on the tertiary theme color.
  • info—Applies coloring based on the info theme color.
  • success— Applies coloring based on the success theme color.
  • warning— Applies coloring based on the warning theme color.
  • error— Applies coloring based on the error theme color.
  • dark— Applies coloring based on the dark theme color.
  • light— Applies coloring based on the light theme color.
  • inverse— Applies coloring based on the inverse theme color.
  • null —Removes the default CSS class (no class would be rendered).

Events

NameTypeDescription

buttonClick

EventEmitter<any>

Fires each time the user clicks the main button.

close

EventEmitter<PreventableEvent>

Fires each time the popup is about to close. This event is preventable. If you cancel the event, the popup will remain open.

itemClick

EventEmitter<any>

Fires each time the user clicks the drop-down list. The event data contains the data item that is bound to the clicked list item.

open

EventEmitter<PreventableEvent>

Fires each time the popup is about to open. This event is preventable. If you cancel the event, the popup will remain closed.

In this article

Not finding the help you need?