Служебные действия

Служебные действия закрывают взаимодействие с системой и мелкие бытовые задачи: выбрать цвет или дату, скопировать текст, позвонить, отправить письмо.

Выбор цвета (Color Picker)

Действие открывает палитру, где пользователь выбирает цвет мышью или вводит значение в HEX либо RGB. Пригодится, например, если товар продаётся в разных цветах.

После выбора палитра закрывается, а цвет становится доступен в Widget State > Color Picked.

Как добавить действие:

  1. Выделите виджет — контейнер, кнопку или другой.
  2. В панели свойств справа выберите Actions. Если действие первое, нажмите + Add Action; иначе — «+» под предыдущим действием в редакторе и Add Action.
  3. Найдите действие Color Picker (раздел Widget/UI Interactions).
  4. По умолчанию в палитре выделен основной цвет темы; изменить это можно свойством Initially Selected Color.
  5. Внешний вид палитры настраивается цветами Text, Background и Button.
  6. По умолчанию пользователь может задать прозрачность. Чтобы разрешить только непрозрачные цвета, выключите Allow Opacity.
  7. Недавние цвета помогают быстро вернуться к уже использованному оттенку; убрать их можно переключателем Show Recent Color.
  8. Выбранный цвет доступен в Widget State > Color Picked — его можно подставить в свойство любого виджета или сохранить следующим действием в состояние приложения либо в базу.

инфо

Палитра закрывается сама, как только пользователь выбрал цвет; результат лежит в Widget State > Color Picked.

Пример: добавляем выбор цвета и сохраняем результат в переменную App State.

Добавление действия

Настройка внешнего вида

customize-color-picker

Выбор даты и времени (DateTime Picker)

Действие открывает календарь и часы: так записывают на приём, ставят напоминание, выбирают даты поездки.

Виды выбора

  • Date — только дата.
  • Date+Time — сначала дата, потом время.
  • Time — только время.

Как добавить действие:

  1. Выделите виджет — контейнер, кнопку или другой.
  2. В панели свойств справа выберите Actions. Если действие первое, нажмите + Add Action; иначе — «+» под предыдущим действием и Add Action.
  3. Найдите действие Date/Time Picker (раздел Widget/UI Interactions).
  4. Задайте вид выбора.
  5. По умолчанию показываются текущие дата и время; изменить — свойством Default Date/Time.
  6. Диапазон допустимых значений задают Minimum Date/Time и Maximum Date/Time: нажмите Unset и укажите границы.
  7. Переключатели Allow Past Date/Time и Allow Future Date/Time разрешают или запрещают прошлое и будущее. Если явно заданы минимум или максимум, эти настройки становятся недоступны.
  8. Переключатель Use Cupertino-style включает оформление в стиле iOS.

cupertino-style 9. Для тонкой настройки выключите Use Default Theme и задайте значения в разделе Appearance Properties.

appearance-properties

инфо

После выбора окно закрывается само, а значение доступно в Widget State > Date Picked.

Пример: добавляем выбор даты и показываем результат в виджете Text.

Биометрия (Biometric Verification)

Действие использует биометрию устройства — отпечаток пальца или распознавание лица — для защиты доступа.

Оно проверяет, настроена ли биометрия, и просит пользователя подтвердить личность. Если проверка не удалась, открывается запасной вариант: графический ключ, PIN, пароль.

Обычный сценарий — банковское приложение, брокерский счёт, облачное хранилище: всё, куда не должен попасть посторонний.

Как добавить действие:

  1. Выделите виджет — например, кнопку.
  2. В панели свойств справа выберите Actions и нажмите Open — откроется редактор действий.
  3. Нажмите + Add Action.
  4. Найдите действие Biometric Verification (раздел Utilities).
    1. По умолчанию при неудачной биометрии открываются системные способы входа — графический ключ, PIN. Чтобы оставить только биометрию, включите Allow biometric only.
    2. Введите Biometric Reason text — этот текст пользователь увидит в окне проверки.
    3. Задайте Action Output Variable Name: в эту переменную попадёт результат — True (успех) или False (неудача).
    4. Чтобы показать сообщение об успехе или неудаче, добавьте условное действие кнопкой «+» внутри уже добавленного:
      1. Нажмите UNSET, выберите Action Output и укажите имя переменной.
      2. В ветке TRUE добавьте показ сообщения об успехе.
      3. В ветке FALSE — сообщение о неудаче.

Копирование в буфер (Copy to Clipboard)

Действие копирует текст в буфер обмена — например, номер заказа или код, чтобы вставить его в другом приложении.

Как добавить действие:

  1. Выделите виджет — например, кнопку.
  2. В панели свойств справа выберите Actions и нажмите Open.
  3. Нажмите + Add Action.
  4. Найдите действие Copy to Clipboard (раздел Utilities).
  5. Чаще всего значение динамическое: поставьте Value Source в From Variable и укажите источник.
внимание

В режиме Test Mode это действие не проверить — используйте Run Mode.

Тема оформления (Set Dark Mode Setting)

Действие переключает тему приложения на светлую, тёмную или системную.

По системе

Вручную

Варианты настройки

  • From System — тема берётся из настроек Android или iOS. Свой переключатель в приложении при этом не нужен.
  • Light Mode — светлая тема.
  • Dark Mode — тёмная тема.

Как добавить действие:

  1. В панели свойств справа выберите Actions.
  2. Нажмите + Add Action.
  3. Выберите жест: On Tap, On Double Tap или On Long Press.
  4. В Action Type укажите Set Dark Mode Setting.
  5. Задайте Setting SourceSelect Setting.
  6. В Dark Mode Setting выберите From System, Light Mode или Dark Mode.

Письмо (Send Email)

Действие не отправляет письмо само: оно открывает почтовое приложение с заполненными адресом, темой и текстом — отправку подтверждает пользователь.

Как добавить действие:

  1. Выделите виджет — например, кнопку.
  2. В панели свойств справа выберите Actions и нажмите + Add Action.
  3. Найдите действие Send Email (раздел Share).
  4. В поле Email Address укажите адрес получателя.
  5. Заполните Subject и Body.

Звонок (Call Number)

Действие открывает системное приложение звонков с подставленным номером — вызов пользователь начинает сам.

Как добавить действие:

  1. Выделите виджет — например, кнопку.
  2. В панели свойств справа выберите Actions и нажмите + Add Action.
  3. Найдите действие Call Number (раздел Share).
  4. В поле Phone Number укажите номер.

SMS (Send SMS)

Действие открывает приложение сообщений с готовым текстом — отправку подтверждает пользователь.

Как добавить действие:

  1. Выделите виджет — например, кнопку.
  2. В панели свойств справа выберите Actions и нажмите + Add Action.
  3. Найдите действие Send SMS (раздел Share).
  4. В поле Phone Number укажите номер получателя.
  5. В поле SMS Body — текст сообщения.

перевод официальной документации FlutterFlow

обновлено

ESC