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

  <info>
    <credit type="author">
      <name>Allan Day</name>
      <email>aday@gnome.org</email>
    </credit>

    <link type="guide" xref="ui-elements"/>
    <uix:thumb mime="image/svg" src="figures/ui-elements/button-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</mal:years>
    </mal:credit>
  </info>

<title>Botões de menu</title>

<p>Um menu que é aberto ao pressionar um botão. Podem ser incorporados em uma série de widgets contêineres, como barras de cabeçalho, barras de ação, barras laterais ou barras de ferramentas. <link xref="header-bar-menus">Menus de barra de cabeçalho</link> são o exemplo mais comum.</p>

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

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

<p>Um botão de menu é uma maneira de apresentar ações ou opções adicionais. São apropriados quando é necessário fornecer ações secundárias ou opções que não são incorporadas confortavelmente em sua interface de usuário primária. Existem dois tipos primários de botão de menu:</p>

<list>
<item><p><em style="strong">Menus de transborde</em>: aqui, o botão de menu serve como uma extensão de um conjunto existente de controles. Isto pode ser visto no exemplo de <link xref="header-bar-menus">menus de barra de cabeçalho</link>, onde o menu age como uma continuação dos controles apresentados na própria barra de cabeçalho. Esta abordagem pode ser aplicada a outros contêineres, como barras de ação. Esses botões de menu genéricos podem conter uma variedade de itens diversos que estão relacionados ao contexto do menu.</p></item>
<item><p><em style="strong">Menus de propósito único</em>: estes fornecem ações e/ou opções para uma área específica de funcionalidade. Da mesma maneira que uma barra de menu apresenta uma série de menus de diferentes tópicos, botões de menu individuais podem apresentar grupos de funcionalidade, como edição, mudança de visão, ou fornecimento de controles de navegação.</p></item>
</list>

<p>Menus provide a clear and consistent way to present diverse sets of actions and settings. At the same time, a popover with embedded controls, like buttons, sliders, spin buttons, lists and text entries, can provide a more effective interface for many tasks.</p>

<list>
<item><p>Evaluate each function within a button menu, in order to decide whether it would be better served by a different <link xref="ui-elements">user interface element</link>. While simple actions or settings can be effectively represented by menu items, others cannot. In particular, sliders, spin buttons, switches and text entries provide functionality that cannot be easily reproduced with a menu. Likewise, some entries might be better represented as icons rather than text - in which case, buttons could be more appropriate than a menu.</p></item>
<item><p>If a menu button contains a small number of items that can be more effectively represented as a group of controls, a popover containing different interface elements can be a more interesting and efficient user interface. However, this approach can easily become over-complex for larger and more diverse button menus.</p></item>
<item><p>A menu button can be combined with a small number of other interface elements, such as buttons, sliders and switches (see example below). This can enable some menu items to be presented in a more space-efficient manner, or to provide interactions that are not possible with a standard menu. However, be careful not to mix too many types of control or make the menu too complex in the process.</p></item>
</list>

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

</section>

<section id="general-guidelines">
<title>General guidelines</title>

<list>
<item><p>Each context - whether it is a view or delineated area of your interface - should only include one generic button menu.</p></item>
<item><p>Ensure that single purpose button menus are effectively labelled. While an icon is more compact, only use them when they will be commonly understood by your users. The <link xref="icons-and-artwork">icon usage guidelines</link> provide more advice on this.</p></item>
<item><p>Single purpose buttons should be clearly and consistently defined. Their menu items should have an obvious relationship with the overall purpose of the menu.</p></item>
<item><p>While multiple button menus can be used simultaneously, be careful about introducing too many disclosure points into your user interface. The more of these that you introduce, the harder it will be for users to find the controls they need, and human error will be increased.</p></item>
</list>

</section>

</page>
