Перейти к основному содержимому

FormControl

Defined in: form/types/nodes.ts:80

Поле формы: нода над листом модели и состояние его компонента.

Extends​

Type Parameters​

T​

T

Значение поля

Methods​

clearIssues()​

clearIssues(): void;

Defined in: form/types/nodes.ts:72

Returns​

void

Inherited from​

FormNode.clearIssues

disable()​

disable(): void;

Defined in: form/types/nodes.ts:69

Returns​

void

Inherited from​

FormNode.disable

enable()​

enable(): void;

Defined in: form/types/nodes.ts:68

Returns​

void

Inherited from​

FormNode.enable

getValue()​

getValue(): T;

Defined in: form/types/nodes.ts:57

Значение без подписки.

Returns​

T

Inherited from​

FormNode.getValue

markAsTouched()​

markAsTouched(): void;

Defined in: form/types/nodes.ts:66

Returns​

void

Inherited from​

FormNode.markAsTouched

markAsUntouched()​

markAsUntouched(): void;

Defined in: form/types/nodes.ts:67

Returns​

void

Inherited from​

FormNode.markAsUntouched

reset()​

reset(value?): void;

Defined in: form/types/nodes.ts:65

Вернуть значение и состояние к начальным; с аргументом — к переданному значению. В цель compute значение не пишется (кроме явного reset(значение) самого поля): ею владеет поведение — сбрасывается только состояние.

Parameters​

value?​

T

Returns​

void

Inherited from​

FormNode.reset

setIssues()​

setIssues(issues): void;

Defined in: form/types/nodes.ts:71

Поставить замечания извне (ответ сервера, своя проверка).

Parameters​

issues​

readonly ValidationIssue[]

Returns​

void

Inherited from​

FormNode.setIssues

setValue()​

setValue(value): void;

Defined in: form/types/nodes.ts:59

Записать значение в модель.

Parameters​

value​

T

Returns​

void

Inherited from​

FormNode.setValue

updateComponentProps()​

updateComponentProps(patch): void;

Defined in: form/types/nodes.ts:98

Слить правку в пропсы компонента (например, опции после загрузки справочника).

Parameters​

patch​

Record<string, unknown>

Returns​

void

Properties​

component​

readonly component: ComponentRef | undefined;

Defined in: form/types/nodes.ts:82

Компонент поля из узла схемы.

componentProps​

readonly componentProps: ReadonlySignal<Readonly<Record<string, unknown>>>;

Defined in: form/types/nodes.ts:84

Пропсы компонента: из узла схемы и правок FormControl.updateComponentProps.

dirty​

readonly dirty: ReadonlySignal<boolean>;

Defined in: form/types/nodes.ts:47

Значение меняли после создания или сброса.

Inherited from​

FormNode.dirty

disabled​

readonly disabled: ReadonlySignal<boolean>;

Defined in: form/types/nodes.ts:43

Нода отключена: её замечания сняты, в проверку она не входит.

Inherited from​

FormNode.disabled

invalid​

readonly invalid: ReadonlySignal<boolean>;

Defined in: form/types/nodes.ts:39

Есть блокирующие замечания; нода включена и не ждёт проверки.

Inherited from​

FormNode.invalid

issues​

readonly issues: ReadonlySignal<readonly ValidationIssue[]>;

Defined in: form/types/nodes.ts:49

Замечания ноды; у группы и массива — свои и всех детей.

Inherited from​

FormNode.issues

ownIssues​

readonly ownIssues: ReadonlySignal<readonly ValidationIssue[]>;

Defined in: form/types/nodes.ts:54

Собственные замечания ноды — без замечаний детей: у группы и массива это правила на их ручке (minLength массива, cross группы), у поля — то же, что issues.

Inherited from​

FormNode.ownIssues

pending​

readonly pending: ReadonlySignal<boolean>;

Defined in: form/types/nodes.ts:41

Идёт асинхронная проверка.

Inherited from​

FormNode.pending

shouldShowError​

readonly shouldShowError: ReadonlySignal<boolean>;

Defined in: form/types/nodes.ts:90

Показывать ли состояние ошибки (aria-invalid, рамка): поле невалидно и его трогали или меняли. Предупреждение (severity: 'warning') поле невалидным не делает — тексты замечаний показывают по FormControl.shouldShowIssues.

shouldShowIssues​

readonly shouldShowIssues: ReadonlySignal<boolean>;

Defined in: form/types/nodes.ts:96

Показывать ли тексты замечаний: у поля есть замечания — ошибки или предупреждения, — и его трогали или меняли. Условия те же, что у FormControl.shouldShowError (не выключено, проверка не идёт), но в счёт идёт любое замечание, а не только блокирующее.

touched​

readonly touched: ReadonlySignal<boolean>;

Defined in: form/types/nodes.ts:45

Пользователь взаимодействовал с нодой.

Inherited from​

FormNode.touched

valid​

readonly valid: ReadonlySignal<boolean>;

Defined in: form/types/nodes.ts:37

Замечаний, которые блокируют отправку, нет; нода включена и не ждёт проверки.

Inherited from​

FormNode.valid

value​

readonly value: ReadonlySignal<T>;

Defined in: form/types/nodes.ts:35

Текущее значение.

Inherited from​

FormNode.value