UniversalCircularProgressIndicator constructor

const UniversalCircularProgressIndicator({
  1. Key? key,
  2. double? value,
  3. Color? backgroundColor,
  4. Color? color,
  5. Animation<Color?>? valueColor,
  6. double? strokeWidth,
  7. double? strokeAlign,
  8. String? semanticsLabel,
  9. String? semanticsValue,
  10. StrokeCap? strokeCap,
  11. BoxConstraints? constraints,
  12. double? trackGap,
  13. EdgeInsetsGeometry? padding,
})

A Material Design circular progress indicator, which spins to indicate that the application is busy.

A widget that shows progress along a circle. There are two kinds of circular progress indicators:

  • Determinate. Determinate progress indicators have a specific value at each point in time, and the value should increase monotonically from 0.0 to 1.0, at which time the indicator is complete. To create a determinate progress indicator, use a non-null value between 0.0 and 1.0.
  • Indeterminate. Indeterminate progress indicators do not have a specific value at each point in time and instead indicate that progress is being made without indicating how much progress remains. To create an indeterminate progress indicator, use a null value.

The indicator arc is displayed with valueColor, an animated value. To specify a constant color use: AlwaysStoppedAnimation<Color>(color).

{@tool dartpad} This example showcases determinate and indeterminate CircularProgressIndicators. The CircularProgressIndicators will use the updated Material 3 Design appearance

** See code in examples/api/lib/material/progress_indicator/circular_progress_indicator.0.dart ** {@end-tool}

{@tool dartpad} This sample shows the creation of a CircularProgressIndicator with a changing value. When toggling the switch, CircularProgressIndicator uses a determinate value. As described in: https://m3.material.io/components/progress-indicators/overview

** See code in examples/api/lib/material/progress_indicator/circular_progress_indicator.1.dart ** {@end-tool}

See also:

アプリケーションがビジー状態であることを示すために回転するMaterial Designの円形プログレスインジケーターです。

円に沿って進行状況を表示するウィジェットです。円形プログレスインジケーターには2つの種類があります:

  • 確定的。確定的プログレスインジケーターは各時点で特定の値を持ち、 値は0.0から1.0まで単調に増加し、その時点でインジケーターが完了します。 確定的プログレスインジケーターを作成するには、0.0から1.0の間の非nullvalueを使用します。
  • 不確定的。不確定的プログレスインジケーターは各時点で特定の値を持たず、 代わりに残りの進行状況を示すことなく進行中であることを示します。 不確定的プログレスインジケーターを作成するには、nullvalueを使用します。

インジケーターの弧は、アニメーション値であるvalueColorで表示されます。 定数色を指定するには:AlwaysStoppedAnimation<Color>(color)を使用します。

参照:

Implementation

const UniversalCircularProgressIndicator({
  super.key,
  super.value,
  super.backgroundColor,
  super.color,
  super.valueColor,
  super.strokeWidth,
  super.strokeAlign,
  super.semanticsLabel,
  super.semanticsValue,
  super.strokeCap,
  super.constraints,
  super.trackGap,
  super.padding,
});