跳到主要内容

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 开关",
            value=True,
        ),
        ft.Switch(
            label="Material 开关",
            value=True,
            thumb_color={ft.MaterialState.SELECTED: ft.colors.BLUE},
            track_color=ft.colors.YELLOW,
            focus_color=ft.colors.PURPLE,
        ),
        ft.Container(height=20),
        ft.Text(
            "自适应开关在 macOS 和 iOS 上显示为 CupertinoSwitch，在其他平台上显示为 Switch："
        ),
        ft.Switch(
            adaptive=True,
            label="自适应开关",
            value=True,
        ),
    )


ft.app(target=main)

属性​

active_color​

开关打开时轨道使用的 颜色。

autofocus​

如果控件将被选择为初始焦点，则为 True。如果页面上有多个设置了 autofocus 的控件，则首先添加到页面上的控件将获得焦点。

focus_color​

键盘交互的焦点高亮的 颜色。

label​

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

label_position​

属性值为 LabelPosition 枚举。默认值为 RIGHT。

off_label_color​

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

on_label_color​

开关打开时的辅助功能标签使用的 颜色。

默认为 ft.cupertino_colors.WHITE。

thumb_color​

开关的拇指 颜色。

track_color​

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

value​

开关的当前值。

事件​

on_blur​

控件失去焦点时触发。

on_change​

开关状态更改时触发。

on_focus​

控件获得焦点时触发。