Apple HIG: Componentes de Apresentação

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

1. Alertas: com moderação, para situações críticas. Erros que precisam de atenção, confirmações de ações destrutivas ou informações que exigem reconhecimento. Eles interrompem o fluxo e exigem uma resposta.

2. Sheets: tarefas focadas que mantêm o contexto. Deslizam da borda (ou se anexam a uma janela no macOS). Use para criar itens, editar configurações, formulários de várias etapas.

3. Popovers: não modais no iPad e Mac. Aparecem ao lado do elemento de gatilho, dispensados ao tocar fora. Para informações adicionais, opções ou controles sem dominar a tela.

4. Action sheets: escolha entre ações. Apresentam-se ao escolher entre várias ações, especialmente se uma for destrutiva. iPhone: desliza de baixo para cima. iPad: aparece como popovers.

5. Minimize interrupções. Antes de recorrer a um modal, considere a apresentação inline ou torne a ação reversível em vez disso.

6. Texto de alerta conciso e acionável. Título descritivo curto. Mensagem breve, se necessário. Rótulos de botões devem ser verbos específicos ("Excluir", "Salvar"), não "OK".

7. Marque ações destrutivas claramente. Estilo de botão destrutivo (texto vermelho). Coloque botões destrutivos onde os usuários são menos propensos a tocar reflexivamente.

8. Forneça uma opção de cancelar para alertas e action sheets com várias ações. Em action sheets, o cancelamento aparece na parte inferior, separado.

9. Entrada de dígitos: focada e acessível. Campos de entrada de tamanho apropriado, avanço automático entre os dígitos, suporte para colar e preenchimento automático.

10. Adapte a apresentação à plataforma. A mesma interação pode usar componentes diferentes no iPhone, iPad, Mac e visionOS.

Índice de Referência

Formato de Saída

1. Tipo de apresentação recomendado com justificativa e por que alternativas são menos adequadas.
2. Diretrizes de conteúdo -- título, mensagem, rótulos de botões de acordo com as regras de tom e brevidade da Apple.
3. Comportamento de dispensa -- como o usuário dispensa e o que acontece (salvar, descartar, cancelar).
4. Alternativas -- quando o cenário pode não precisar de um modal (feedback inline, desfazer, divulgação progressiva).

Perguntas a Fazer

1. Que informação ou ação a apresentação precisa?
2. Bloqueante ou não bloqueante?
3. Quais plataformas?
4. Com que frequência isso aparece?

Habilidades Relacionadas

• hig-components-menus -- Botões e itens de barra de ferramentas que acionam apresentações
• hig-components-controls -- Controles de entrada dentro de sheets e popovers
• hig-components-search -- Pesquisa e navegação dentro de visualizações apresentadas
• hig-patterns -- Modalidade, interrupções, gerenciamento de fluxo do usuário
• hig-foundations -- Cor, tipografia, layout para componentes de apresentação

Construído por Raintree Technology · Mais ferramentas para desenvolvedores

Quando Usar

Esta habilidade é aplicável para executar o fluxo de trabalho ou ações descritas na visão geral.

Exemplo

Solicitação do usuário:

Use @hig-components-dialogs para esta tarefa: Orientação da Apple HIG para componentes de apresentação, incluindo alertas, action sheets, popovers, sheets e visualizações de entrada de dígitos.

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 especializada.
• Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.