<page xmlns="http://projectmallard.org/1.0/" xmlns:uix="http://projectmallard.org/experimental/ui/" type="topic" id="notifications" xml:lang="de">

  <info>

    <link type="guide" xref="patterns#primary"/>

    <desc>Systemweite Benachrichtigungen zu Ereignissen</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>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>Benachrichtigungen</title>

Notifications enable you to inform the users about events when they are not using your application. They also provide the ability for users to quickly respond to those events, using notification actions.

<section id="when-to-use">

<title>Anwendungsfälle</title>

Use notifications to inform the user about events they will be interested in while they are not using your application. This can include new messages in messaging applications, the completion of long-running tasks, reminders for calendars, and so on.

Notifications shouldn’t be used as a substitute for feedback that is provided by your application windows, which should be able to inform the user about events without the need for notifications.

</section>

<section id="notification-elements">

<title>Elemente in Benachrichtigungen</title>

Für Benachrichtigungen in GNOME 3 gibt es eine Reihe von Standardkomponenten:

Element
Beschreibung

Anwendungssymbol
Zeigt an, welche Anwendung die Benachrichtigung gesendet hat.

Titel
Die Überschrift der Benachrichtigung.

Rumpf
Ein optionaler Textblock, der zusätzliche Details zur Benachrichtigung enthält. Der Textrumpf der Benachrichtigung kann in mehrere Absätze unterteilt sein, zum Beispiel ein Teil des Anfangs einer E-Mail.

Standardaktion
Dies ist die Aktion, die bei der Aktivierung der Benachrichtigung ausgelöst wird.

Aktionen
Jede Benachrichtigung kann bis zu drei Knöpfe enthalten.

<section id="titles">

<title>Titel</title>

The title should provide a short and concise summary of the event that triggered the notification. The notification body may not always be visible, so it is important to ensure that the notification can be understood from the title alone.

</section>

<section id="default-actions">

<title>Standardaktionen</title>

The default action should always dismiss the notification and raise a window belonging to the application that sent the notification. If the notification relates to a particular part of your application’s user interface, the default action should display that part of the UI. The default action for a notification about a new email should show the relevant email message when activated, for example.

</section>

<section id="actions">

<title>Benachrichtigungsaktionen</title>

You can provide useful functionality by embedding buttons in notifications. This allows users to quickly and easily respond to the notification.

<list>

<item>
Notification actions should be related to the content of the notification, and should not provide generic actions for your application. This ensures that each notification has a clear focus and purpose.
</item>

<item>
Only use notification actions when the functionality that they provide is commonly required.
</item>

<item>
Actions should not replace user interface controls elsewhere - it should be possible to take the same actions from your application’s windows.
</item>

<item>
It is not necessary to always use notification actions, and many notifications will not require them.
</item>

<item>
Notification actions should not duplicate the default action. For example, a new email notification does not need to include an Open button, since the default action should already perform this action.
</item>

</list>

</section>

</section>

<section id="general-guidance">

<title>Allgemeine Richtlinien</title>

<list>

<item>
It is important not to needlessly distract users with notifications. This can easily become annoying and frustrating, and will not incline users to like your application. Therefore, always be critical when using notifications, and question whether users really need to be informed about the events you want to communicate.
</item>

<item>
Applications that deal with lots of events, such as email or social media messages, run a particular risk of distracting users with too many notifications. These applications should place restrictions on how frequently they send notification messages. Instead of showing a notification for each new message, it is a good idea for each notification to provide a summary of new messages.
</item>

<item>
Benachrichtigungen in GNOME 3 bleiben erhalten, nachdem sie erstmals angezeigt wurden. Daher ist es wichtig, Benachrichtigungen zu löschen, die für den Benutzer nicht mehr von Bedeutung sind.

<list>

<item>
Your application window should provide feedback on all the events that have been communicated by notifications. As a result, when your application window is focused, notification messages should be treated as having been read, and should be removed.
</item>

<item>
Ensure that your application removes notifications that are no longer valid. For example, a notification for a weather warning that has been revoked should be removed.
</item>

</list></item>

</list>

</section>

<section id="api-reference">

<title>API-Referenz</title>

<list>

<item>
<link href="https://developer.gnome.org/gio/stable/GNotification.html">GNotification</link>
</item>

</list>

</section>

</page>