Spinner controlar

Controle usado para criar uma experiência de carregamento.

Nota

Documentação completa e código-fonte encontrados no repositório de componentes de código GitHub.

Description

Um Spinner é um contorno de um círculo que faz uma animação em torno de si mesmo, indicando para o usuário que há informações sendo processadas. Ele aparece quando o processo não sabe a duração de uma tarefa, o que faz com que se torne a versão indeterminada de um controle ProgressIndicator.

Os Spinners podem variar de tamanho e estar localizados em linha com o conteúdo ou centralizados. Geralmente, os Spinners aparecem depois que uma ação é processada ou confirmada. Eles são sutis e costumam não ocupar muito espaço, mas são transições da tarefa concluída.

Este componente de código fornece um wrapper em torno do controle Fluent UI Spinner para uso em tela e páginas personalizadas. Consulte a documentação do componente para obter as melhores práticas.

Principais propriedades

Propriedade	Description
Label	Etiqueta opcional para spinner.
SpinnerSize	O tamanho do spinner a ser renderizado. Escolhas: xSmall, Small, Medium, Large
SpinnerAlignment	O alinhamento do spinner dentro dos limites de controle. Escolhas: Left, Center, Right
LabelPosition	Colocação opcional do rótulo do spinner em uma posição específica. Escolhas: Bottom, Top, Left, Right

Propriedades de estilo

Propriedade	Description
Theme	Aceita uma string JSON que é gerada usando Fluent UI Theme Designer (windows.net). Deixar em branco usará o tema padrão definido pelo Power Apps. Consulte os temas para obter orientação sobre como configurar.
AccessibilityLabel	Rótulo Aria do leitor de tela

Exemplo

Exibir o spinner ao carregar

Torne o controle Spinner visível quando um processo começar e oculte-o quando o processo for concluído.

Use uma variável para controlar a visibilidade do Spinner e atualize os valores antes e depois do bloco de código do processo.

UpdateContext({ var_showLoader: true });

/* Some code ... */

UpdateContext({ var_showLoader: false });

Em seguida, especifique a variável var_showLoader como o valor da propriedade IsLoading do controle giratório.

Limitações

Esse componente de código só pode ser usado em aplicativos de tela e páginas personalizadas.