Spinner Controlo
Um controlo utilizado para criar uma experiência de carregamento.
Nota
A documentação completa e o código de origem encontram-se no repositório de componentes de código do GitHub.
Description
Um Ícone de Progresso é um círculo que se anima em torno de si mesmo indicando ao utilizador que as coisas estão a ser processadas. Aparece quando o processo não tem a certeza da duração de uma tarefa, tornando-a na versão indeterminada de um controlo ProgressIndicator.
Os Ícones de Progresso podem variar em tamanho e podem estar localizados inline com conteúdo ou centrados. Geralmente, os Ícones de Progresso aparecem após uma ação estar a ser processada ou cometida. São subtis e, geralmente, não ocupam muito espaço, mas são transições da tarefa concluída.
Este componente de código fornece um wrapper em torno do controlo Spinner da Fluent UI para utilização em telas e páginas personalizadas. Consulte a documentação do componente para melhores práticas.
Propriedades-chave
| Property | Description |
|---|---|
Label |
Etiqueta opcional para o ícone de progresso. |
SpinnerSize |
O tamanho do ícone de progresso a ser composto. Escolhas: xSmall, Small, Medium, Large |
SpinnerAlignment |
O alinhamento do ícone de progresso dentro dos limites do controlo. Escolhas: Left, Center, Right |
LabelPosition |
Colocação opcional da etiqueta do ícone de progresso numa posição específica. Escolhas: Bottom, Top, Left, Right |
Propriedades de estilo
| Property | Description |
|---|---|
Theme |
Aceita uma cadeia JSON que é gerada através do Estruturador de Teams da Fluent UI (windows.net). Deixar isto em branco irá utilizar o tema predefinido estabelecido pelo Power Apps. Consulte personalizar o tema para obter orientações sobre como configurar. |
AccessibilityLabel |
Etiqueta aria de leitor de ecrã |
Exemplo
Apresentar o ícone de progresso ao carregar
Tornar visível o controlo spinner quando um processo começa e, em seguida, oculte-o quando o processo for concluído.
Utilize uma variável para controlar a visibilidade do ícone de progresso e atualizar os valores antes e depois do bloco de código do processo.
UpdateContext({ var_showLoader: true });
/* Some code ... */
UpdateContext({ var_showLoader: false });
Em seguida, forneça a variável var_showLoader como o valor para a propriedade IsLoading do ícone de progresso.
Limitações
Este componente de código só pode ser utilizado em aplicações de tela e páginas personalizadas.