CupertinoActionSheet

An iOS-style action sheet.

Action sheets are generally used to give the user a choice between two or more choices for the current context.

Inherits: LayoutControl

Properties

• actions(list[Control] | None) –

  A list of action buttons to be shown in the sheet.

• cancel(Control | None) –

  An optional control to be shown below the actions but grouped separately from them.

• message(StrOrControl | None) –

  A control containing a descriptive message that provides more details about the

• title(StrOrControl | None) –

  A control containing the title of the action sheet.

Examples

Live example

Basic Example

import flet as ft


def main(page: ft.Page):
    page.horizontal_alignment = ft.CrossAxisAlignment.CENTER

    def handle_click(e):
        page.add(ft.Text(f"Action clicked: {e.control.content.value}"))
        page.pop_dialog()

    action_sheet = ft.CupertinoActionSheet(
        title=ft.Row(
            controls=[ft.Text("Title"), ft.Icon(ft.Icons.BEDTIME)],
            alignment=ft.MainAxisAlignment.CENTER,
        ),
        message=ft.Row(
            controls=[ft.Text("Description"), ft.Icon(ft.Icons.AUTO_AWESOME)],
            alignment=ft.MainAxisAlignment.CENTER,
        ),
        cancel=ft.CupertinoActionSheetAction(
            content=ft.Text("Cancel"),
            on_click=handle_click,
        ),
        actions=[
            ft.CupertinoActionSheetAction(
                content=ft.Text("Default Action"),
                default=True,
                on_click=handle_click,
            ),
            ft.CupertinoActionSheetAction(
                content=ft.Text("Normal Action"),
                on_click=handle_click,
            ),
            ft.CupertinoActionSheetAction(
                content=ft.Text("Destructive Action"),
                destructive=True,
                on_click=handle_click,
            ),
        ],
    )

    bottom_sheet = ft.CupertinoBottomSheet(action_sheet)

    page.add(
        ft.CupertinoFilledButton(
            content="Open CupertinoBottomSheet",
            on_click=lambda e: page.show_dialog(bottom_sheet),
        )
    )


ft.run(main)

Properties

actions

actions: list[Control] | None = None

A list of action buttons to be shown in the sheet.

These actions are typically CupertinoActionSheetActions.

Raises:

• ValueError –

  If none of actions, title, message, or cancel are provided.

cancel

cancel: Control | None = None

An optional control to be shown below the actions but grouped separately from them.

Typically a CupertinoActionSheetAction button.

message

message: StrOrControl | None = None

A control containing a descriptive message that provides more details about the reason for the alert.

Typically a Text control.

title

title: StrOrControl | None = None

A control containing the title of the action sheet.

Typically a Text control.