跳到主要内容

macOS风格复选框 CupertinoCheckbox

一个 macOS 风格的复选框（checkbox）。复选框允许从一个组中选择一个或多个项目，或在两个互斥选项之间切换（选中或未选中，开或关）。

示例​

在线示例

CupertinoCheckbox 和自适应 CheckBox 示例​

import flet as ft

def main(page: ft.Page):
    page.add(
        ft.CupertinoCheckbox(label="Cupertino Checkbox", value=True),
        ft.Checkbox(label="Material Checkbox", value=True),
        ft.Container(height=20),
        ft.Text(
            "自适应复选框在 macOS 和 iOS 上显示为 CupertinoCheckbox，在其他平台上显示为 Checkbox:"
        ),
        ft.Checkbox(adaptive=True, label="自适应复选框", value=True),
    )

ft.app(target=main)

属性​

autofocus​

如果控件将作为初始焦点选中，则为True。如果页面上有多个设置了 autofocus 属性的控件，则会将焦点设置给页面上最先添加的控件。

check_color​

当复选框被选中时，用于显示选中状态图标的颜色。

active_color​

在复选框选中时用于填充的颜色。

inactive_color​

在复选框处于非活动状态时用于边框的颜色。

focus_color​

当复选框拥有输入焦点时用于边框阴影的颜色。

label​

在复选框右侧显示的可点击标签。

label_position​

属性值为包含 LabelPosition 枚举的 LabelPosition.RIGHT，默认为右侧。

tristate​

如果为 True，则复选框的值可以是 True、False 或 None（null）。

当复选框的值为 null 时，会显示一个短横线。

value​

复选框的当前值。

事件​

on_blur​

当控件失去焦点时触发。

on_change​

当复选框的状态发生改变时触发。

on_focus​

当控件获得焦点时触发。