Spinner 控制

用來建立下載體驗的控制項。

Note

完整文件和原始程式碼可在 GitHub 程式碼元件存放庫中找到。

描述

進度環是一個圓圈的輪廓，它圍繞自身進行動畫處理，向使用者表示正在處理。 當流程不確定工作將花費多長時間使其成為 ProgressIndicator 控制項的不確定版本時，就會出現此項目。

進度環的大小可以不同，而且可以嵌入至內容或置中。 進度環通常會在處理或提交動作之後顯示。 它們不太顯眼，通常不會佔用太多空間，但它們是完成任務的轉場。

此程式碼元件為 Fluent UI Spinner 控制項提供了一個包裝函式，以便在畫布和自訂頁面中使用。 如需最佳做法，請參閱元件文件。

索引鍵屬性

屬性	描述
Label	微調按鈕的選擇性標籤。
SpinnerSize	要呈現的微調按鈕大小。 選擇：xSmall、Small、Medium、Large
SpinnerAlignment	微調按鈕在控制邊界內的對齊方式。 選擇：Left、Center、Right
LabelPosition	可選擇將微調按鈕標籤置於特定位置。 選擇：Bottom、Top、Left、Right

樣式屬性

屬性	描述
Theme	接受使用 Fluent UI Theme Designer (windows.net) 產生的 JSON 字串。 將此留空將使用 Power Apps 定義的預設主題。 有關如何設定的指南，請參閱佈景主題。
AccessibilityLabel	螢幕助讀程式 aria-label

範例

載入時顯示微調按鈕

當流程開始時，顯示 spinner 控制項，然後在流程完成後隱藏 spinner 控制項。

使用變數來控制進度環的可見度，並更新流程代碼區塊前後的值。

UpdateContext({ var_showLoader: true });

/* Some code ... */

UpdateContext({ var_showLoader: false });

然後，提供 var_showLoader 變數作為進度環 IsLoading 屬性的值。

限制

此程式碼元件只能在畫布應用程式和自訂頁面中使用。