FormController
keeps track of all its controls and nested forms as well as the state of them, such as being valid/invalid or dirty/pristine.
Each form directive creates an instance of FormController
.
Rollback all form controls pending updates to the $modelValue
.
Updates may be pending by a debounced event or because the input is waiting for a some future event defined in ng-model-options
. This method is typically needed by the reset button of a form that uses ng-model-options
to pend updates.
Commit all form controls pending updates to the $modelValue
.
Updates may be pending by a debounced event or because the input is waiting for a some future event defined in ng-model-options
. This method is rarely needed as NgModelController
usually handles calling this in response to input events.
Register a control with the form.
Input elements using ngModelController do this automatically when they are linked.
Deregister a control from the form.
Input elements using ngModelController do this automatically when they are destroyed.
Sets the validity of a form control.
This method will also propagate to parent forms.
Sets the form to a dirty state.
This method can be called to add the 'ng-dirty' class and set the form to a dirty state (ng-dirty class). This method will also propagate to parent forms.
Sets the form to its pristine state.
This method can be called to remove the 'ng-dirty' class and set the form to its pristine state (ng-pristine class). This method will also propagate to all the controls contained in this form.
Setting a form back to a pristine state is often useful when we want to 'reuse' a form after saving or resetting it.
Sets the form to its untouched state.
This method can be called to remove the 'ng-touched' class and set the form controls to their untouched state (ng-untouched class).
Setting a form controls back to their untouched state is often useful when setting the form back to its pristine state.
Sets the form to its submitted state.
boolean |
True if user has not interacted with the form yet. |
boolean |
True if user has already interacted with the form. |
boolean |
True if all of the containing forms and controls are valid. |
boolean |
True if at least one containing control or form is invalid. |
boolean |
True if user has submitted the form even if its invalid. |
Object |
Is an object hash, containing references to controls or forms with failing validators, where:
|
© 2010–2016 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://code.angularjs.org/1.3.20/docs/api/ng/type/form.FormController