跳到主要内容

按钮样式 ButtonStyle

允许控制按钮的所有视觉方面，例如形状、前景色、背景色和阴影颜色、内容填充、边框宽度和半径。

这些样式属性中的大多数可以针对按钮的全部或特定的ControlState进行配置，例如HOVERED（悬停）、FOCUSED（聚焦）、DISABLED（禁用）以及其他状态。

ButtonStyle 类具有以下属性：

alignment（对齐方式）​

按钮内容的对齐方式。

值的类型为 Alignment。

animation_duration（动画时长）​

定义形状和高程动画变化的持续时间（以毫秒为单位）。

bgcolor（背景颜色）​

按钮的背景填充颜色。

color（颜色）​

按钮的文本和图标控件后代的颜色。

elevation（高程）​

按钮材质的高程。

enable_feedback（启用反馈）​

检测到的手势是否应提供声音和/或触觉反馈。

值的类型为 bool。

icon_color（图标颜色）​

按钮内部图标的颜色。如果未设置或为 None，则将使用 color。

icon_size（图标大小）​

按钮内部图标的大小。

mouse_cursor（鼠标光标）​

当鼠标指针进入或悬停在按钮上时显示的光标。

overlay_color​

高亮颜色，通常用于指示按钮被聚焦、悬停或按下。

shadow_color​

按钮的 Material 阴影颜色。

surface_tint_color​

按钮的 Material 表面着色颜色。

elevation​

按钮的 Material 海拔。

animation_duration​

形状和海拔动画变化的持续时间（毫秒）。

padding​

按钮边界与其内容之间的填充。

值的类型为 Padding。

shape​

按钮底层材质的形状。

值的类型为 OutlinedBorder。

side​

一个 BorderSide 类的实例，即按钮轮廓的颜色和粗细。

text_style​

按钮的 Text 控件后代的文本样式。

值的类型为 TextStyle。

visual_density​

定义按钮布局的紧凑程度。

值的类型为 VisualDensity。

使用示例​

可以为悬停状态配置不同的形状和背景颜色，并为所有其他状态配置回退值。

要为所有 Material 状态配置样式属性，请将其值设置为文字（或类实例）。例如，如果将 color 属性设置为文字，则该值将应用于所有按钮状态：

ButtonStyle(
    color=ft.Colors.WHITE
)

要为特定 Material 状态配置样式属性，请将其值设置为字典，其中键为状态名称。例如，要为 HOVERED 和 FOCUSED 状态配置不同的背景颜色，并为所有其他状态配置其他颜色：

ButtonStyle(
    color={
        ft.ControlState.HOVERED: ft.Colors.WHITE,
        ft.ControlState.FOCUSED: ft.Colors.BLUE,
        ft.ControlState.DEFAULT: ft.Colors.BLACK,
    }
)

各种按钮形状示例​

import flet as ft

def main(page: ft.Page):
    page.padding = 30
    page.spacing = 30
    page.add(
        ft.FilledButton(
            "圆形",
            style=ft.ButtonStyle(
                shape=ft.StadiumBorder(),
            ),
        ),
        ft.FilledButton(
            "圆角矩形",
            style=ft.ButtonStyle(
                shape=ft.RoundedRectangleBorder(radius=10),
            ),
        ),
        ft.FilledButton(
            "连续矩形",
            style=ft.ButtonStyle(
                shape=ft.ContinuousRectangleBorder(radius=30),
            ),
        ),
        ft.FilledButton(
            "斜角矩形",
            style=ft.ButtonStyle(
                shape=ft.BeveledRectangleBorder(radius=10),
            ),
        ),
        ft.FilledButton(
            "圆圈",
            style=ft.ButtonStyle(shape=ft.CircleBorder(), padding=30),
        ),
    )

ft.app(target=main)

风格按钮示例​

查看以下示例：

import flet as ft

def main(page: ft.Page):

    page.add(
        ft.ElevatedButton(
            "Styled button 1",
            style=ft.ButtonStyle(
                color={
                    ft.ControlState.HOVERED: ft.Colors.WHITE,
                    ft.ControlState.FOCUSED: ft.Colors.BLUE,
                    ft.ControlState.DEFAULT: ft.Colors.BLACK,
                },
                bgcolor={ft.ControlState.FOCUSED: ft.Colors.PINK_200, "": ft.Colors.YELLOW},
                padding={ft.ControlState.HOVERED: 20},
                overlay_color=ft.Colors.TRANSPARENT,
                elevation={"pressed": 0, "": 1},
                animation_duration=500,
                side={
                    ft.ControlState.DEFAULT: ft.BorderSide(1, ft.Colors.BLUE),
                    ft.ControlState.HOVERED: ft.BorderSide(2, ft.Colors.BLUE),
                },
                shape={
                    ft.ControlState.HOVERED: ft.RoundedRectangleBorder(radius=20),
                    ft.ControlState.DEFAULT: ft.RoundedRectangleBorder(radius=2),
                },
            ),
        )
    )

ft.app(target=main)