跳到主要内容

Tooltip

一个 Material Design 工具提示。

工具提示提供文本标签，帮助解释按钮或其他用户界面操作的功能。将按钮包装在工具提示控件中，并提供一个在长按控件时显示的消息。

属性​

bgcolor​

工具提示的背景颜色。

blend_mode​

绘制工具提示时应用的混合模式。

值的类型是 BlendMode。

border​

工具提示的边框。

border_radius​

工具提示的 border radius。

enable_feedback​

当设置为 True（默认值）时，工具提示应提供声响和/或触觉反馈。

例如，在 Android 上，点击会发出点击声，而长按会产生短暂的振动，启用反馈时如此。

enable_tap_to_dismiss​

工具提示是否可以通过点击来关闭。

默认为 True。

exclude_from_semantics​

工具提示的消息是否应从语义树中排除。

默认为 False。

exit_duration​

工具提示在长按释放或点击释放或鼠标指针离开控件后，显示的时间长度（以毫秒为单位）。

gradient​

工具提示的背景渐变。

值的类型是 Gradient。

height​

工具提示内容的高度。

image​

工具提示的背景图像。

值的类型是 DecorationImage。

margin​

工具提示周围的空白空间。

值的类型是 Margin 或一个数字。

message​

要在工具提示中显示的文本。

padding​

工具提示内容的内边距。

值是 Padding 类的实例或一个数字。

在移动设备上，默认为水平 16.0 逻辑像素和垂直 4.0 逻辑像素。在桌面上，默认为水平 8.0 逻辑像素和垂直 4.0 逻辑像素。

prefer_below​

工具提示是否默认显示在控件下方。 如果没有足够的空间在首选方向显示工具提示，则工具提示将显示在相反方向。

默认为 True。

shadow​

在工具提示后面投射的阴影列表。

shape​

工具提示的形状。

值的类型是 BoxShape。

show_duration​

工具提示在长按释放或点击释放或鼠标指针离开控件后，显示的时间长度（以毫秒为单位）。

text_align​

工具提示消息的水平对齐方式。

值的类型是 TextAlign，默认为 TextAlign.LEFT。

text_style​

工具提示消息使用的 TextStyle。

trigger_mode​

工具提示触发的模式。

值的类型是 TooltipTriggerMode。

vertical_offset​

控件与显示的工具提示之间的垂直间距。

wait_duration​

指针必须悬停在工具提示控件上的时间长度（以毫秒为单位），才能显示工具提示。

默认为 0 毫秒（工具提示在悬停时立即显示）。

使用示例​

import math
import flet as ft


def main(page: ft.Page):
    page.add(
        ft.Text("悬停以查看简单工具提示", tooltip="这是一个简单的工具提示"),
        ft.Text(
            value="悬停以查看复杂工具提示",
            tooltip=ft.Tooltip(
                message="这是一个复杂的工具提示",
                padding=20,
                border_radius=10,
                text_style=ft.TextStyle(size=20, color=ft.colors.WHITE),
                gradient=ft.LinearGradient(
                    begin=ft.alignment.top_left,
                    end=ft.alignment.Alignment(0.8, 1),
                    colors=[
                        "0xff1f005c",
                        "0xff5b0060",
                        "0xff870160",
                        "0xffac255e",
                        "0xffca485c",
                        "0xffe16b5c",
                        "0xfff39060",
                        "0xffffb56b",
                    ],
                    tile_mode=ft.GradientTileMode.MIRROR,
                    rotation=math.pi / 3,
                ),
            ),
        ),
    )


ft.app(main)