跳到主要内容

进度环 ProgressRing

一个材料设计的圆形进度指示器，旋转表示应用程序正在忙碌中。

这是一个显示进度的环形控件。

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

  • 确定型。确定型进度指示器在每个时间点都有特定的值，该值应从0.0递增到1.0，在此时指示器完成。要创建确定型进度指示器，请使用0.0到1.0之间的非空值。
  • 不确定型。不确定型进度指示器在每个时间点没有特定的值，而是指示正在进行进度，而不指示还剩多少进度。要创建不确定型进度指示器，请使用空值。

Examples​

Live example

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("Circular progress indicator", style="headlineSmall"),
        ft.Row([pr, ft.Text("Wait for the completion...")]),
        ft.Text("Indeterminate cicrular progress", style="headlineSmall"),
        ft.Column(
            [ft.ProgressRing(), ft.Text("I'm going to run for ages...")],
            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)
ProgressRing 示例

属性​

bgcolor​

进度环指示器所填充的圆形轨道的颜色。

color​

进度指示器的颜色。

stroke_width​

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

tooltip​

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

value​

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