跳到主要内容

iOS 风格的开关 CupertinoSwitch

一个 iOS 风格的开关。

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

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

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

示例​

实时示例

CupertinoSwitch 和自适应开关​

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 枚举类型，默认为 LabelPosition.RIGHT。

thumb_color​

开关的颜色。

track_color​

开关关闭时轨道的颜色。

value​

开关的当前值。

事件​

on_blur​

控件失去焦点时触发。

on_change​

开关状态发生改变时触发。

on_focus​

控件获得焦点时触发。