UI-Elemente und Interaktionen
=============================

Konzentriert euch auf die Aufgabe
---------------------------------

Wenn es sinnvoll ist, solltet ihr Anweisungen in Bezug auf das formulieren, was
ihr erreichen wollt. Indem ihr den Verweis auf UI-Elemente vermeidet, helft ihr,
den Zweck einer Anweisung zu verstehen, und tragt dazu bei, Abläufe
effektiver zu machen.

Allerdings solltet ihr die Zielgruppe kennen und den Kontext verstehen. Zudem
kann es auch sinnvoll sein, zunächst alle Elemente einer Seite vorzustellen.

* ✅ Klickt auf :guilabel:`Aktualisieren`
* ❌ Klickt auf die Schaltfläche  :guilabel:`Aktualisieren`
* ❌ Wählt :guilabel:`Erweiterte Optionen`
* ✅ Wählt :menuselection:`Einstellungen --> Erweiterte Optionen`

Formatieren von UI-Elementen
----------------------------

Wenn ihr auf den Namen eines beliebigen UI-Elements verweisen wollt, setzt den
Namen in serifenloser Schrift. Dazu gehören Namen für Schaltflächen, Menüs,
Dialoge, Fenster, Listenelemente oder jede andere Funktion auf der Seite, die
einen sichtbaren Namen hat. Verwendet keine Code-Schrift für UI-Elemente, es sei
denn, es handelt sich um ein Element, das die Anforderungen für Code erfüllt.

Folgt in den meisten Fällen der Groß- und Kleinschreibung, wie sie auch auf der
Seite erscheint. Wenn die Beschriftungen jedoch inkonsistent sind oder nur in
Großbuchstaben geschrieben werden, verwendet die übliche Schreibweise im Satz.
Verwendet UI-Elemente jedoch nicht so, als wären sie Verben oder Substantive im
Satz.

* ✅ Aktiviert im Fenster :guilabel:`Neues Projekt` das Kontrollkästchen
  :guilabel:`Neue Aktivität` und klickt dann auf :guilabel:`Weiter`
* ❌ Aktiviert im Fenster »Neues Projekt« das Kontrollkästchen »Neue Aktivität«
  und klickt dann auf die Schaltfläche »Weiter«
* ✅ Klickt auf :guilabel:`⟳ Aktualisieren`
* ❌ Klickt auf :guilabel:`AKTUALISIEREN`
* ✅ Gebt im Feld :guilabel:`Name` einen Kontonamen ein
* ❌ Gebt den :guilabel:`Namen` für das Konto ein
* ✅ Um die Einstellungen zu speichern, klickt auf :guilabel:`Speichern`
* ❌ :guilabel:`Speichern` Sie die Einstellungen
* ✅ Gebt im Feld :guilabel:`Servicekonto-ID` einen Namen ein
* ❌ Gebt eine :guilabel:`Servicekonto-ID` ein
* ✅ Gebt für :guilabel:`Servicekonto-ID` einen Namen an

Sphinx
------

.. seealso::
   * :doc:`python-basics:document/ui-elements`