Indicador de carregamento: Diretrizes
Os indicadores de carregamento mostram o andamento de um processo durante uma espera curta.
Uso
Os indicadores de carregamento usam animação para chamar a atenção, reduzir a percepção de latência e indicar que uma atividade está em andamento.
Eles devem ser usados quando não é possível determinar o progresso ou quando não é necessário indicar a duração da atividade.
Embora tenham função semelhante à dos indicadores de progresso circulares, os indicadores de carregamento são uma opção melhor para processos curtos, entre 200 ms e 5 s.
Escolha um indicador de carregamento ou um indicador de progresso que corresponda ao tempo de espera previsto e ao tipo de processo.
Se a espera for muito longa, considere permitir que os usuários saiam da página enquanto o processo é concluído.
| Tempo de espera previsto | Recomendação |
|---|---|
| Imediato (menos de 200 ms) | Nenhum indicador |
| Curto (entre 200 ms e 5 s) | Indicador de carregamento |
| Longo (mais de 5 s) | Indicador de progresso |
Quando um processo pode passar de um estado indeterminado (progresso desconhecido) para um estado determinado (progresso restante conhecido), alterne entre os indicadores de progresso correspondentes.
Não transforme um indicador de carregamento em um indicador de progresso.
Anatomia

- Indicador ativo
- Contêiner (opcional)
Indicador ativo
O indicador ativo é uma sequência contínua de transformação de formas, composta por sete formas exclusivas do Material 3.

Contêiner (opcional)
Quando o contêiner estiver visível, o indicador ativo deve mudar da cor primary para on-primary-container.
O contêiner deve ficar visível quando o indicador de carregamento estiver sobre outro conteúdo. Isso aumenta o contraste e melhora o destaque. Ele não é necessário quando o indicador de carregamento é colocado diretamente sobre uma superfície.
Use o contêiner com o comportamento de puxar para atualizar.

Posicionamento
Ao carregar uma página ou um contêiner, o indicador de carregamento deve ser centralizado no elemento.
Ao carregar mais itens em uma página com conteúdo existente, coloque o indicador de carregamento no espaço vazio onde o novo conteúdo aparecerá. Evite cobrir o conteúdo existente.
Os indicadores de carregamento podem ser colocados dentro de outros componentes, como botões, para indicar que a ação está em andamento, por exemplo, ao validar um formulário ou verificar se há atualizações.
Layout responsivo
Os indicadores de carregamento têm tamanho padrão de 48 dp, mas esse tamanho é flexível. Ele deve ficar entre 24 dp e 240 dp, dependendo do posicionamento e do breakpoint. Evite ultrapassar os tamanhos mínimo e máximo.
A proporção entre o contêiner e o indicador ativo permanece a mesma ao redimensionar o indicador de carregamento.
Reserve indicadores de progresso muito grandes para janelas grandes e extragrandes, como em computadores desktop.

Janelas maiores
À medida que o tamanho do painel ou da janela aumenta, considere aumentar também o tamanho do indicador de carregamento, para que ele permaneça proporcional ao espaço vazio ao seu redor. O indicador de carregamento não deve exceder 240 dp.
Comportamento
Puxar para atualizar
O indicador de carregamento é usado no recurso puxar para atualizar, disponível apenas no Jetpack Compose.
Puxar para atualizar é um recurso do sistema Android que atualiza manualmente o conteúdo da tela por meio de uma ação ou gesto. Ele é usado no início de listas, grades e coleções de cartões, onde o conteúdo mais recente aparece.
O gesto puxar para atualizar funciona melhor com conteúdo dinâmico atualizado com frequência, pois os usuários têm maior probabilidade de ver conteúdo novo após a atualização.
Requisitos de limiar
Para garantir o uso intencional do gesto puxar para atualizar, o indicador de carregamento deve ultrapassar um limiar antes que o app atualize o conteúdo.
O indicador de carregamento permanece visível até que a atualização termine e o novo conteúdo fique visível, ou até que o usuário saia do conteúdo em atualização.