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

  <info>
    <link type="guide" xref="patterns#primary"/>
    <desc>Programmets huvudmeny, markerad med en stapel med tre horisontella linjer</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>Anders Jonsson</mal:name>
      <mal:email>anders.jonsson@norsjovallen.se</mal:email>
      <mal:years>2015, 2018</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Sebastian Rasmussen</mal:name>
      <mal:email>sebras@gmail.com</mal:email>
      <mal:years>2017, 2018</mal:years>
    </mal:credit>
  </info>

<title>Primärmenyer</title>

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

<p>Primärmenyer är ett standardiserat designmönster som finns i de flesta program. De har menyikonen som etikett (vid namn <code>menu-open</code>) och innehåller toppnivåobjekten för programmets meny. Detta kan omfatta standardobjekt så som <gui>Inställningar</gui>, <gui>Hjälp</gui> och <gui>Om Program</gui> så väl som andra programspecifika objekt.</p>


<section id="when-to-use">
<title>När ska de användas</title>

<p>De flesta program har primärmenyer, då de är standardplatsen för menyobjektet <gui>Om Program</gui>, vilket varje program förväntas ha.</p>

</section>

<section id="guidance">
<title>Råd</title>

<p>Primärmenyer placeras typiskt på höger sida av rubrikraden. Det finns dock två variationer på denna regel:</p>

<list>
<item><p>Om programmet använder navigering i fönster, med toppnivåplats och undersidor, bör primärmenyn bara placeras på toppnivån: undersidor kan inkludera en <link xref="secondary-menus">sekundärmeny</link> om en meny behövs.</p></item>
<item><p>Då den används i kombination med en <link xref="sidebar-lists">sidopanelslista</link> bör primärmenyn placeras ovanför sidopanelslistan till höger. Om en meny krävs för objekt som visas i fönstrets innehållssida kan en <link xref="secondary-menus">sekundärmeny</link> användas.</p></item>
</list>

<p>Andra riktlinjer:</p>

<list>
<item><p>Primärmenyer kan innehålla objekt för både det aktuella fönstret och vyn, så väl som programmet i stort. Detta särskiljer dem från <link xref="secondary-menus">sekundärmenyer</link>, vilka bara innehåller menyobjekt som relaterar till en specifik vy eller objekt.</p></item>
<item><p>Följ <link xref="menus">standardriktlinjerna för menyer</link> när du bestämmer innehåll och ordning för primärmenyer.</p></item>
<item><p>En primärmeny finns inuti i ett <link xref="popovers">kontextfönster</link>. Som sådan kan en primärmeny inkludera en mängd olika komponenter så som grupper av knappar.</p></item>
</list>

</section>

<section id="standard-menu-items">
<title>Standardmenyobjekt</title>

<p>Följande är standardobjekt i primärmenyer, och bör placeras i en grupp i slutet på menyn:</p>

<table>
<tr>
<td><p><gui>Inställningar</gui></p></td>
<td><p>Öppnar programmets inställningsdialog om det har någon sådan.</p></td>
</tr>
<tr>
<td><p><gui>Tangentbordsgenvägar</gui></p></td>
<td><p>Öppnar programmets fönster för tangentbordsgenvägar, om det har något sådant.</p></td>
</tr>
<tr>
<td><p><gui>Hjälp</gui></p></td>
<td><p>Öppnar programmets användardokumentation i programmet <app>Hjälp</app>.</p></td>
</tr>
<tr>
<td><p><gui>Om Program</gui></p></td>
<td><p>Öppnar programmets Om-dialogruta. Detta objekt bör innehålla programmets namn, så som <gui>Om Foton</gui> eller <gui>Om Kalkylator</gui>. Varje primärmeny bör innehålla detta objekt.</p></td>
</tr>
</table>

<p>Primärmenyer bör inte innehålla menyobjekt för att stänga eller avsluta. Fönster kan redan stängas från rubrikraden, och det kan vara tvetydigt vad ett menyobjekt för stängning hänvisar till. Användare kan ha svårt att hålla isär stäng och avsluta, och det kan därför vara missledande.</p>

</section>

<section id="api-reference">
<title>API-referens</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>
