transformValue()

function transformValue<TForm, TValue>(
   field, 
   transformer, 
   options?): void;

Defined in: core/behavior/behaviors/transform-value.ts:62

Трансформация значения поля при изменении Позволяет автоматически форматировать или преобразовывать значения

Type Parameters

TForm

TForm extends FormFields

TValue

TValue extends FormValue = FormValue

Parameters

field

FieldPathNode<TForm, TValue>

Поле для трансформации

transformer

(value) => TValue

Функция трансформации

options?

TransformValueOptions & object

Опции

Returns

void

Example

const schema: BehaviorSchemaFn<MyForm> = (path) => {
  // Автоматически переводить текст в верхний регистр
  transformValue(path.code, (value) => value?.toUpperCase());

  // Форматировать номер телефона
  transformValue(path.phone, (value) => {
    if (!value) return value;
    const digits = value.replace(/\D/g, '');
    if (digits.length === 11) {
      return `+7 (${digits.slice(1, 4)}) ${digits.slice(4, 7)}-${digits.slice(7, 9)}-${digits.slice(9)}`;
    }
    return value;
  });

  // Удалять пробелы из email
  transformValue(path.email, (value) => value?.trim().toLowerCase());

  // Округлять числа
  transformValue(path.amount, (value) => {
    return typeof value === 'number' ? Math.round(value) : value;
  });
};