hig-components-menus

Visão geral da skill hig-components-menus

hig-components-menus é uma skill de orientação do Apple HIG para projetar menus e superfícies de comando acionadas por botões em todas as plataformas Apple. Use a skill hig-components-menus quando precisar de दिशा prática para menus, menus de contexto, menus do Dock, menus de edição, barra de menus, toolbars, botões de ação, botões pop-up, botões pull-down, controles de disclosure ou botões padrão.

Essa skill é mais indicada para designers de UI, product designers, engenheiros de frontend e agentes de IA que geram orientação de interface no estilo Apple. O trabalho real aqui não é “o que é um menu?”, e sim “qual controle deve entrar aqui, o que ele deve conter e como deve se comportar para seguir as convenções da Apple e continuar previsível”.

O que ela ajuda você a decidir

O guia hig-components-menus é útil quando a pergunta de design é sobre posicionamento de comandos, e não apenas sobre acabamento visual. Ele ajuda a escolher entre ações na toolbar, comandos na barra de menus, menus de contexto e controles inline; evitar sobrecarregar menus com itens de baixo valor; e manter rótulos, ordem e agrupamento alinhados às expectativas da plataforma.

Por que vale a pena instalar

Em comparação com um prompt genérico, hig-components-menus oferece cobertura estruturada do HIG e referências cruzadas para temas próximos, como botões, menus de contexto, menus de edição e toolbars. Isso o torna mais forte para decisões que dependem de fronteiras entre componentes e comportamento, especialmente quando você precisa de consistência específica da Apple em vez de orientação ampla de UI.

Casos de melhor encaixe e de mau encaixe

Instale hig-components-menus se você estiver projetando para plataformas Apple ou traduzindo intenção de produto para uma UI alinhada ao Apple HIG. Evite usar se você precisa de código de framework, detalhes de implementação de componentes ou sistemas de design que não sejam da Apple; essa skill trata de orientação de design e escolhas de interação, não de APIs de SDK.

Como usar a skill hig-components-menus

Instale e abra o arquivo de entrada certo

Use o caminho de instalação de hig-components-menus no diretório e comece por SKILL.md. Os arquivos de apoio mais úteis são as páginas em references/, porque elas separam as famílias principais de componentes em recortes fáceis de ler. Para uma triagem rápida, leia primeiro references/menus.md, references/buttons.md, references/context-menus.md e references/toolbars.md.

Dê à skill um problema concreto de UI

O uso de hig-components-menus funciona melhor quando você descreve a tela, a plataforma e o objetivo do usuário, em vez de pedir conselhos abstratos de design. Um bom input nomeia a origem do comando, o contexto e a restrição:

• “Projete a superfície de comandos para um editor de documentos no macOS com 8 ações frequentes e 12 ações ocasionais.”
• “Delete, duplicate e share devem ficar na toolbar, no menu de contexto ou na barra de menus no iPadOS?”
• “Como um menu de contexto no estilo Apple deve diferir para texto selecionado versus um item de arquivo?”

Se você disser apenas “projete meu menu”, a skill precisa adivinhar o modelo de interação e será menos útil.

Leia as referências na ordem da decisão

Um guia prático de hig-components-menus normalmente começa pelo componente principal e depois afunila para casos especiais. Leia references/menus.md para regras de rótulo e organização, references/context-menus.md para relevância e quantidade de itens, e references/toolbars.md quando estiver decidindo o que precisa ficar sempre visível. Use references/the-menu-bar.md para a arquitetura de comandos no macOS e references/edit-menus.md quando houver edição de texto envolvida.

Use um fluxo de trabalho que começa pela decisão

Peça primeiro à skill para definir a escolha do controle, depois o conteúdo e, por fim, a ordem. Um formato de prompt eficiente é:

1. Plataforma: macOS, iPadOS, iOS ou visionOS
2. Objeto: seleção, documento, mensagem, arquivo ou comando em nível de app
3. Conjunto de ações: primárias, secundárias, destrutivas e indisponíveis
4. Restrição: espaço, descobribilidade, suporte a teclado ou consistência

Essa estrutura ajuda a skill hig-components-menus a devolver uma resposta mais precisa sobre onde os comandos devem ficar e o que deve ser ocultado, agrupado ou promovido.

Perguntas frequentes sobre a skill hig-components-menus

hig-components-menus serve só para menus?

Não. A skill hig-components-menus cobre menus e também os padrões adjacentes de botões que controlam o acesso a comandos, incluindo action buttons, botões pop-up, botões pull-down, disclosure controls, toolbars e botões padrão. Esse escopo mais amplo é útil porque muitas decisões de UI da Apple dependem de a ação aparecer como botão, item de menu ou ambos.

Quando eu não devo usar essa skill?

Não use hig-components-menus se sua dúvida for principalmente sobre branding visual, motion personalizado ou código do componente. Ela também não é a melhor opção se você estiver projetando para um ecossistema que não seja da Apple e não precisar do comportamento do Apple HIG. Para detalhes de implementação, combine-a com a documentação do framework.

Em que ela é diferente de um prompt normal?

Um prompt comum pode sugerir uma estrutura de menu, mas a skill hig-components-menus é calibrada para tradeoffs específicos da Apple: hierarquia de comandos, convenções da plataforma, densidade de menu e quando preferir ações visíveis em vez de ações ocultas. Isso normalmente reduz a adivinhação quando você precisa de uma UI que pareça nativa em dispositivos Apple.

Ela é amigável para iniciantes?

Sim, desde que você consiga descrever a tela e as ações envolvidas. Você não precisa ter conhecimento profundo de HIG para começar a usar hig-components-menus, mas precisa de contexto suficiente para dizer à skill o que o usuário está fazendo e quais comandos estão disponíveis. Quanto melhor o cenário, melhor a orientação.

Como melhorar a skill hig-components-menus

Forneça inventários de ações, não apenas objetivos

O maior ganho de qualidade vem de listar ações reais. Em vez de “torne isso mais fácil”, dê à skill o conjunto de comandos e marque quais ações são frequentes, raras, destrutivas ou contextuais. Isso permite que hig-components-menus avalie se uma toolbar, um menu ou um menu de contexto é mais apropriado e se um item deve ficar oculto ou exposto.

Declare explicitamente a plataforma e o gatilho

Um padrão de menu que funciona no macOS pode estar errado no iOS ou no iPadOS. Diga se o usuário aciona o comando com clique, clique com o botão direito, toque e segure, teclado ou navegação pela barra de menus. Isso importa porque o guia hig-components-menus é sensível aos caminhos de interação específicos de cada plataforma, especialmente para menus de contexto e menus de edição.

Peça tradeoffs, não só uma resposta final

Se a primeira resposta parecer genérica, itere perguntando por que um comando pertence a um lugar e não a outro. Por exemplo: “Quais itens devem sair do menu de contexto e ir para a toolbar, e qual é o custo de descobribilidade?” Isso gera um uso mais útil de hig-components-menus, porque a saída passa a apoiar decisão, e não apenas a listar opções.

Fique atento aos modos comuns de falha

Os erros mais comuns são menus abarrotados, comandos duplicados sem prioridade clara e ações centrais escondidas atrás de gestos secundários. Use a skill para checar esses problemas cedo. Se a primeira saída parecer densa demais, peça um conjunto reduzido de itens de alto valor e uma separação mais rígida entre ações primárias e secundárias.