<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:uix="http://projectmallard.org/experimental/ui/" type="topic" id="popovers" xml:lang="sv">

  <info>
    <credit type="author">
      <name>Allan Day</name>
      <email>aday@gnome.org</email>
    </credit>

    <link type="guide" xref="ui-elements"/>
    <uix:thumb mime="image/svg" src="figures/ui-elements/popover.svg"/>

    <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>Kontextfönster</title>

<p>Ett kontextfönster är en tillfällig behållare som dyker upp ovanför sitt överordnade fönster som svar på en användaråtgärd. Kontextfönster kan innehålla en mängd olika användargränssnittselement, inklusive knappar, listor och menyer. De används ofta som en del av knappmenyer eller snabbvalsmenyer.</p>

<media type="image" mime="image/svg" src="figures/ui-elements/popover.svg"/>

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

<p>Kontextfönster kan användas för att visa extra komponenter som användaren inte alltid behöver. De kan låta användaren utföra åtgärder eller så kan de innehålla inställningar. De är ett väldigt flexibelt gränssnittselement som är lämpligt för kreativa designlösningar.</p>

<p>Ett kontextfönster bör alltid relateras till ett specifikt gränssnittselement som agerar som kontextfönstrets källa. Vanligen är detta antingen en knapp eller ett innehållsobjekt. Då de utlöses av en knapp kan ett kontextfönster användas som en mer flexibel variant av en knappmeny, vilken låter grupper av komponenter kommas åt då de behövs. Exempel på detta inkluderar:</p>

<list>
<item><p>Att visa en liten verktygslåda med komponenter för textformatering.</p></item>
<item><p>Ett sökgränssnitt, med en sökruta och plats för en lista över resultat.</p></item>
<item><p>En samling av visningskomponenter så som zoom, lista/rutnät samt sortering av innehåll.</p></item>
</list>

<p>Som en mekanism för att visa ytterligare komponenter eller information så liknar kontextfönster <link xref="dialogs">dialogfönster</link>. Deras huvudsakliga fördel över dialogrutor är att de stör mindre och har en nära relation till ett enda element som kontextfönstret pekar på. Du bör dock fortfarande överväga att använda en dialogruta om du vill visa stora mängder information eller mer komplexa arrangemang av komponenter, eller om situationen kräver en av de vanliga konventionerna för dialoganvändning, så som en bekräftelsedialog.</p>

</section>

<section id="popover-content">
<title>Innehåll i kontextfönster</title>

<list>
<item><p>Ett kontextfönster är en generisk behållare, och kan innehålla en stor bredd av komponenter så som knappar, skjutreglage, listor, växelknappar och textfält. Blanda dock inte för många olika sorters komponenter i samma kontextfönster, och försök gruppera komponenter av samma typ tillsammans.</p></item>
<item><p>Kontextfönster kan fungera som en behållare för en meny, eller för en meny i kombination med ett litet antal kompletterande komponenter.</p></item>
<item><p>Om syftet för ett kontextfönsters komponenter är tvetydigt så kan kontextfönstret ges en rubrik.</p></item>
<item><p>Knapparna <gui>Stäng</gui> eller <gui>Färdig</gui> behövs vanligen inte i ett kontextfönster.</p></item>
</list>

</section>


<section id="general-guidelines">
<title>Allmänna riktlinjer</title>

<p>Kontextfönster bör alltid vara små (som en tumregel bör de aldrig täcka mer än en tredjedel av sitt överordnade fönster) och med låg komplexitet. De bör alltid dyka upp som underställda sina föräldrafönster.</p>
<p>Ett kontextfönster bör endast dyka upp som svar på en användaråtgärd, och bör aldrig dyka upp oavsiktligt eller på ett förvånande sätt.</p>

</section>


<section id="api-reference">
<title>API-referens</title>

<list>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkPopover.html">GtkPopover</link></p></item>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkPopoverMenu.html">GtkPopoverMenu</link></p></item>
</list>
</section>

</page>
