跳到主要内容

CupertinoSwitch

一个 iOS 风格的开关。

用于切换单个设置的开/关状态。

开关代表一个物理开关，允许用户在两个互斥的选项之间进行选择。

例如，“开/关”，“显示/隐藏”。选择一个选项应产生即时结果。

import logging
import flet as ft
import asyncio

logging.basicConfig(level=logging.DEBUG)


def main(page: ft.Page):
    page.add(
        ft.CupertinoSwitch(
            label="Cupertino Switch",
            value=True,
        ),
        ft.Switch(
            label="Material Switch",
            value=True,
            thumb_color={ft.ControlState.SELECTED: ft.Colors.BLUE},
            track_color=ft.Colors.YELLOW,
            focus_color=ft.Colors.PURPLE,
        ),
        ft.Container(height=20),
        ft.Text(
            "Adaptive Switch shows as CupertinoSwitch on macOS and iOS and as Switch on other platforms:"
        ),
        ft.Switch(
            adaptive=True,
            label="Adaptive Switch",
            value=True,
        ),
    )


ft.app(target=main)

属性​

属性​

active_color​

:::警告 自v0.26.0起此属性已弃用，并将在v0.29.0中删除。请使用active_track_color代替。 :::

开关开启时用于轨道的颜色。

默认为CupertinoColors.SYSTEM_GREEN。

active_thumb_image​

开关开启时用于此开关拇指的图像。可以是本地文件路径或 URL。

active_track_color​

开关开启时用于轨道的颜色。

默认为CupertinoColors.SYSTEM_GREEN。

autofocus​

如果控件将被选为初始焦点，则为True。如果页面上有多个设置了自动聚焦的控件，则添加到页面上的第一个控件将获得焦点。

focus_color​

用于键盘交互的焦点高亮显示的颜色。

inactive_thumb_color​

开关关闭时用于拇指的颜色。如果为None，则默认为thumb_color，如果thumb_color也为None，则默认为CupertinoColors.WHITE。

inactive_thumb_image​

开关关闭时用于此开关拇指的图像。可以是本地文件路径或 URL。

inactive_track_color​

开关关闭时用于轨道的颜色。

默认为CupertinoColors.SECONDARY_SYSTEM_FILL。

label​

要显示在开关右侧的可点击标签。

label_position​

标签相对于开关的位置。

值的类型为LabelPosition，默认为LabelPosition.RIGHT。

off_label_color​

开关关闭时用于辅助功能标签的颜色。

on_label_color​

开关开启时用于辅助功能标签的颜色。

默认为cupertino_colors.WHITE。

thumb_color​

开关拇指的颜色。

thumb_icon​

此开关拇指在各种ControlState状态下的图标。

支持以下ControlState值：SELECTED（选中）、HOVERED（悬停）、DISABLED（禁用）、FOCUSED（聚焦）和DEFAULT（回退）。

track_color​

:::警告 自v0.26.0起此属性已弃用，并将在v0.29.0中删除。请使用inactive_track_color代替。 :::

开关关闭时用于轨道的颜色。

默认为CupertinoColors.SECONDARY_SYSTEM_FILL。

track_outline_color​

此开关轨道在各种ControlState状态下的轮廓颜色。

支持以下ControlState值：SELECTED（选中）、HOVERED（悬停）、DISABLED（禁用）、FOCUSED（聚焦）和DEFAULT（回退）。

track_outline_width​

此开关轨道在所有或特定ControlState状态下的轮廓宽度。

支持以下状态：SELECTED（选中）、HOVERED（悬停）、DISABLED（禁用）、FOCUSED（聚焦）和DEFAULT（回退）。

value​

开关的当前值。

事件​

on_blur​

当控件失去焦点时触发。

on_change​

当开关状态改变时触发。

on_image_error​

当图像（active_thumb_image或inactive_thumb_image）加载失败时触发。

on_focus​

当控件获得焦点时触发。