hig-components-status
Faz seu agente entender como usar componentes de status e progresso da Apple, como indicadores de progresso e anéis de atividade. Isso ajuda a mostrar o andamento de tarefas de forma clara.
O que ela faz
Ajuda a decidir qual tipo de indicador visual (como barras de progresso ou anéis) usar em aplicativos, seguindo as regras de design da Apple. Garante que os usuários entendam o que está acontecendo, seja um download ou um objetivo de exercício.
Quando usar
- ✓Ao criar um app e precisar mostrar o andamento de uma tarefa.
- ✓Ao decidir se usa uma barra de progresso ou um círculo giratório.
- ✓Ao projetar como os objetivos de fitness (passos, exercícios) serão mostrados no app.
Exemplo do que pedir para a IA
“Preciso mostrar o progresso de um download no meu app. Qual indicador visual devo usar segundo as diretrizes da Apple?”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
A IA analisa a situação (se o tempo é conhecido ou não) e as diretrizes de design da Apple para recomendar o melhor indicador visual. Ela também pode dar dicas sobre como animá-lo e torná-lo acessível.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add sickn33/agentic-awesome-skills --skill hig-components-statusOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/hig-components-status/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Apple HIG: Componentes de Status
Verifique .claude/apple-design-context.md antes de fazer perguntas. Use o contexto existente e peça apenas informações que ainda não foram abordadas.
Princípios Chave
Indicadores de Progresso
Mostre o progresso para operações que duram mais de um ou dois segundos.
Determinado quando a duração/porcentagem é conhecida. Uma barra de progresso que se preenche dá aos usuários uma noção clara do trabalho restante. Use para downloads, uploads ou qualquer processo mensurável.
Indeterminado quando a duração é desconhecida. Um spinner comunica que o trabalho está acontecendo sem prometer um prazo. Use para requisições de rede imprevisíveis.
Prefira barras de progresso a spinners. O progresso determinado parece mais rápido e confiável.
Coloque os indicadores onde o conteúdo aparecerá. Progresso inline perto da área de conteúdo, não modal ou distante.
Não empilhe vários indicadores. Agregue operações simultâneas em uma única representação ou mostre a mais relevante.
Barras de Status
Não oculte a barra de status sem um bom motivo. Reserve a ocultação para experiências imersivas (mídia em tela cheia, jogos, RA).
Combine o estilo da barra de status com seu conteúdo. Claro ou escuro para contraste adequado.
Respeite as áreas seguras. Nenhum conteúdo interativo atrás da barra de status.
Restaure prontamente ao sair de contextos imersivos.
Anéis de Atividade
Anéis de atividade são para metas de Movimento, Exercício e Ficar em Pé. Não reutilize a metáfora do anel para dados não relacionados.
Respeite as convenções de cores dos anéis. Vermelho (Movimento), verde (Exercício), azul (Ficar em Pé) são fortemente associados ao Apple Fitness.
Use as APIs do HealthKit para dados de atividade em vez de rastreamento manual.
Celebre as conclusões com animação e feedback tátil quando os anéis se fecharem.
Índice de Referência
| Referência | Tópico | Conteúdo chave |
|---|---|---|
| progress-indicators.md | Barras de progresso e spinners | Determinado, indeterminado, posicionamento inline, duração |
| status-bars.md | Barra de status do iOS/iPadOS | Informações do sistema, visibilidade, estilo, áreas seguras |
| activity-rings.md | Anéis de atividade do watchOS | Movimento/Exercício/Ficar em Pé, HealthKit, rastreamento de fitness, cor |
Formato de Saída
- Recomendação do tipo de indicador com justificativa (determinado vs. indeterminado).
- Orientação de tempo e animação -- limites de duração, estilo de animação, transições.
- Acessibilidade -- anúncios de progresso do VoiceOver, atualizações de região ativa.
- Comportamento específico da plataforma em todas as plataformas de destino.
Perguntas a Fazer
- A duração é conhecida ou desconhecida?
- Quais plataformas?
- Quanto tempo a operação leva tipicamente?
- Indicador no nível do sistema ou dentro do aplicativo?
Habilidades Relacionadas
- hig-components-system -- Widgets e complicações exibindo progresso ou status
- hig-inputs -- Gestos que acionam estados de progresso (puxar para atualizar)
- hig-technologies -- HealthKit para dados de anéis de atividade; VoiceOver para anúncios de progresso
Construído por Raintree Technology · Mais ferramentas para desenvolvedores
Quando Usar
Esta habilidade é aplicável para executar o fluxo de trabalho ou as ações descritas na visão geral.
Exemplo
Solicitação do usuário:
Use @hig-components-status para esta tarefa: Orientação da Apple HIG para componentes de UI de status e progresso, incluindo indicadores de progresso, barras de status e anéis de atividade.
Limitações
- Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
- Não trate a saída como substituta para validação específica do ambiente, testes ou revisão de especialistas.
- Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem faltando.
Perguntas frequentes
O que são 'indicadores de progresso'?
São elementos visuais como barras que enchem ou círculos que giram, mostrando que algo está sendo processado ou carregado.
Quando usar uma barra de progresso em vez de um círculo giratório?
Prefira a barra de progresso quando você sabe quanto tempo falta ou qual a porcentagem concluída. O círculo giratório é para quando o tempo é imprevisível.
O que são 'anéis de atividade'?
São os círculos coloridos (vermelho, verde, azul) usados nos relógios da Apple para acompanhar metas de movimento, exercício e para.
Detalhes
Descrição original do autor
Apple HIG guidance for status and progress UI components including progress indicators, status bars, and activity rings.
Popularidade
- Estrelas no GitHub
- 48 mil
- Posição no ranking
- #3202
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
00-andruia-consultant
Ajuda seu agente a iniciar ou melhorar projetos de IA. Ele analisa código, sugere ferramentas e cria planos de ação em espanhol.
sickn33/agentic-awesome-skills
007
Faz seu agente realizar auditorias de segurança e modelagem de ameaças. É útil para proteger projetos contra ataques e vulnerabilidades.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Ajuda seu agente a criar ou melhorar ferramentas de IA. Ele define como as ferramentas funcionam, escreve a documentação e valida a estrutura.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Faz seu agente criar um resumo sobre um setor específico. É útil para entender o contexto, regras, padrões de uso e riscos de um projeto, usando fontes confiáveis.
sickn33/agentic-awesome-skills
Skills parecidas
accessibility
Ajuda seu agente a criar interfaces que todos possam usar. Garante que sites e aplicativos funcionem bem para pessoas com deficiência, como cegos ou com mobilidade reduzida.
affaan-m/ECC
design-system
Ajuda seu agente a criar um sistema de design a partir de um código existente. Ele extrai informações visuais e verifica a consistência, gerando um relatório e uma prévia interativa.
affaan-m/ECC
liquid-glass-design
Ajuda seu agente a criar interfaces de usuário com efeito 'Liquid Glass' para iOS. Permite adicionar efeitos visuais dinâmicos e interativos em SwiftUI e UIKit.
affaan-m/ECC