Data and Value Binding
The ComboBox enables you to configure its predefined list of options and selected value.
To set the predefined option list, use the data-items property. To set the selected value, use the value property.
Data Binding
To bind the ComboBox to data, use the data-items property of the component.
The data-items property accepts both:
Arrays of Primitive Values
The following example demonstrates how to bind the ComboBox to an array of primitive values.
Datasets of Objects
If the ComboBox is bound to a dataset of objects, the value of the component will correspond to the selected object. To implement the approach, set the textField property.
By default, the ComboBox compares the items by reference. To specify a field from the data object which will be used for the comparison, utilize the dataItemKey property. The dataItemKey property is useful when the reference to the selected item which is configured in the value or defaultValue property do not match its corresponding item from the data collection. If dataItemKey is not set and the references in data and value do not correspond, the selected item will not be highlighted in the drop-down list.
Value Binding
Binding to Object Value
If you want to render the selected value you can use v-model or to use the value property of the ComboBox. If you set the value through the value property, hook up to the change event and manually update the value of the value property.
In the following example, the value of the ComboBox is a whole object({ text: 'Football', id: 2 }) that holds the selected data item.
Binding to Primitive Values from Object Fields
If the ComboBox is bound to a dataset of objects and the valuePrimitive property is set to true, the value of the component will be extracted from the valueField of the objects.
In the following example, the value of the component is "2" because its valueField prop is set to id. In this scenario, the value of the ComboBox is associated with this data item: { text: 'Football', id: 2 }.
