Улучшить эту документацию Посмотреть исходный код form.FormController
- тип в модуле ng
FormController отслеживает все свои элементы управления и вложенные формы, а также их состояние, например, валидность/невалидность или грязь/первоначальное состояние.
Каждый директива формы создаёт экземпляр FormController.
Методы
-
$rollbackViewValue();
Откатывает все элементы управления формы, ожидающие обновления в
$modelValue.Обновления могут ожидать из-за отложенного события или потому, что входное значение ожидает некоторое будущее событие, определенное в
ng-model-options. Этот метод обычно требуется кнопке сброса формы, которая используетng-model-optionsдля отложенного обновления. -
$commitViewValue();
Сохраняет все элементы управления формы, ожидающие обновления в
$modelValue.Обновления могут ожидать из-за отложенного события или потому, что входное значение ожидает некоторое будущее событие, определенное в
ng-model-options. Этот метод редко требуется, так какNgModelControllerобычно обрабатывает вызов этого в ответ на события ввода. -
$addControl();
Регистрирует элемент управления в форме.
Элементы ввода с использованием ngModelController делают это автоматически при их подключении.
-
$removeControl();
Удаляет элемент управления из формы.
Элементы ввода с использованием ngModelController делают это автоматически при их уничтожении.
-
$setValidity();
Устанавливает валидность элемента управления формы.
Этот метод также будет распространяться на родительские формы.
-
$setDirty();
Устанавливает форму в грязное состояние.
Этот метод можно вызвать, чтобы добавить класс 'ng-dirty' и установить форму в грязное состояние (класс ng-dirty). Этот метод также будет распространяться на родительские формы.
-
$setPristine();
Устанавливает форму в первоначальное состояние.
Этот метод можно вызвать, чтобы удалить класс 'ng-dirty' и установить форму в первоначальное состояние (класс ng-pristine). Этот метод также будет распространяться на все элементы управления, содержащиеся в этой форме.
Установка формы обратно в первоначальное состояние часто полезна, когда мы хотим «переиспользовать» форму после сохранения или сброса.
-
$setUntouched();
Устанавливает форму в состояние «нетронутое».
Этот метод можно вызвать, чтобы удалить класс 'ng-touched' и установить элементы управления формы в состояние «нетронутое» (класс ng-untouched).
Установка элементов управления формы обратно в состояние «нетронутое» часто полезна при установке формы обратно в первоначальное состояние.
-
$setSubmitted();
Устанавливает форму в состояние «отправленная».
Свойства
-
$pristine
booleanИстина, если пользователь еще не взаимодействовал с формой.
-
$dirty
booleanИстина, если пользователь уже взаимодействовал с формой.
-
$valid
booleanИстина, если все содержащие формы и элементы управления являются валидными.
-
$invalid
booleanИстина, если хотя бы один содержащий элемент управления или форма невалидны.
-
$submitted
booleanИстина, если пользователь отправил форму, даже если она невалидна.
-
$error
ObjectЭто хэш-объект, содержащий ссылки на элементы управления или формы с невалидными валидаторами, где:
- ключи — это токены валидации (имена ошибок),
-
значения — это массивы элементов управления или форм, которые имеют невалидный валидатор для данного имени ошибки.
Встроенные токены валидации:
-
email maxmaxlengthminminlengthnumberpatternrequiredurldatedatetimelocaltimeweekmonth
© 2010–2017 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://code.angularjs.org/1.3.20/docs/api/ng/type/form.FormController