<?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</gui> (O aplikaci) a stejně tak o položky specifické pro aplikaci.</p>

<p>Hlavní nabídka bývá typicky umístěná na pravé straně hlavičkové lišty. Když je použita v kombinaci se <link xref="sidebar-lists">seznamem v postranním panelu</link>, měla by být umístěná nad ním.</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</gui> (O aplikaci), u která se očekává, že ji bude mít každá aplikace.</p>

</section>

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

<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>Aplikace, které používají navigaci v okně, by měly obrazit hlavní nabídku jen v zobrazení nejvyšší úrovně (typicky v hlavním zobrazení, které se ukáže po spuštění aplikace). Podřízená zobrazení, což jsou třeba ta, která zobrazují jednotlivé položky obsahu, by měla místo nich používat <link xref="secondary-menus">podružné nabídky</link>.</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>
<item><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></item>
</list>

</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>
