Spinner コントロール
読み込みエクスペリエンスを作成するために使用されるコントロール。
Note
説明書の全文とソース コードは、GitHub コード コンポーネント リポジトリ を参照してください。
説明設定
スピナーは、円の輪郭で、その周りをアニメーション化して物事が処理中であることをユーザーに示します。 プロセスのタスクにかかる時間が不明な場合に表示され、ProgressIndicator コントロールの不確定バージョンになります。
スピナーのサイズはさまざまで、コンテンツに合わせてインラインに配置することも、中央に配置することもできます。 スピナーは通常、アクションが処理またはコミットされた後に表示されます。 それらは微妙で、通常多くのスペースを占有しませんが、完了済みタスクからの切り替えです。
このコード コンポーネントは、キャンバスおよびカスタム ページで使用するための Fluent UI Spinner コントロールのラッパーを提供します。 ベスト プラクティスについては、コンポーネントの説明書を参照してください。
主要なプロパティ
Property | 説明設定 |
---|---|
Label |
スピナーのオプション ラベル。 |
SpinnerSize |
レンダリングされるスピナーのサイズ。 選択肢: xSmall 、Small 、Medium 、Large |
SpinnerAlignment |
コントロール境界内のスピナーの配置。 選択肢: Left 、Center 、Right |
LabelPosition |
特定の位置へのスピナー ラベルのオプションの配置。 選択肢: Bottom 、Top 、Left 、Right |
スタイル プロパティ
Property | 説明設定 |
---|---|
Theme |
Fluent UI テーマ デザイナー (windows.net) を使用して生成された JSON 文字列を受け入れます。 これを空白のままにすると、Power Apps が定義した既定のテーマが使用されます。 構成方法に関するガイドラインは、テーマ を参照してください。 |
AccessibilityLabel |
スクリーン リーダーの aria-label |
例
読み込み時にスピナーを表示する
プロセスの開始時にスピナー コントロールを表示し、プロセスの完了時に非表示にします。
変数を使用してスピナーの表示を制御し、プロセスのコード ブロックの前後の値を更新します。
UpdateContext({ var_showLoader: true });
/* Some code ... */
UpdateContext({ var_showLoader: false });
次に、スピナーの IsLoading
プロパティの値として var_showLoader
変数を指定します。
制限
このコード コンポーネントは、キャンバス アプリとカスタム ページでのみ使用できます。