Виджет «Таймер» показывает отсчет оставшегося или потраченного времени. Например, отображение обратного отсчета для предложения с ограниченным временем, времени, оставшегося до повторной отправки OTP, целевой страницы и т.д.
На этой странице вы узнаете, как добавить виджет таймера, его типы и как его настроить.

Типы виджета таймера
При добавлении виджета таймера вы можете установить следующие типы:
- Count Down: отсчет начинается с указанного времени (например, 10 минут) и останавливается при достижении 0-й секунды.
- Отсчет вверх: Начинает отсчет с 0-й секунды и останавливается только тогда, когда вы остановите его.
Вот как выглядят оба типа таймеров:


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

Ниже приведены пошаговые инструкции по созданию такого примера:
- Создание пользовательского интерфейса
- Добавление действий (запуск, остановка, сброс)
- Получение уведомления об окончании/остановке таймера (необязательно)
1. Создание пользовательского интерфейса
Вот пример того, как вы можете добавить все необходимые виджеты в ваш проект:
- Сначала нажмите на + Add Widget и перетащите виджет Timer с вкладки Base Elements или добавьте его непосредственно из дерева виджетов.
- Перейдите на панель свойств, прокрутите вниз до раздела Timer и установите тип таймера.
- Если вы выбрали тип Count Down, введите длительность в Countdown Time. Примечание: Введите это значение в мс (т.е. 1000 мс = 1 секунда). Если вы хотите установить продолжительность 15 секунд, введите значение 15000.
- Вы также можете установить различные форматы времени с помощью выпадающего списка Формат.
- Теперь добавьте три кнопки и назовите их Start, Stop и Reset, которые будут использоваться для управления этим виджетом.

2. Добавление действий (запуск, остановка, сброс)
После того как пользовательский интерфейс готов, вы можете добавить действия для запуска, остановки и сброса таймера, посетив следующую страницу:
3. Получение уведомления об окончании/остановке таймера (необязательно)
Иногда вы можете захотеть получить обратный вызов, когда таймер заканчивается, и добавить дальнейшие действия. Например, показать сообщение на Snackbar по окончании таймера обратного отсчета и сбросить его в исходное состояние.
Вот как можно получить обратный вызов при завершении/остановке таймера:
- Выберите виджет Timer в дереве виджетов или в области холста.
- Выберите Действия на панели свойств (правое меню) и нажмите Открыть. Это откроет редактор потока действий в новом всплывающем окне.
- Вверху вы увидите надпись On Timer End, здесь вы можете добавить любое действие, которое будет вызвано, когда таймер закончится/остановится.

Настройка виджета таймера
Вы можете настроить внешний вид и поведение этого виджета с помощью различных свойств, доступных на панели свойств.
Стилизация текста таймера
Посмотрите, как можно изменить стиль текста.
Добавление подкладок
Здесь описано, как добавить подложку.
Настроить выравнивание
Здесь приведены инструкции по настройке выравнивания.
Показать/скрыть виджет
Инструкции по отображению/скрытию виджета находятся здесь.