Data Binding
The SplitButton enables you to bind data of the primitive (strings and numbers) or of the complex (data inside objects) type.
Arrays of Primitive Data
The following example demonstrates how to bind the SplitButton to an array of primitive data.
Arrays of Complex Data
When the SplitButton is bound to complex data (objects), the component extracts the text value from the data items and, in this way, sets the text of the items in the popup. If the text field in the data objects is named text
, the SplitButton gets its value automatically. However, if the name of the property in the data source is different—for example, actionText
—you have to set it as a textField
.
To set the enabled or disabled state of the SplitButton items, use the disabled
property. To set the icon of each item, use the icon
, iconClass
, and imageUrl
properties of the data items. To attach a function that will be called when the user clicks an item, set the click
property of a data item.