跳到主要内容

进度条

材料设计线性进度指示器,也称为进度条。

显示线上进度的控件。

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

  • 确定的。确定的进度指示器在每个时间点都有一个特定的值,该值应该从 0.0 单调递增到 1.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 范围内。如果为空,该进度指示器是不确定的,即指示器显示一个预定义的动画,该动画不表示实际进度的多少。

bar_height

线性指示器所用的最小高度。默认为 4。

border_radius

指示器和轨道的边框半径。边框半径是 BorderRadius 类的实例。

默认为 border_radius.all(0) - 矩形形状。

bgcolor

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

color

进度指示器的颜色。

semantics_label

Semantics.label该进度指示器的语义标签。

semantics_value

Semantics.value该进度指示器的语义值。

tooltip

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