forked from angular/angular
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs(forms): add package overview for forms (angular#25663)
PR Close angular#25663
- Loading branch information
1 parent
20214b6
commit 9700ffc
Showing
2 changed files
with
33 additions
and
9 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,24 @@ | ||
Implements a set of directives and providers to communicate with native DOM elements when building forms | ||
to capture user input. | ||
|
||
Use this API to register directives, build form and data models, and provide validation to your forms. Validators can | ||
be synchronous or asynchronous depending on your use case. You can also extend the built-in functionality | ||
provided by forms in Angular by using the interfaces and tokens to create custom validators and input elements. | ||
|
||
Angular forms allow you to: | ||
|
||
* Capture the current value and validation status of a form. | ||
* Track and listen for changes to the form's data model. | ||
* Validate the correctness of user input. | ||
* Create custom validators and input elements. | ||
|
||
You can build forms in one of two ways: | ||
|
||
* *Reactive forms* use existing instances of a `FormControl` or `FormGroup` to build a form model. This form | ||
model is synced with form input elements through directives to track and communicate changes back to the form model. Changes | ||
to the value and status of the controls are provided as observables. | ||
* *Template-driven* use directives such as `NgModel` and `NgModelGroup` that provide two-way data binding to | ||
track changes within the template using the change detection cycle. | ||
|
||
|
||
@see Find out more in the [Forms Overview](guide/forms-overview). |