Forms Support
You can use the ComboBox 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
—the value has to match the data
type.
Template-Driven Forms
The template-driven forms enable you to bind the ComboBox to the model by using the ngModel
directive.
The following example demonstrates how to accomplish a two-way data binding when the model field is a complex value.
The following example demonstrates how to accomplish a two-way data binding when 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.
The following example demonstrates how to use the ComboBox in a reactive form with a primitive value binding.
The following example demonstrates how to use the ComboBox in a reactive form with a complex value binding.
Managing the ComboBox Disabled State in Reactive Forms
To disable the ComboBox 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
setDisabledState
with the model-DOM. This impacts components using thedisabled
attribute. As a result, thedisabled
property 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 ComboBox within a FormField with hint and error messages.