Spec-Zone.ru › Angular.js 1.3

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

  1. тип в модуле 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

    • max
    • maxlength
    • min
    • minlength
    • number
    • pattern
    • required
    • url
    • date
    • datetimelocal
    • time
    • week
    • month

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API