Улучшить эту документацию Просмотреть исходный код form.FormController

Методы

• $rollbackViewValue();

  Откатывает все элементы управления формы, ожидающие обновлений в $modelValue.

  Обновления могут ожидать отложенного события или потому, что вход ожидает некоторого будущего события, определенного в ng-model-options. Этот метод обычно используется кнопкой сброса формы, которая использует ng-model-options для отложенных обновлений.

• $commitViewValue();

  Сохраняет все элементы управления формы, ожидающие обновлений в $modelValue.

  Обновления могут ожидать отложенного события или потому, что вход ожидает некоторого будущего события, определенного в ng-model-options. Этот метод редко необходим, так как NgModelController обычно обрабатывает вызов этого метода в ответ на события ввода.

• $addControl(control);

  Регистрирует элемент управления в форме. Элементы ввода с использованием ngModelController делают это автоматически при связывании.

  Обратите внимание, что текущее состояние элемента управления не будет отражено в новой родительской форме. Это не проблема при нормальном использовании, так как недавно скомпилированные и связанные элементы управления находятся в состоянии $pristine.

  Однако, если метод используется программно, например, для добавления динамически созданных элементов управления или элементов управления, которые были ранее удалены без уничтожения соответствующего DOM-элемента, разработчик должен убедиться, что текущее состояние передается родительской форме.

  Например, если добавлен элемент управления вводом, который уже $dirty и имеет свойства $error, вызов $setDirty() и $validate() впоследствии распространит состояние в родительскую форму.

  Параметры

  Параметр	Тип	Подробности
  control	object	объект управления, либо form.FormController, либо ngModel.NgModelController

• $removeControl(control);

  Удаляет элемент управления из формы.

  Элементы ввода с использованием ngModelController делают это автоматически при уничтожении.

  Обратите внимание, что только состояние валидации удаленного элемента управления ($errors и т.д.) будет удалено из формы. $dirty, $submitted состояния не изменятся, так как ожидаемое поведение может отличаться от случая к случаю. Например, удаление единственного элемента управления $dirty из формы может или не может означать, что форма всё ещё $dirty.

  Параметры

  Параметр	Тип	Подробности
  control	object	объект управления, либо form.FormController, либо ngModel.NgModelController

• $setValidity();

  Устанавливает валидность элемента управления формой.

  Этот метод также распространяется на родительские формы.

• $setDirty();

  Устанавливает форму в состояние "грязная".

  Этот метод может быть вызван для добавления класса 'ng-dirty' и установки формы в состояние "грязная" (класс ng-dirty). Этот метод также распространяется на родительские формы.

• $setPristine();

  Устанавливает форму в первоначальное состояние.

  Этот метод устанавливает состояние формы $pristine в true, состояние $dirty в false, удаляет класс ng-dirty и добавляет класс ng-pristine. Кроме того, он устанавливает состояние $submitted в false.

  Этот метод также распространяется на все элементы управления, содержащиеся в этой форме.

  Установка формы в первоначальное состояние часто полезна, когда мы хотим "переиспользовать" форму после сохранения или сброса.

• $setUntouched();

  Устанавливает форму в состояние "нетронутая".

  Этот метод может быть вызван для удаления класса 'ng-touched' и установки элементов управления формы в состояние "нетронутая" (класс ng-untouched).

  Установка элементов управления формы в состояние "нетронутая" часто полезна при установке формы в первоначальное состояние.

• $setSubmitted();

  Устанавливает форму в состояние "отправленная".

Свойства

• $pristine

  boolean

  True, если пользователь ещё не взаимодействовал с формой.

• $dirty

  boolean

  True, если пользователь уже взаимодействовал с формой.

• $valid

  boolean

  True, если все содержащие формы и элементы управления валидны.

• $invalid

  boolean

  True, если хотя бы один содержащий элемент управления или форма невалидны.

• $pending

  boolean

  True, если хотя бы один содержащий элемент управления или форма ожидают завершения.

• $submitted

  boolean

  True, если пользователь отправил форму, даже если она невалидна.

• $error

  Object

  Это хеш-объект, содержащий ссылки на элементы управления или формы с невалидными валидаторами, где: ключи — это токены валидации (имена ошибок), значения — это массивы элементов управления или форм, которые имеют невалидный валидатор для данного имени ошибки. Встроенные токены валидации: email max maxlength min minlength number pattern required url date datetimelocal time week month