Apple HIG: Controles de Seleção e Entrada

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. Estado atual claro. Os usuários devem sempre ver o que está selecionado. Chaves mostram ligado/desligado, controles segmentados destacam o segmento ativo, seletores exibem a seleção atual.

2. Prefira controles padrão do sistema. Controles integrados fornecem consistência e acessibilidade. Controles personalizados introduzem uma curva de aprendizado e podem quebrar recursos de assistência.

3. Chaves para estados binários. Ligado ou desligado. Em telas no estilo Configurações, as alterações entram em vigor imediatamente. Em formulários modais, as alterações são confirmadas ao confirmar.

4. Controles segmentados para opções mutuamente exclusivas. 2-5 itens, importância aproximadamente igual, rótulos curtos.

5. Sliders para valores contínuos. Quando a entrada numérica precisa não é crítica. Forneça rótulos min/max ou ícones para os pontos finais do intervalo.

6. Seletores para longas listas de opções. Muitas opções para um controle segmentado. Funciona bem para datas, horários, dados estruturados.

7. Incrementadores para ajustes pequenos e precisos. Incrementar/decrementar em passos fixos. Exiba o valor atual ao lado do incrementador com limites razoáveis de min/max.

8. Campos de texto para entrada curta de linha única. Visualizações de texto para várias linhas. Configure o tipo de teclado para corresponder à entrada esperada (e-mail, URL, número).

9. Caixas de combinação: entrada de texto + lista de seleção. macOS. Digite um valor ou escolha em uma lista predefinida quando valores personalizados forem válidos.

10. Campos de token: valores discretos como tokens visuais. macOS. Para destinatários de e-mail, tags ou coleções de itens discretos.

11. Medidores e indicadores de classificação exibem valores. Medidores mostram um valor dentro de um intervalo. Indicadores de classificação mostram classificações (geralmente estrelas). Apenas para exibição; use variantes interativas para entrada.

Índice de Referência

Formato de Saída

1. Recomendação de controle com justificativa e por que alternativas são menos adequadas.
2. Gerenciamento de estado -- como o controle comunica o estado atual e se as alterações se aplicam imediatamente ou após confirmação.
3. Abordagem de validação -- quando mostrar erros e como comunicar regras.
4. Acessibilidade -- rótulos, traits, dicas para VoiceOver.

Perguntas a Fazer

1. Que tipo de dados? (Booleano, escolha de conjunto fixo, numérico, texto livre?)
2. Quantas opções?
3. Quais plataformas? (Caixas de combinação e campos de token são apenas para macOS)
4. Tela de configurações ou formulário inline?

Habilidades Relacionadas

• hig-components-menus -- Botões e botões de menu que complementam controles de seleção
• hig-components-dialogs -- Folhas e popovers contendo formulários
• hig-components-search -- Campos de pesquisa que compartilham padrões de entrada de texto
• hig-inputs -- Interações de teclado, ponteiro e gestos com controles
• hig-foundations -- Tipografia, cor, layout para estilo de controle

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:

…