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

Установка поля формы [Действие]

Действие Установка поля формы позволяет программно заполнить или обновить значение любого виджета ввода — например, TextField, Dropdown или других элементов формы — во время выполнения. Это особенно полезно, когда нужно быстро заполнить или изменить поля ввода на основе предпочтений пользователя (например, сохранённых адресов) или предустановленной информации.

возможные сценарии использования
  • Использование сохранённого адреса: Если пользователь включает опцию «Использовать сохранённый адрес», можно установить значения полей Полное имя, Улица, Город и Почтовый индекс из профиля пользователя или базы данных.
  • Редактирование существующих данных: При переходе на страницу «Редактировать профиль» можно автоматически заполнить TextField текущей информацией о пользователе, чтобы он изменил только необходимое.
  • Автоматический выбор страны/региона в Dropdown: Автоматически выбрать страну и регион пользователя на основе служб геолокации или настроек аккаунта.

При добавлении действия Установка поля формы выберите целевой виджет (например, TextField) и присвойте значение — оно может поступать из переменной, такой как fullName, в бэкенде, состоянии приложения или параметрах страницы.

set-form-field-action.avif

Если нужно обновить несколько виджетов (например, TextField и Dropdown), используйте отдельное действие Установка поля формы для каждого и укажите соответствующее значение.

multiple-set-form-field.avif

Фокусировка поля при установке​

Вы также можете задать дополнительные параметры, такие как фокусировка поля и поведение курсора, с помощью опции Фокусировка поля при установке. При включении этой опции фокус автоматически устанавливается на поле после присвоения значения.

Это полезно в сценариях, таких как переключатель «Редактировать полное имя»: при активации поле предварительно заполняется существующим именем, а курсор позиционируется для немедленного редактирования.

При включённой опции Фокусировка поля при установке можно выбрать одно из следующих положений Позиции курсора:

  • Конец: Размещает курсор в конце нового текста, позволяя пользователю продолжить ввод с последнего символа.
  • Начало: Позиционирует курсор в начале текста.
  • Выделение: Выделяет весь текст, позволяя пользователю сразу его перезаписать.
  • Сохранение: Сохраняет положение курсора (если оно было), что полезно, когда пользователь уже вводит текст и изменена только часть.

focus-field-when-set

к сведению

Вы также можете устанавливать поля формы внутри дочернего компонента текущего виджета.

set-form-field-component