Communitygithub.com

hig-components

Diretrizes de Interface Humana da Apple para todos os componentes, padrões, entradas e tecnologias — desde botões e barras de ferramentas até Dynamic Island, widgets e Inteligência Artificial Generativa.

O que é hig-components?

Este skill fornece um resumo completo e organizado das seções de Componentes, Padrões, Entradas e Tecnologias das Diretrizes de Interface Humana (HIG) da Apple, com referências diretas aos links oficiais. Ele ajuda desenvolvedores e designers a escolher o componente padrão correto, entender as diferenças entre plataformas (iOS, iPadOS, macOS, watchOS, tvOS, visionOS) e aplicar valores concretos (tamanhos, contagens, durações) sem copiar o texto da Apple. O skill é organizado em um roteiro de arquivos markdown que cobrem menus, navegação, apresentação, seleção, layout e organização, conteúdo e status, experiências do sistema, padrões de interação, entradas físicas/digitais e tecnologias específicas. É útil durante a especificação de componentes, design de fluxos, redação de UX em nível de componente ou auditorias de conformidade com as HIG. Juntamente com os skills hig-foundations (fundamentos) e liquid-glass-web (construção da interface), ele forma uma base completa para desenvolvimento alinhado à Apple.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Sthitapragna-009/liqui-hig/tree/HEAD/skills/hig-components

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Componentes, padrões, entradas e tecnologias da HIG

Resumos com paráfrases e links de referência das seções Componentes (64 páginas em 8 grupos), Padrões (25), Entradas (13) e Tecnologias (29) da Apple, sincronizados em 17/11/2026. O texto da Apple não é copiado; cada entrada possui link para a fonte original.

Como usar este skill

  1. Encontre o arquivo correto no roteiro abaixo e leia apenas esse arquivo (eles são longos).
  2. Responda com: o que usar, quando não usar, as diferenças entre plataformas e valores concretos (tamanhos, contagens, durações). Cite o link da Apple.
  3. Recomende o componente padrão antes de qualquer personalizado — componentes padrão fornecem Liquid Glass, acessibilidade, localização e comportamento de plataforma gratuitamente.
  4. Para cores, tipografia, layout, movimento e fundamentos de acessibilidade, use hig-foundations. Para construir o vidro em si (web, Figma, SwiftUI), use liquid-glass-web. Para auditorias, use hig-review.
TópicoLeia
Botões, barras de ferramentas, menus, menus de contexto, menus de edição, botões pop-up / pull-down, folhas de compartilhamento, a barra de menu, ornamentos, ações rápidasreferences/menus-and-actions.md
Barras de abas, barras laterais, campos de busca, barras de escopo e tokens, campos de token, controles de caminhoreferences/navigation-and-search.md
Alertas, folhas de ação, folhas e detentos, popovers, controles de página, visualizações de rolagem e efeitos de borda de rolagem, painéis, janelasreferences/presentation.md
Controles segmentados, controles deslizantes, interruptores, steppers, seletores e seletores de data, campos de texto, teclados, caixas de combinação, poços de cor/imagemreferences/selection-and-input.md
Caixas, coleções, listas e tabelas, rótulos, controles de divulgação, visualizações divididas, visualizações de esboço/coluna, visualizações de aba, lockupsreferences/layout-and-organization.md
Gráficos (marcas, eixos, acessibilidade), visualizações de imagem/texto/web, medidores, indicadores de progresso, anéis de Atividade, indicadores de classificaçãoreferences/content-and-status.md
Atividades ao Vivo e a Ilha Dinâmica, widgets, notificações, controles, Atalhos de App, snippets, complicações, mostradores de relógio, barra de status, Top Shelfreferences/system-experiences.md
Todos os 25 padrões: criar gráficos, feedback, carregamento, inicialização, integração, modalidade, multitarefa, busca, configurações, desfazer, arrastar e soltar, inserir dados, contas, notificações, áudio, hápticos, vídeo, impressão, classificações, treinos…references/patterns.md
Gestos, ponteiro e efeitos de ponteiro no iPad, atalhos de teclado, foco, olhos, Digital Crown, Action Button, Camera Control, Apple Pencil, controles de jogo, controles remotos, sensores de movimento, interações de proximidadereferences/inputs.md
AirPlay, Always On, App Clips, Compra Dentro do App, Apple Pay, AR, CareKitreferences/technologies-a.md
CarPlay, Game Center, Inteligência Artificial Generativa, HealthKitreferences/technologies-b.md
HomeKit, iCloud, Verificador de ID, iMessage, Live Photos, Mac Catalyst, aprendizado de máquina, Mapas, NFC, edição de fotos, ResearchKit, SharePlay, ShazamKit, Entrar com Apple, Siri, Tap to Pay, VoiceOver, Walletreferences/technologies-c.md

Decisões rápidas

Se você precisa…UseNão use
Alternar seções do appBarra de abas (iPhone embaixo, iPad em cima; adapta-se a uma barra lateral)Controle segmentado, barra de ferramentas
Agir na visualização atualBarra de ferramentas (≤3 grupos, uma ação .prominent à direita)Barra de abas
Alternar subvisualizações intimamente relacionadasControle segmentado (≤5 no iPhone)Barra de abas
Interrupção crítica e acionávelAlerta (≤3 botões, verbos específicos, nunca "OK" para ações)Popover, notificação
Escolhas sobre uma ação que a pessoa iniciouFolha de ação (destrutivo primeiro, Cancelar por último)Alerta, menu
Uma tarefa com escopo definidoFolha (Cancelar + Concluído ou Voltar + Concluído; detentos médio/grande)Modais aninhados
Opções pequenas e transitórias ancoradas a um controlePopover (apenas layouts largos)Popover no iPhone
Status contínuo e com limite de tempoAtividade ao Vivo (≤8 h; compacta/mínima/expandida/Tela de Bloqueio)Notificações repetidas
Informação rápida e periódicaWidgetAtividade ao Vivo
Opções mutuamente exclusivas em pouco espaçoBotão pop-upBotão pull-down
Ações relacionadas a um botãoBotão pull-down (≥3 itens)Botão pop-up
Ligar/desligar em uma linha de listaInterruptorInterruptor fora de listas (use um botão de alternância)
Um valor em uma faixaMedidor (padrão ou capacidade)Anéis de Atividade (reservado)
Progresso de duração conhecidaBarra ou anel determinadosSpinner

Lista de "nunca" absolutos

  • Nunca redesenhe as marcas ou botões da Apple: botão/marca Apple Pay, Entrar com Apple, Adicionar ao Apple Wallet, ícones AirPlay/HomeKit/Apple Health, glifo AR, Códigos App Clip, anéis de Atividade. Use as APIs ou downloads da Apple.
  • Nunca use anéis de Atividade (ou anéis triplos semelhantes) para nada além de Movimentar/Exercitar/Ficar em Pé.
  • Nunca oculte ou desabilite abas; nunca faça um botão destrutivo ser o primário/padrão; nunca coloque mais de um alerta na tela.
  • Nunca exiba anúncios em Atividades ao Vivo, widgets, App Clips ou respostas da Siri.
  • Nunca use notificações urgentes (Time Sensitive) para marketing.
  • Nunca preencha senhas automaticamente nem peça uma senha após Entrar com Apple.
  • Nunca automatize ações irreversíveis com IA generativa sem confirmação.

Habilidades Relacionadas