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 変数を指定します。

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