©
本文档使用 PHP中文网手册 发布
AngularJS: API: ng/type/form.FormController
form.FormController
- - type in module ng
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.
方法
-
$rollbackViewValue();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 usesng-model-optionsto pend updates. -
$commitViewValue();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 asNgModelControllerusually handles calling this in response to input events. -
$addControl();Register a control with the form.
Input elements using ngModelController do this automatically when they are linked.
-
$removeControl();Deregister a control from the form.
Input elements using ngModelController do this automatically when they are destroyed.
-
$setValidity();Sets the validity of a form control.
This method will also propagate to parent forms.
-
$setDirty();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.
-
$setPristine();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.
属性
-
$pristineboolean True if user has not interacted with the form yet.
-
$dirtyboolean True if user has already interacted with the form.
-
$validboolean True if all of the containing forms and controls are valid.
-
$invalidboolean True if at least one containing control or form is invalid.
-
$errorObject Is an object hash, containing references to all invalid controls or forms, where:
- keys are validation tokens (error names),
- values are arrays of controls or forms that are invalid for given error name.
Built-in validation tokens:
emailmaxmaxlengthminminlengthnumberpatternrequiredurl