Skip to main content

FormArray

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

Массив под-форм: строка — FormGroup над элементом массива модели.

Данными массив не владеет: мутации уходят в массив модели, формы строк держатся за под-модели и при move/swap не пересоздаются.

Индексы (at, keyAt, insert, removeAt, move, swap) — по строкам формы. Элемент null в массиве модели строкой не становится, и индекс строки может не совпасть с индексом модели.

Extends​

Type Parameters​

T​

T extends object

Элемент массива

Methods​

at()​

at(index): FormGroup<T> | undefined;

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

Parameters​

index​

number

Returns​

FormGroup<T> | undefined

clear()​

clear(): void;

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

Returns​

void

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

forEach()​

forEach(callback): void;

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

Parameters​

callback​

(row, index) => void

Returns​

void

getValue()​

getValue(): T[];

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

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

Returns​

T[]

Inherited from​

FormNode.getValue

insert()​

insert(index, item?): void;

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

Parameters​

index​

number

item?​

T

Returns​

void

keyAt()​

keyAt(index): string;

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

Стабильный ключ строки: держится за элемент модели и не меняется при move и swap.

Parameters​

index​

number

Returns​

string

map()​

map<R>(callback): R[];

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

Type Parameters​

R​

R

Parameters​

callback​

(row, index) => R

Returns​

R[]

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

move()​

move(from, to): void;

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

Parameters​

from​

number

to​

number

Returns​

void

push()​

push(item?): void;

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

Добавить строку; без значения — по шаблону массива модели (arrayOf(blank)).

Parameters​

item?​

T

Returns​

void

removeAt()​

removeAt(index): void;

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

Parameters​

index​

number

Returns​

void

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

swap()​

swap(first, second): void;

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

Parameters​

first​

number

second​

number

Returns​

void

Properties​

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

length​

readonly length: number;

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

Число строк; чтение в эффекте или computed подписывает на изменения.

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

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