<?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åobjekt för programmets meny. Detta kan omfatta standardobjekt så som <gui>Inställningar</gui>, <gui>Hjälp</gui> och <gui>Om</gui> så väl som andra programspecifika objekt.</p>

<p>Primärmenyer finns typiskt på högra sidan av rubrikraden. När de används i kombination med en <link xref="sidebar-lists">sidopanelslista</link>, bör primärmenyn placeras ovanför sidopanelslistan.</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</gui>, vilket varje program förväntas ha.</p>

</section>

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

<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>Program som använder navigering inom fönstret bör endast visa primärmenyn för toppnivåvyn (typiskt huvudvyn som visas när programmet startas). Underordnade vyer som visar individuella innehållsobjekt bör använda <link xref="secondary-menus">sekundärmenyer</link> snarare än primärmenyer.</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 rubrikradsmeny inkludera en mängd olika komponenter så som grupper av knappar.</p></item>
<item><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></item>
</list>

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