Триггеры форм
Триггеры форм отвечают на ввод пользователя: выбор в списке, переключение тумблера, набор текста. Через них форма становится живой — реагирует по ходу заполнения, а не только в момент отправки.
On Selected
Срабатывает, когда пользователь выбирает или меняет значение в виджете с вариантами: Dropdown, RadioButton, CheckboxGroup, ChoiceChips, Slider.
- Dropdown — способ доставки. Пользователь выбирает «Standard», «Express» или «Next Day». Действие в On Selected записывает выбор в переменную
shippingOption, а вместе с ней пересчитываются стоимость и срок. - Slider — громкость. Пользователь двигает ползунок от 0 до 100, а On Selected показывает сообщение с текущим значением.
- ChoiceChips — фильтр каталога. Нажатие на «Все», «Электроника» или «Одежда» записывает выбор в
selectedCategoryи перестраивает список товаров.
Как использовать:
- Выделите поддерживаемый виджет — например, Dropdown.
- Откройте вкладку Actions в панели свойств и нажмите + Add Action.
- Тип действия уже будет On Selected: всё добавленное выполнится при смене выбора.
- Опишите действия: записать значение, перейти на страницу, показать сообщение.
On Toggled On и On Toggled Off
Срабатывают, когда пользователь включает или выключает переключаемый виджет: Checkbox, CheckboxListTile, Switch, SwitchListTile.
Удобны, когда включение и выключение должны приводить к разным действиям.
- Switch — тёмная тема. Действие в On Toggled On включает тёмное оформление.
- Checkbox — согласие с условиями. Отметка включает кнопку отправки через On Toggled On, снятие — выключает через On Toggled Off.
- CheckboxListTile — каналы уведомлений. Почта, SMS, push: каждое переключение сохраняет выбор на бэкенде.
Как использовать:
- Выделите поддерживаемый виджет — например, Switch.
- Откройте вкладку Actions в панели свойств и нажмите + Add Action.
- Выберите On Toggled On для включения или On Toggled Off для выключения.
- Добавьте действия: изменить переменную, показать сообщение, разблокировать кнопку, отправить запрос.
On Change
Срабатывает по ходу ввода — на каждое изменение содержимого поля. Поддерживается виджетами TextField и Pincode.
Через него делают проверку на лету, обновляют состояние приложения и включают элементы интерфейса по мере заполнения.
- TextField — кнопка по готовности. Пока пользователь печатает адрес почты, On Change проверяет его и включает кнопку «Продолжить», когда адрес выглядит корректным.
- Pincode — автоотправка. Как только введены все шесть цифр, On Change отправляет форму или запрос на сервер.
Как использовать:
- Выделите поддерживаемый виджет — например, TextField.
- Откройте вкладку Actions в панели свойств и нажмите + Add Action.
- Выберите триггер On Change.
- Опишите действия: записать значение, показать сообщение, вызвать API.
On Focus Change
Срабатывает, когда поле получает или теряет фокус: пользователь ткнул в TextField или Pincode либо ушёл из него. Годится и для подсказок, и для проверки введённого.
- TextField — подсказка по фокусу. Поле получило фокус — On Focus Change показывает пояснение: «Номер телефона без дефисов».
- Pincode — проверка на выходе. Пользователь ушёл из поля — проверяем, полон ли код, и при необходимости показываем ошибку.
Как использовать:
- Выделите поддерживаемый виджет — например, TextField.
- Откройте вкладку Actions в панели свойств и нажмите + Add Action.
- Выберите триггер On Focus Change.
- Опишите действия: показать подсказку, проверить ввод, обновить интерфейс.
