Controllo Spinner

Un comando utilizzato per creare un'esperienza di caricamento.

Nota

Documentazione e codice sorgente sono disponibili nel repository dei componenti del codice GitHub.

Description

Una casella di selezione è un contorno di un cerchio che si anima su se stesso indicando all'utente che gli elementi sono in fase di elaborazione. Viene visualizzato quando il processo non è sicuro di quanto tempo impiegherà un'attività rendendola la versione indeterminata di un controllo ProgressIndicator.

Le caselle di selezione possono variare in dimensioni e possono essere posizionate in linea con il contenuto o centrate. Le caselle di selezione vengono generalmente visualizzate dopo l'elaborazione o il commit di un'azione. Sono sottili e generalmente non occupano molto spazio, ma sono transizioni dall'attività completata.

Questo componente di codice fornisce un wrapper attorno al comando dell'Interfaccia utente Fluent Casella di selezione per l'utilizzo in canvas e pagine personalizzate. Vedi la documentazione del componente per le procedure consigliate.

Proprietà chiave

Proprietà	Descrizione
Label	Etichetta opzionale per casella di selezione.
SpinnerSize	La dimensione della casella di selezione di cui eseguire il rendering. Scelte: xSmall, Small, Medium, Large
SpinnerAlignment	L'allineamento della caselle di selezione entro i limiti del controllo. Scelte: Left, Center, Right
LabelPosition	Posizionamento facoltativo dell'etichetta della caselle di selezione in una posizione particolare. Scelte: Bottom, Top, Left, Right

Proprietà di stile

Proprietà	Descrizione
Theme	Accetta una stringa JSON generata utilizzando la finestra di progettazione del tema dell'interfaccia utente Fluent (windows.net). Lasciare questo vuoto comporterà l'utilizzo del tema predefinito definito da Power Apps. Vedi la creazione di temi per istruzioni su come eseguire la configurazione.
AccessibilityLabel	Etichetta aria per utilità per la lettura dello schermo

Esempio

Visualizzare la casella di selezione durante il caricamento

Rendi visibile il controllo di selezione quando inizia un processo, quindi nascondilo quando il processo è completo.

Utilizza una variabile per controllare la visibilità della casella di selezione e aggiorna i valori prima e dopo il blocco di codice del processo.

UpdateContext({ var_showLoader: true });

/* Some code ... */

UpdateContext({ var_showLoader: false });

Quindi, fornire la variabile var_showLoader come valore per la proprietà IsLoading della casella di selezione.

Limiti

Questo componente di codice può essere usato solo nelle app canvas e nelle pagine personalizzate.