<?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="cs">

  <info>
    <link type="guide" xref="patterns#primary"/>
    <desc>Hlavní nabídka aplikace představovaná třemi vodorovnými čarami</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"/>
  </info>

<title>Hlavní nabídky</title>

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

<p>Hlavní nabídky jsou standardním návrhovým vzorem, který najdete ve většině aplikací. Jsou označeny ikonou nabídky (nazvané <code>menu-open</code>) a obsahují položky nejvyšší úrovně pro aplikaci. Může jít o standardní položky, jako jsou <gui>Prferences</gui> (Předvolby), <gui>Help</gui> (Nápověda) a <gui>About Application</gui> (O aplikaci Aplikace) a stejně tak o položky specifické pro aplikaci.</p>


<section id="when-to-use">
<title>Kdy použít</title>

<p>Většina aplikací má hlavní nabídku, protože slouží standardně k umístění položky <gui>About Application</gui> (O aplikaci Aplikace), u která se očekává, že ji bude mít každá aplikace.</p>

</section>

<section id="guidance">
<title>Pokyny</title>

<p>Hlavní nabídky bývají typicky umístěné na pravé straně záhlavní lišty. Existují ale dvě varianty tohoto pravidla:</p>

<list>
<item><p>Když aplikace obsahuje navigaci v okně, s nejvyšší úrovní a podstránkami, měla by být hlavní nabídka umístěná jen v nejvyšší úrovni. Pokud potřebují nabídku i podstránky, mohou používat <link xref="secondary-menus">podružnou nabídku</link>.</p></item>
<item><p>Když je hlavní nabídka použita spolu se <link xref="sidebar-lists">seznamem v postranním panelu</link>, měla by být umístěná vpravo nad postranním panelem. Pokud potřebují nabídku i položky zobrazené v části okna s obsahem, mohou používat <link xref="secondary-menus">podružnou nabídku</link>.</p></item>
</list>

<p>Další zásady:</p>

<list>
<item><p>Hlavní nabídka může obsahovat položky jak pro hlavní okno nebo zobrazení, tak pro aplikaci jako celek. Tím se odlišuje od <link xref="secondary-menus">podružné nabídky</link>, která obsahuje položky vztahující se ke konkrétnímu zobrazení nebo položce.</p></item>
<item><p>Když rozhodujete o obsahu a uspořádání hlavní nabídky, řiďte se <link xref="menus">standardními pokyny pro nabídky</link>.</p></item>
<item><p>Hlavní nabídka bývá vložená do <link xref="popovers">rozbalovacího dialogu</link>. Díky tomu může obsahovat i různé ovládací prvky, třeba skupinu tlačítek.</p></item>
</list>

</section>

<section id="standard-menu-items">
<title>Standardní položky nabídky</title>

<p>Následují standardní položky hlavní nabídky, které by měly být umístěné v jedné skupině na konci nabídky:</p>

<table>
<tr>
<td><p><gui>Preferences</gui>
(<gui>Předvolby</gui>)</p></td>
<td><p>Otevře dialogové okno s předvolbami aplikace, pokud aplikace nějaké předvolby má.</p></td>
</tr>
<tr>
<td><p><gui>Keyboard Shortcuts</gui>
(<gui>Klávesové zkratky</gui>)</p></td>
<td><p>Otevře okno se seznamem klávesových zkratek aplikace, pokud aplikace nějaké klávesové zkratky má.</p></td>
</tr>
<tr>
<td><p><gui>Help</gui>
(<gui>Nápověda</gui>)</p></td>
<td><p>Otevře uživatelskou dokumentaci aplikace v aplikaci <app>Nápověda</app>.</p></td>
</tr>
<tr>
<td><p><gui>About Application</gui>
(<gui>O aplikaci Aplikace</gui>)</p></td>
<td><p>Otevře dialogové okno s informacemi o aplikaci. Součástí názvu této položky by měl být název aplikace, například <gui>O aplikaci Fotky</gui> nebo <gui>O kalkulačce</gui>. Každá hlavní nabídka by měla obsahovat tuto položku.</p></td>
</tr>
</table>

<p>Hlavní nabídka by neměla obsahovat položky pro zavření nebo ukončení: okno je možné zavřít pomocí zavíracího tlačítka na hlavičkové liště a u položky pro zavření v nabídce nemusí být jednoznačné, k čemu se vztahuje. Uživatelům se navíc lehce nerozlišuje mezi ukončením a zavřením a může je to tak mást.</p>

</section>

<section id="api-reference">
<title>Referenční příručka 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>
