FormField — Angular | Spec-Zone.ru

Связывает поле формы FieldTree с элементом управления пользовательского интерфейса, который его редактирует. Элемент управления пользовательского интерфейса может быть одним из следующих:

Нативный элемент HTML input или textarea
Пользовательский элемент управления signal forms, реализующий FormValueControl или FormCheckboxControl
Компонент, предоставляющий ControlValueAccessor. Его следует использовать только для обратной совместимости с реактивными формами. Предпочтительны варианты (1) и (2).

API

class FormField<T> {
  readonly @Input('formField') field: InputSignal<Field<T>>;
  readonly state: Signal<FieldState<T, string | number>>;
  readonly injector: Injector;
  readonly element: HTMLElement;
  readonly errors: Signal<WithFieldTree[]>;
  focus(options?: FocusOptions | undefined): void;
  reset(): void;
  registerAsBinding(bindingOptions?: FormFieldBindingOptions | undefined): void;
}

field

InputSignal<Field<T>>

Поле, связываемое с базовым элементом управления формы.

state

Signal<FieldState<T, string | number>>

FieldState для текущего связанного поля.

injector

Injector

Инъектор узла для DOM-элемента, содержащего эту привязку поля.

element

HTMLElement

DOM-элемент, содержащий эту привязку поля.

errors

Signal<WithFieldTree[]>

Ошибки, связанные с этим полем формы.

focus

void

Устанавливает фокус на эту привязку поля.

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

@paramoptionsFocusOptions | undefined

@returnsvoid

reset

void

Сбрасывает связанный элемент управления.

@returnsvoid

registerAsBinding

void

Регистрирует этот FormField как привязку к связанному с ним FieldState.

Этот метод следует вызывать не более одного раза для каждого FormField. FormField, размещённый на пользовательском элементе управления (FormUiControl), автоматически регистрирует этот элемент управления как привязку.

@parambindingOptionsFormFieldBindingOptions | undefined

@returnsvoid

Описание

Нативный элемент HTML input или textarea
Пользовательский элемент управления signal forms, реализующий FormValueControl или FormCheckboxControl
Компонент, предоставляющий ControlValueAccessor. Его следует использовать только для обратной совместимости с реактивными формами. Предпочтительны варианты (1) и (2).

Эта директива выполняет несколько задач:

Обеспечивает двустороннюю привязку значения состояния поля к значению элемента управления пользовательского интерфейса
Привязывает к элементу управления дополнительные связанные с формами состояния поля (disabled, required и т. д.)
Передаёт соответствующие события элемента управления в состояние поля (например, помечает поле как затронутое при потере фокуса)
Предоставляет фиктивный NgControl, реализующий часть функций, доступных в NgControl реактивных форм. Это сделано для повышения совместимости с элементами управления, разработанными для работы с реактивными формами. Не следует использовать его для элементов управления, написанных для signal forms.