Data and Value Binding
The DropDownList enables you to configure the predefined list of options by setting its data
property and the selected value by setting its value
property.
Data Binding
To bind the DropDownList to data, use the data-items
property of the component.
The data-items
property accepts both:
Datasets of Objects
When you bind the DropDownList to a dataset of objects, the component's value corresponds to the selected object. To implement the approach, set the textField
property.
By default, the DropDownList compares the items by reference. To specify a field from the data object which will be used for the comparison, use 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.
Arrays of Primitive Values
The following example demonstrates how to bind the DropDownList to an array of primitive values.
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 DropDownList. 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 DropDownList
is a whole object({ text: 'Football', id: 2 }
) that holds the selected data item.
Binding to Primitive Values from Object Fields
If the DropDownList
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 DropDownList is associated with this data item: { text: 'Football', id: 2 }
.