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

  <info>
    <link type="guide" xref="patterns#primary"/>
    <desc>El menú principal de la aplicación, representado por 3 barras horizontales apiladas</desc>
    <credit type="author">
      <name>Allan Day</name>
      <email>aday@gnome.org</email>
    </credit>
    <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>Daniel Mustieles</mal:name>
      <mal:email>daniel.mustieles@gmail.com</mal:email>
      <mal:years>2011 - 2021</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Alex Puchades</mal:name>
      <mal:email>alex94puchades@gmail.com</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Nicolás Satragno</mal:name>
      <mal:email>nsatragno@gnome.org</mal:email>
      <mal:years>2013</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Benjamín Valero Espinosa</mal:name>
      <mal:email>benjavalero@gmail.com</mal:email>
      <mal:years>2011</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Jorge González</mal:name>
      <mal:email>jorgegonz@svn.gnome.org</mal:email>
      <mal:years>2009</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Rosa Elena Pérez</mal:name>
      <mal:email>rozydicemiau@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>Oscar Rafael Arachi</mal:name>
      <mal:email>arachi910@gmail.com</mal:email>
      <mal:years>2014 - 2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Miguel Ajuech</mal:name>
      <mal:email>miguel.ann.28@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>Adrián Pérez Domínguez</mal:name>
      <mal:email>adrian@aztli.org</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Celina Osorio Ochoa</mal:name>
      <mal:email>chelinoska@gmail.com</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Dario Amigon Espinoza</mal:name>
      <mal:email>daramigon@gmail.com</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Yenisei Ramírez Pérez</mal:name>
      <mal:email>yeniseirape@gmail.com</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>José Roberto Ramíres Mendoza</mal:name>
      <mal:email>aczella@gmail.com</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Bernardo Sánchez Romero</mal:name>
      <mal:email>b.sanchez.rom@gmail.com</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Emmanuel Márquez Juárez</mal:name>
      <mal:email>resident3333@gmail.com</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>David Romero Serrano</mal:name>
      <mal:email>lemi136@hotmail.com</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Omar Garcia Guzman</mal:name>
      <mal:email>garciag.omar91@gmail.com</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Edilberto Huerta Niño</mal:name>
      <mal:email>edilberto.huerta0290@gmail.com</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  </info>

<title>Menús primarios</title>

<media type="image" mime="image/svg" src="figures/patterns/primary-menu.svg"/>

<p>Los menús principales son un patrón de diseño estándar que se encuentra en la mayoría de las aplicaciones. Están etiquetados con el icono de menú (llamado <code>menu-open</code>) y contienen los elementos de menú de nivel superior para la aplicación. Esto puede incluir elementos estándar como <gui>Preferencias</gui>, <gui>Ayuda</gui> y <gui>Acerca de la aplicación</gui>, así como otros elementos específicos de la aplicación.</p>


<section id="when-to-use">
<title>Cuándo usarlas</title>

<p>La mayoría de las aplicaciones tienen menús primarios, ya que son la ubicación estándar para <gui>Acerca de la aplicación</gui>, que se espera que tenga cada aplicación.</p>

</section>

<section id="guidance">
<title>Dirección</title>

<p>Los menús principales generalmente se colocan en el lado derecho de la barra de cabecera. Sin embargo, hay dos variaciones en esta regla:</p>

<list>
<item><p>Si la aplicación incorpora navegación en la ventana, con una ubicación de nivel superior y subpáginas, el menú principal solo debe colocarse en el nivel superior: las subpáginas pueden incluir un menú secundario <link xref="secondary-menús"> </link>, si se requiere un menú.</p></item>
<item><p>Cuando se usa en combinación con una <link xref="sidebar-lists">lista en la barra lateral</link>, el menú principal debe colocarse encima de la lista de la barra lateral a la derecha. Si se necesita un menú para los elementos que se muestran en el lado del contenido de la ventana, se puede usar un <link xref="secundario-menús">menú secundario</link>.</p></item>
</list>

<p>Otras guías:</p>

<list>
<item><p>Los menús primarios pueden contener elementos tanto para la ventana o vista actual, como para la aplicación en su conjunto. Esto los diferencia de <link xref="secundario-menús">menús secundarios</link>, que solo contienen elementos de menú que se relacionan con una vista o elemento específico.</p></item>
<item><p>Sigua las <link xref="menus">directrices estándar para menús</link> al decidir sobre el contenido y el orden de un menú primario.</p></item>
<item><p>Un menú primario está dentro de una <link xref="popovers">ventana emergente</link>. Como tal, un menú primario puede incluir varios controles, como un grupo de botones.</p></item>
</list>

</section>

<section id="standard-menu-items">
<title>Objetos estándar del menú</title>

<p>Las siguientes opciones son elementos estándar de un menú primario y se deben colocar en un grupo al final el menú:</p>

<table>
<tr>
<td><p><gui>Preferencias</gui></p></td>
<td><p>Abre el diálogo de preferencias de la aplicación, si existe.</p></td>
</tr>
<tr>
<td><p><gui>Atajos del teclado</gui></p></td>
<td><p>Abre la ventana de atajos del teclado de la aplicación, si existe.</p></td>
</tr>
<tr>
<td><p><gui>Ayuda</gui></p></td>
<td><p>Abre la documentación del usuario de la aplicación en el programa de <app>Ayuda</app>.</p></td>
</tr>
<tr>
<td><p><gui>Acerca de la aplicación</gui></p></td>
<td><p>Abre el cuadro de diálogo sobre la aplicación. Este elemento debe incluir el nombre de la aplicación, como <gui>Acerca de las fotos</gui> o <gui>Acerca de la calculadora</gui>. Cada menú principal debe incluir este elemento.</p></td>
</tr>
</table>

<p>Los menús primarios no deben incluir elementos de menú para cerrar o salir: las ventanas ya se pueden cerrar con el botón Cerrar en la barra de encabezado, y puede ser ambiguo a qué se refiere un elemento de menú de cierre. Los usuarios no diferencian fácilmente entre salir y cerrar, y por lo tanto puede ser engañoso.</p>

</section>

<section id="api-reference">
<title>Referencia de la API</title>

<list>
<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/GtkPopoverMenu.html">GtkPopoverMenu</link></p></item>
</list>

</section>

</page>
