<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:uix="http://projectmallard.org/experimental/ui/" type="topic" id="menus" xml:lang="pt-BR">

  <info>
    <credit type="author">
      <name>Allan Day</name>
      <email>aday@gnome.org</email>
    </credit>
    <credit>
      <name>Calum Benson</name>
    </credit>
    <credit>
      <name>Adam Elman</name>
    </credit>
    <credit>
      <name>Seth Nickell</name>
    </credit>
    <credit>
      <name>Colin Robertson</name>
    </credit>

    <link type="guide" xref="ui-elements"/>
    <uix:thumb mime="image/svg" src="figures/ui-elements/menu.svg"/>

    <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Georges Neto</mal:name>
      <mal:email>georges.stavracas@gmail.com</mal:email>
      <mal:years>2014,</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Rafael Fontenelle</mal:name>
      <mal:email>rafaelff@gnome.org</mal:email>
      <mal:years>2017-2021</mal:years>
    </mal:credit>
  </info>

<title>Menus</title>

<p>Um menu é uma lista de ações e/ou opções que é revelada pressionando um título ou botão. No caso dos menus de contexto, o menu é aberto através de uma ação secundária (como clique secundário com um mouse ou pressionada longa em uma tela de toque) em um item de conteúdo.</p>

<media type="image" mime="image/svg" src="figures/ui-elements/menu.svg"/>

<section id="when-to-use">
<title>Quando usar</title>

<p>Os menus podem aparecer como parte de uma <link xref="menu-bars">barra de menu</link>, como menus de contexto (veja <link xref="selection-mode">modo de seleção</link>) ou como parte de um <link xref="button-menus">menu do botão</link>. Consulte as páginas relevantes para obter conselhos sobre quando usar esses elementos.</p>

</section>

<section id="size-and-structure">
<title>Tamanho e estrutura</title>

<p>Os menus devem conter entre três e 12 itens de nível superior. Se um menu contiver mais de 12 itens, avalie se todos os itens são necessários e pertencem ao menu. Se você não conseguir reduzir o tamanho, submenus podem ser usados. No entanto, eles devem ser evitados se possível, pois são fisicamente difíceis de usar.</p>

<p>Os submenus devem conter entre três e seis itens e nunca devem conter outros submenus.</p>

<p>Organize itens de menu semelhantes em grupos usando divisores – isso os tornará mais fáceis de entender e mais rápidos de usar. Ao criar grupos:</p>

<list>
<item><p>Ordene grupos e itens grupais de forma lógica, seja por importância, ordem de tarefa ou frequência de uso esperada. Os itens na parte superior e inferior do menu são mais visíveis e facilmente direcionados, então reserve esses locais para funcionalidades particularmente importantes ou interessantes.</p></item>
<item><p>Coloque grupos de itens individuais na parte superior ou inferior do menu, ou agrupe-os com outros itens individuais.</p></item>
<item><p>Não misture diferentes tipos de itens de menu dentro de cada grupo – as ações, a caixa de seleção e os itens dos botões de opção devem estar separados.</p></item>
</list>

</section>

<section id="general-guidelines">
<title>Diretrizes gerais</title>

<list>
<item><p>Forneça uma <link xref="keyboard-input#access-keys">tecla de acesso</link> para cada item do menu. Você pode usar a mesma tecla de acesso em diferentes menus no seu aplicativo, mas evite duplicar as chaves de acesso no mesmo menu. Note que, ao contrário de outros controles, uma vez que um menu é exibido, suas chaves de acesso podem ser usadas apenas digitando a letra; não é necessário pressionar a tecla Alt ao mesmo tempo.</p></item>
<item><p>Rotule itens do menu com verbos para comandos e adjetivos para configurações, usando <link xref="writing-style#capitalization">maiusculização de título</link>.</p></item>
<item><p>Use <link xref="writing-style#ellipses">reticências</link> quando um item de menu exige mais entrada do usuário para completar uma ação.</p></item>
<item><p>Duas ações vinculadas podem ser combinadas em um único item de menu, alterando o rótulo quando o item for selecionado. Por exemplo, um item <gui>Play</gui> pode mudar para <gui>Pause</gui>. No entanto, use apenas esse tipo de item quando as ações são opostos lógicos que são óbvias para os usuários. Da mesma forma, não use esta técnica para configurações – use caixas de seleção ou botões de opção em vez disso.</p></item>
</list>

</section>

<section id="api-reference">
<title>Referência de API</title>

<list>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkMenu.html">GtkMenu</link></p></item>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkMenuBar.html">GtkMenuBar</link></p></item>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkMenuButton.html">GtkMenuButton</link></p></item>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkMenuItem.html">GtkMenuItem</link></p></item>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkRadioMenuItem.html">GtkRadioMenuItem</link></p></item>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkCheckMenuItem.html">GtkCheckMenuItem</link></p></item>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkSeparatorMenuItem.html">GtkSeparatorMenuItem</link></p></item>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkPopoverMenu.html">GtkPopoverMenu</link></p></item>
</list>
</section>

</page>
