Forms Support
You can use the MultiSelect in template-driven or reactive forms, and within a FormField.
The component accepts values of the complex (objects) or the primitive (strings, numbers, or other) type. To specify the value type, set the valuePrimitive property. By default, it is set to false.
Template-Driven Forms
The template-driven forms enable you to bind the MultiSelect to the model by using the ngModel directive.
To preselect items, set the initial value of the bound model field. When valuePrimitive is true, each value must match the type of the valueField of its data item, and the data collection must include that item.
The following example demonstrates how to accomplish a two-way data binding by using the ngModel directive. The model field is a complex value.
The following example demonstrates how to accomplish a two-way data binding by using the ngModel directive. The model field is a primitive value.
Reactive Forms
The FormGroup provides a way to render reactive forms. For more details, refer to the Angular Documentation.
To preselect items, initialize the form control with an array of values or call its setValue method. With remote data, load the records that match the selected values before you apply them. For the data-request pattern, see Server-Side Filtering.
When valuePrimitive is true, each value must match the type of the valueField of its data item. For more on value types, see Value Binding.
The following example demonstrates how to use the MultiSelect in a reactive form with a primitive value binding.
The following example demonstrates how to use the MultiSelect in a reactive form with a complex value binding.
Managing the MultiSelect Disabled State in Reactive Forms
To disable the MultiSelect component when working with reactive forms and Angular 15 or later, use the FormControl's disabled property/option or disable() method.
Angular 15 introduces a breaking change affecting the synchronization of
setDisabledStatewith the model-DOM. This impacts components using thedisabledattribute. As a result, thedisabledproperty of the Kendo UI for Angular components used prior to Angular 15 is no longer working in reactive forms.
FormField Association
The Kendo UI for Angular FormField component enables you to group form-related elements, such as inputs, labels, hint and error messages, and configure their behavior.
The following example demonstrates how to use the MultiSelect within a FormField with hint and error messages.