Skip to main content

CupertinoTimerPicker

A countdown timer picker in iOS style.

Examples​

Live example

Basic Example​

import time
import flet as ft

def main(page):
    page.theme_mode = ft.ThemeMode.LIGHT
    page.horizontal_alignment = ft.CrossAxisAlignment.CENTER

    timer_picker_value_ref = ft.Ref[ft.Text]()

    def handle_timer_picker_change(e):
        val = int(e.data)
        timer_picker_value_ref.current.value = time.strftime(
            "%H:%M:%S", time.gmtime(val)
        )
        page.update()

    timer_picker = ft.CupertinoTimerPicker(
        value=3600,
        second_interval=10,
        minute_interval=1,
        mode=ft.CupertinoTimerPickerMode.HOUR_MINUTE_SECONDS,
        on_change=handle_timer_picker_change,
    )

    page.add(
        ft.Row(
            tight=True,
            controls=[
                ft.Text("TimerPicker Value:", size=23),
                ft.TextButton(
                    content=ft.Text("00:01:10", size=23, ref=timer_picker_value_ref),
                    style=ft.ButtonStyle(color=ft.colors.RED),
                    on_click=lambda _: page.show_bottom_sheet(
                        ft.CupertinoBottomSheet(
                            timer_picker,
                            height=216,
                            padding=ft.padding.only(top=6),
                        )
                    ),
                ),
            ],
        ),
    )

ft.app(target=main)

Properties​

alignment​

Defines how the timer picker should be positioned within its parent.

Alignment is an instance of alignment.Alignment class.

Defaults to ft.alignment.center.

bgcolor​

The background color of the timer picker.

mode​

The mode of the timer picker. Property value is CupertinoTimerPickerMode enum with the following values:

  • HOUR_MINUTE - shows the timer duration in hour and minute.
  • MINUTE_SECOND - shows the timer duration in minute and second.
  • HOUR_MINUTE_SECOND (default) - shows the timer duration in hour, minute, and second.

item_extent​

The uniform height of all children. Defaults to 32.

second_interval​

The granularity of the second spinner. Must be a positive integer factor of 60. Defaults to 1.

minute_interval​

The granularity of the minute spinner. Must be a positive integer factor of 60. Defaults to 1.

value​

The initial duration in seconds of the countdown timer. Defaults to 0.

Events​

on_change​

Fires when the timer duration changes.