<?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" 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>
    <license xmlns="http://projectmallard.org/1.0/" href="http://creativecommons.org/licenses/by-sa/4.0/">

  <p>This work is licensed under a
  <link href="http://creativecommons.org/licenses/by-sa/4.0/">Creative
  Commons Attribution-Share Alike 4.0 International License</link>.</p>

</license>
  <credit type="translator copyright"><name>Daniel Mustieles</name><email>daniel.mustieles@gmail.com</email><years>2011 - 2021</years></credit><credit type="translator copyright"><name>Alex Puchades</name><email>alex94puchades@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>Nicolás Satragno</name><email>nsatragno@gnome.org</email><years>2013</years></credit><credit type="translator copyright"><name>Benjamín Valero Espinosa</name><email>benjavalero@gmail.com</email><years>2011</years></credit><credit type="translator copyright"><name>Jorge González</name><email>jorgegonz@svn.gnome.org</email><years>2009</years></credit><credit type="translator copyright"><name>Rosa Elena Pérez</name><email>rozydicemiau@gmail.com</email><years>2014</years></credit><credit type="translator copyright"><name>Oscar Rafael Arachi</name><email>arachi910@gmail.com</email><years>2014 - 2015</years></credit><credit type="translator copyright"><name>Miguel Ajuech</name><email>miguel.ann.28@gmail.com</email><years>2014</years></credit><credit type="translator copyright"><name>Adrián Pérez Domínguez</name><email>adrian@aztli.org</email><years>2015</years></credit><credit type="translator copyright"><name>Celina Osorio Ochoa</name><email>chelinoska@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>Dario Amigon Espinoza</name><email>daramigon@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>Yenisei Ramírez Pérez</name><email>yeniseirape@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>José Roberto Ramíres Mendoza</name><email>aczella@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>Bernardo Sánchez Romero</name><email>b.sanchez.rom@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>Emmanuel Márquez Juárez</name><email>resident3333@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>David Romero Serrano</name><email>lemi136@hotmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>Omar Garcia Guzman</name><email>garciag.omar91@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>Edilberto Huerta Niño</name><email>edilberto.huerta0290@gmail.com</email><years>2015</years></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>
