ProgressIndicator コントロール
読み込みエクスペリエンスを作成するために使用されるコントロール。
Note
説明書の全文とソース コードは、GitHub コード コンポーネント リポジトリ を参照してください。
説明設定
進行状況インジケーターは、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 変数を割り当てます。
制限
このキャンバス コンポーネントは、キャンバス アプリとカスタム ページでのみ使用できます。