Forms Support
You can use the MultiSelectTree 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 MultiSelectTree 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 MultiSelectTree in a reactive form with a primitive value binding.
The following example demonstrates how to use the MultiSelectTree in a reactive form with complex value binding.
Managing the MultiSelectTree Disabled State in Reactive Forms
To disable the MultiSelectTree 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 MultiSelectTree within a FormField with hint and error messages.