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

  <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>Christian Kirbach</mal:name>
      <mal:email>christian.kirbach@gmail.com</mal:email>
      <mal:years>2014</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Mario Blättermann</mal:name>
      <mal:email>mario.blaettermann@gmail.com</mal:email>
      <mal:years>2016</mal:years>
    </mal:credit>
  </info>

<title>Einblenddialoge</title>

<p>A popover is a transient container that appears over its parent window in response to a user action. Popovers can contain a variety of UI elements, including buttons, lists or menus. They are often used as a part of button menus or context menus.</p>

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

<section id="when-to-use">
<title>Anwendungsfälle</title>

<p>Popovers can be used to reveal additional controls that are not always needed by the user. They can can allow the user to take actions or they can contain settings and preferences. They are a very flexible interface element that lend themselves to creative design solutions.</p>

<p>A popover should always relate to a specific interface element which acts as the source of the popover. Typically, this is either a button or a content item. When they are triggered by a button, a popover can be used as a more flexible version of a button menu, allowing groups of controls to be accessed when needed. Examples of this include:</p>

<list>
<item><p>Revealing a small toolbox of text formatting controls.</p></item>
<item><p>A find interface, with a search entry box and a space for a list of results.</p></item>
<item><p>A collection of view controls, such as zoom, list/grid and content ordering.</p></item>
</list>

<p>As a mechanism for disclosing additional controls or information, popovers are similar to <link xref="dialogs">dialog windows</link>. Their main advantage over dialogs is that they are less disruptive and have a close relationship with a single element which the popover points to. However, you should still consider using a dialog if you want to display large amounts of information, or more complex arrangements of controls, or if the situation requires one of the common conventions for dialog usage, such as a confirmation dialog.</p>

</section>

<section id="popover-content">
<title>Inhalt von Einblenddialogen</title>

<list>
<item><p>Ein Einblenddialog ist ein generischer Container und kann als solcher eine breite Auswahl an Bedienelementen enthalten, zum Beispiel Knöpfe, Schieberegler, Listen, Schalter und Textfelder. Dennoch sollten Sie nicht zu viele verschiedene Elementtypen im gleichen Einblenddialog miteinander mischen und versuchen, Bedienelemente des gleichen Typs zu gruppieren.</p></item>
<item><p>Einblenddialoge können als Container für ein Menü fungieren, oder auch für ein Menü in Verbindung mit wenigen ergänzenden Bedienelementen.</p></item>
<item><p>Wenn der Zweck der Bedienelemente in einem Einblenddialog nicht eindeutig ist, können Sie den Einblenddialog mit einer Überschrift versehen.</p></item>
<item><p>Knöpfe wie <gui>Close</gui> oder <gui>Done</gui> sind in einem Einblenddialog üblicherweise nicht erforderlich.</p></item>
</list>

</section>


<section id="general-guidelines">
<title>Allgemeine Richtlinien</title>

<p>Einblenddialoge sollten nicht zu groß und auch nicht zu komplex sein. Als Faustregel gilt, dass sie nicht mehr als ein Drittel der Größe ihres Elternfensters einnehmen sollten. Sie sollten immer als »Untergebene« ihrer Elternfenster zu erkennen sein.</p>
<p>Ein Einblenddialog sollte immer nur als Ergebnis einer Benutzeraktion erscheinen, niemals in einer überraschenden oder unbeabsichtigten Weise.</p>

</section>


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