跳到主要内容

进度条 ProgressBar

一个材料设计的线性进度指示器，也称为进度条。

该控件显示沿着一条线的进度。

线性进度指示器有两种类型：

  • 确定型. 确定型进度指示器在每一个时间点都有一个具体的值，并且该值应该从 0.0 单调递增到 1.0，在该时间点指示器完成。要创建确定型进度指示器，请使用 0.0 到 1.0 之间的非空值。
  • 不确定型. 不确定型进度指示器在每一个时间点没有具体的值，并且表示进展正在被做出，而不指示剩余多少进度。要创建不确定型进度指示器，请使用空值。

示例​

在线示例

from time import sleep

import flet as ft

def main(page: ft.Page):
    pb = ft.ProgressBar(width=400)

    page.add(
        ft.Text("线性进度指示器", style="headlineSmall"),
        ft.Column([ ft.Text("正在进行某些操作..."), pb]),
        ft.Text("不确定型进度条", style="headlineSmall"),
        ft.ProgressBar(width=400, color="amber", bgcolor="#eeeeee"),
    )

    for i in range(0, 101):
        pb.value = i * 0.01
        sleep(0.1)
        page.update()

ft.app(target=main)

属性​

value​

进度指示器的值。值为 0.0 表示没有进度，值为 1.0 表示进度完成。该值将被夹在 0.0-1.0 的范围内。如果为 null，则该进度指示器是不确定型的，这意味着指示器显示一个预定义动画，不指示实际进度有多少。

bar_height​

绘制线性指示器所使用的线的最小高度。默认是 4。

color​

进度指示器的颜色。

bgcolor​

线性指示器填充的轨道的颜色。

tooltip​

当鼠标悬停在控件上时显示的文本。