class
Creates an AbstractControl
from a user-specified configuration.
class FormBuilder { group(controlsConfig: { [key: string]: any; }, options: AbstractControlOptions | { [key: string]: any; } = null): FormGroup control(formState: any, validatorOrOpts?: ValidatorFn | AbstractControlOptions | ValidatorFn[], asyncValidator?: AsyncValidatorFn | AsyncValidatorFn[]): FormControl array(controlsConfig: any[], validatorOrOpts?: ValidatorFn | AbstractControlOptions | ValidatorFn[], asyncValidator?: AsyncValidatorFn | AsyncValidatorFn[]): FormArray }
The FormBuilder
provides syntactic sugar that shortens creating instances of a FormControl
, FormGroup
, or FormArray
. It reduces the amount of boilerplate needed to build complex forms.
group() | ||||||
---|---|---|---|---|---|---|
Construct a new | ||||||
|
controlsConfig | object | A collection of child controls. The key for each child is the name under which it is registered. |
options | AbstractControlOptions | { [key: string]: any; } | Configuration options object for the 1)
2) Legacy configuration object, which consists of:
Optional. Default is |
control() | |||||||||
---|---|---|---|---|---|---|---|---|---|
Construct a new | |||||||||
|
formState | any | Initializes the control with an initial state value, or with an object that contains both a value and a disabled status. |
validatorOrOpts | ValidatorFn | AbstractControlOptions | ValidatorFn[] | A synchronous validator function, or an array of such functions, or an Optional. Default is |
asyncValidator | AsyncValidatorFn | AsyncValidatorFn[] | A single async validator or array of async validator functions. Optional. Default is |
The following example returns a control with an initial value in a disabled state.
import {Component, Inject} from '@angular/core'; import {FormBuilder, FormControl, FormGroup, Validators} from '@angular/forms'; /* . . . */ @Component({ selector: 'app-disabled-form-control', template: ` <input [formControl]="control" placeholder="First"> ` }) export class DisabledFormControlComponent { control: FormControl; constructor(private fb: FormBuilder) { this.control = fb.control({value: 'my val', disabled: true}); } }
array() | |||||||||
---|---|---|---|---|---|---|---|---|---|
Constructs a new | |||||||||
|
controlsConfig | any[] | An array of child controls or control configs. Each child control is given an index when it is registered. |
validatorOrOpts | ValidatorFn | AbstractControlOptions | ValidatorFn[] | A synchronous validator function, or an array of such functions, or an Optional. Default is |
asyncValidator | AsyncValidatorFn | AsyncValidatorFn[] | A single async validator or array of async validator functions. Optional. Default is |
© 2010–2020 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://v10.angular.io/api/forms/FormBuilder