次の方法で共有

ProgressIndicator コントロール

  • [アーティクル]

読み込みエクスペリエンスを作成するために使用されるコントロール。

Note

説明書の全文とソース コードは、GitHub コード コンポーネント リポジトリ を参照してください。

ProgressIndicator control.

説明設定

進行状況インジケーターは、2 秒を超える操作の完了ステータスを示すために使用されます。 進行状況を判断できない場合は、代わりに Spinner または Indeterminate Indicator 型を使用します。 進行状況インジケーターは、操作を開始した UI の下の新しいパネル、ポップアップ ウィンドウに表示することができます。または活動がキャンセルまたは停止された場合に UI が戻ることができる限り、開始 UI を置き換えることもできます。

このコード コンポーネントは、キャンバス & カスタム ページで使用するための Fluent UI ProgressIndicator コントロールのラッパーを提供します。 ベスト プラクティスについては、コンポーネントの説明書を参照してください。

プロパティ​​

重要なプロパティ

Property 説明設定
Label スピナーのオプション ラベル。
Percentage Complete 完了した操作の割合 (0 - 1のスケール)。 設定されていない場合、不確定インジケーターが表示されます。
TypeOfIndicator インジケーター スタイルの種類を指定します。 選択肢: Default Indicator または IndeterminateIndicator
HideProgressState 進行状況を非表示にするには true を指定します
BarHeight 必要に応じてバーの高さを指定します

スタイル プロパティ

Property 説明設定
Theme Fluent UI テーマ デザイナー (windows.net) を使用して生成された JSON 文字列を受け入れます。 これを空白のままにすると、Power Apps が定義した既定のテーマが使用されます。 構成方法に関するガイドラインは、テーマ を参照してください。
AccessibilityLabel スクリーン リーダーの aria-label

Behavior

読み込みの進行状況を表示する

プロセスの開始時に ProgressIndicator コントロール自体 (またはその中にある領域) を表示し、プロセスのセグメントが完了したら、変数を値で更新します。 プロセスが完了したら、非表示にします。 変数を使用してコントロールの表示を制御し、指示が必要なプロセスの主要なコード ブロック間の値を更新します。

UpdateContext({ var_showProgress: true , var_progressValue: 0 });

/* Some code ... */

UpdateContext({ var_progressValue: 25 });

/* Some code ... */

UpdateContext({ var_progressValue: 50 });

/* Some code ... */

UpdateContext({ var_progressValue: 75 });

/* Some code ... */

UpdateContext({ var_progressValue: 100 });

Notify("Successfully completed process", NotificationType.Success);

UpdateContext({ var_showProgress: false });

ProgressIndicator (またはそれを含む領域) の Visible プロパティの値として var_showProgress 変数を指定し、Value プロパティに var_progressValue 変数を割り当てます。

制限

このキャンバス コンポーネントは、キャンバス アプリとカスタム ページでのみ使用できます。