Forms Support
You can use the DropDownList in template-driven or reactive forms.
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
—just like the defaultItem
, the value has to match the data
type.
Template-Driven Forms
The template-driven forms enable you to bind the DropDownList 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 DropDownList in a reactive form with a primitive value binding.
The following example demonstrates how to use the DropDownList in a reactive form with a complex value binding and required validation.
The required built-in validator does not support object validation. If a
defaultItem
is set, the developer needs to implement the required custom validation, as demonstrated in the example.
Managing the DropDownList Disabled State in Reactive Forms
To disable the DropDownList 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 DropDownList within a FormField with hint and error messages.