跳到主要内容

进度环

一个 Material Design 的圆形进度指示器，它旋转以指示应用程序忙碌。

一个显示圆形进度的控件。

有两种类型的圆形进度指示器：

  • 确定的。确定的进度指示器在每个时间点都有一个特定的值，该值应该从 0.0 单调递增到 1.0，当达到 1.0 时，指示器完成。要创建一个确定的进度指示器，请使用 0.0 到 1.0 之间的非空值。
  • 不确定的。不确定的进度指示器在每个时间点没有特定的值，而是指示进度正在进行中，而不指示剩余的进度。要创建一个不确定的进度指示器，请使用空值。

示例​

实时示例

from time import sleep
import flet as ft

def main(page: ft.Page):
    pr = ft.ProgressRing(width=16, height=16, stroke_width = 2)

    page.add(
        ft.Text("圆形进度指示器", style="headlineSmall"),
        ft.Row([pr, ft.Text("等待完成...")]),
        ft.Text("不确定的圆形进度", style="headlineSmall"),
        ft.Column(
            [ft.ProgressRing(), ft.Text("我将运行很长时间...")],
            horizontal_alignment=ft.CrossAxisAlignment.CENTER,
        ),
    )

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

ft.app(target=main)

属性​

bgcolor​

圆形轨迹的背景颜色。

color​

进度指示器的颜色。

semantics_label​

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

semantics_value​

该进度指示器的语义值。

stroke_align​

线条相对位置。值通常在 -1.0（内部线条）和 1.0（外部线条）之间。

默认值为 0 - 居中。

stroke_cap​

进度指示器的线条结尾。值是 StrokeCap 。

stroke_width​

用于绘制圆形的线条宽度。

tooltip​

鼠标悬停时显示的文本。

value​

该进度指示器的值。值为 0.0 表示无进度，1.0 表示进度完成。该值将被夹紧在 0.0-1.0 范围内。如果为空，该进度指示器是不确定的，即指示器显示一个预定义的动画，不指示实际进度的多少。