跳到主要内容

CupertinoCheckbox

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

示例​

在线示例

CupertinoCheckbox 和自适应 CheckBox 示例​

import flet as ft

def main(page: ft.Page):
    page.add(
        ft.CupertinoCheckbox(label="Cupertino 复选框", value=True),
        ft.Checkbox(label="Material 复选框", 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，则控件将被选为初始焦点。如果页面上有多个控件设置了自动对焦，则第一个添加到页面的控件将获得焦点。

check_color​

选中此复选框时用于勾选图标的颜色。

active_color​

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

inactive_color​

复选框未激活时用于复选框边框的颜色。

focus_color​

复选框获得输入焦点时用于复选框边框阴影的颜色。

label​

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

label_position​

定义label显示在复选框的哪一侧。属性值是LabelPosition。默认值为RIGHT。

tristate​

如果为True，复选框的值可以为True、False或None。

当复选框的值为 null 时，会显示一个破折号。

value​

复选框的当前值。

事件​

on_blur​

当控件失去焦点时触发。

on_change​

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

on_focus​

当控件获得焦点时触发。