# Kendo UI for Angular FormField Overview

The [FormField](https://www.telerik.com/kendo-angular-ui-develop/components/inputs/api/formfieldcomponent) component represents a single form field within a [Form](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/form) or [FormFieldSet](https://www.telerik.com/kendo-angular-ui-develop/components/inputs/api/formfieldsetcomponent).

The FormField is a component that enables you to group, align, and control form-related content such as labels, inputs, dropdowns, hint and error messages.

```html
<form kendoForm [formGroup]="form">
  <kendo-formfield>
    <kendo-label [for]="name" text="Name"></kendo-label>
    <kendo-textbox #name formControlName="name"></kendo-textbox>
  </kendo-formfield>
</form>
```

Each `kendo-formfield` element can contain a single form control element (except the RadioButton group), a label, and multiple [hint or error messages](https://www.telerik.com/kendo-angular-ui-develop/components/inputs/form/formfield/hints-errors).

The following example demonstrates the FormField component in action.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/inputs/form/formfield/overview/source.txt)

## Form Controls

The FormField component is designed to work with various form controls, allowing you to create a wide range of input types and validation scenarios. It provides a consistent and professional user experience while leveraging Angular's form handling capabilities.

The FormField component supports various form controls, including:

* Input fields (TextBox, NumericTextBox, ColorPicker, Switch, and others)
* Dropdown fields (DropDownList, MultiSelect, AutoComplete, and others)
* Date and time pickers (DatePicker, TimePicker, DateTimePicker, and others)
* Checkboxes and radio buttons
* Upload components (Upload, FileSelect)

### Input Fields

The FormField component can be used with various input fields, such as TextBox, NumericTextBox, ColorPicker, and others.

The following example demonstrates Kendo Inputs within a form in action.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/inputs/form/formfield/controls/inputs/source.txt)

### Checkboxes and RadioButtons

The FormField component supports Checkboxes and RadioButtons, allowing you to create groups of options for users to select from. The Checkboxes can be used for multiple selections, while RadioButtons are ideal for single-choice scenarios.

The following example demonstrates Kendo Checkboxes and RadioButtons within a form in action.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/inputs/form/formfield/controls/checkboxes-radiobuttons/source.txt)

### Upload and FileSelect

The FormField component can be used with the Kendo Upload and FileSelect components, allowing users to upload files directly within the form. This integration provides a seamless experience for file uploads, including drag-and-drop support and progress tracking.

The following example demonstrates Kendo Upload and FileSelect within a form in action.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/inputs/form/formfield/controls/uploads/source.txt)

### DropDown Fields

The FormField component can be used with various components that are part of the [Kendo Angular DropDowns](https://www.telerik.com/kendo-angular-ui-develop/components/dropdowns) package. These components provide users with a convenient way to select from a list of options, enhancing the form's usability.

The following example demonstrates Kendo DropDowns within a form in action.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/inputs/form/formfield/controls/dropdowns/source.txt)

### Date Fields

The FormField component can be used with various components that are part of the [Kendo Angular DateInputs](https://www.telerik.com/kendo-angular-ui-develop/components/dateinputs) package. These components allow users to select dates and times easily, providing a consistent experience across different form fields.

The following example demonstrates Kendo DateInputs within a form in action.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/inputs/form/formfield/controls/dateinputs/source.txt)

## Read-Only and Disabled Controls

Rendering a control as `readonly` makes it immutable, preventing user edits. However, read-only controls remain interactive: they can receive focus, respond to certain user actions, and participate in constraint validation.

In contrast, rendering a control as `disabled` also makes it immutable, but with additional restrictions. Disabled controls do not respond to user interaction, cannot receive focus, and are excluded from constraint validation. Moreover, in both [Reactive](https://angular.io/guide/reactive-forms) and [Template-driven](https://angular.io/guide/forms#template-driven-forms) Angular forms, disabled controls are omitted from the [`FormGroup`](https://angular.dev/api/forms/FormGroup) value object by default.

To define a disabled control in Reactive Forms, apply [Validator functions](https://angular.io/guide/form-validation#validator-functions) directly to the form control instance within the component class.

To disable a component when working with Reactive forms and Angular 15 or later, use the FormControl's [`disabled` property/option](https://angular.io/api/forms/AbstractControl#disabled) or [`disable()` method](https://angular.io/api/forms/AbstractControl#disable).

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/inputs/form/formfield/controls/readonly-disabled/source.txt)

## Suggested Links

* [API Reference of the FormField](https://www.telerik.com/kendo-angular-ui-develop/components/inputs/api/formfieldcomponent)
* [API Reference of the Form](https://www.telerik.com/kendo-angular-ui-develop/components/inputs/api/formcomponent)
* [API Reference of the FormFieldSet](https://www.telerik.com/kendo-angular-ui-develop/components/inputs/api/formfieldsetcomponent)
* [Kendo UI for Angular Form Overview](https://www.telerik.com/kendo-angular-ui-develop/components/inputs/form)
