Geräte-Orientierung
Die Toolbar passt sich automatisch an Hochkant- und Querformat an. Beim Drehen wird die Position relativ zum unteren Rand beibehalten.
Position & Andocken
Die Globale Toolbar soll dich nie behindern. Deshalb kannst du sie vertikal verschieben und bei Bedarf an die Seite andocken, sodass sie nur noch als kleiner Indikator sichtbar ist.
Vertikales Verschieben
Abschnitt betitelt „Vertikales Verschieben“-
Drücken und halten Halte den Finger irgendwo auf der Toolbar gedrückt — sie wird leicht hervorgehoben (stärkerer Schatten, farbiger Rand) und ein Drag-Indikator erscheint links.
-
Vertikal ziehen Bewege den Finger nach oben oder unten. Die Toolbar folgt unmittelbar.
-
Loslassen Beim Loslassen wird die Position automatisch in der App-Konfiguration gespeichert.
Grenzen
Abschnitt betitelt „Grenzen“Die Toolbar bleibt immer im sichtbaren Bereich:
| Grenze | Wert |
|---|---|
| Mindestabstand vom unteren Rand | 16 px (über der Safe Area des Geräts) |
| Maximale Höhe | Bildschirmhöhe minus 200 px |
| Standard-Position | 80 px vom unteren Rand |
So kannst du sie nicht versehentlich aus dem Bildschirm schieben.
Persistenz
Abschnitt betitelt „Persistenz“Die vertikale Position wird in der AppConfig unter toolbarVerticalOffset gespeichert. Das bedeutet:
- ✅ Position bleibt nach App-Neustart erhalten
- ✅ Position bleibt nach Hot-Reload erhalten
- ✅ Position synchronisiert sich beim nächsten App-Start
Andocken (Swipe-to-Dock)
Abschnitt betitelt „Andocken (Swipe-to-Dock)“Wenn du die Toolbar gerade nicht brauchst, kannst du sie zur Seite wischen, um deinen Bildschirm freizuräumen.
-
Horizontal wischen Lege den Finger auf die Toolbar und wische nach links oder nach rechts.
-
Schwellwert überschreiten Erst wenn du mehr als 60 px zurücklegst oder mit einer Geschwindigkeit von mehr als 300 px/s wischst, dockt sie an.
-
Animierter Übergang Die Toolbar gleitet animiert zur gewünschten Kante und verwandelt sich in einen kleinen Andock-Indikator.
Indikator
Abschnitt betitelt „Indikator“Der Indikator ist ein kleines, dezentes Element an der Bildschirmkante. Er:
- Klebt vertikal an deiner aktuellen Toolbar-Position (nicht an einer festen Stelle)
- Zeigt einen kleinen Notification-Dot, wenn versteckte Buttons offene Badges haben
- Ist mit einem Tap wieder ausklappbar
Wieder einblenden
Abschnitt betitelt „Wieder einblenden“Du holst die Toolbar auf zwei Wegen zurück:
- Tap auf den Indikator an der Bildschirmkante
- Wischen vom Indikator zur Mitte (gegenläufig zum Andocken)
Die Toolbar gleitet animiert zurück in die Mitte und ist sofort wieder voll bedienbar.
Persistierte Zustände
Abschnitt betitelt „Persistierte Zustände“Drei Werte werden für die Toolbar gespeichert, damit sie sich beim nächsten Start genauso verhält wie zum Schluss:
| Wert | Speicher-Key | Bedeutung |
|---|---|---|
| Vertikale Position | toolbarVerticalOffset | Abstand zum unteren Rand in Pixeln |
| Dock-Zustand | toolbarDockState | expanded / dockedLeft / dockedRight |
| Swipe-Hint angezeigt | toolbarSwipeHintShown | true, sobald Discoverability-Snackbar gesehen wurde |
Verhalten in Sonderfällen
Abschnitt betitelt „Verhalten in Sonderfällen“Tastatur ist offen
Abschnitt betitelt „Tastatur ist offen“Wenn die Tastatur eingeblendet ist, wird die Toolbar normalerweise versteckt, damit sie keine Inhalte verdeckt. Ausnahme: Ist die Suche aktiv, bleibt die Toolbar (mit Suchfeld) über der Tastatur sichtbar — sonst würdest du das Suchfeld verlieren, sobald die Tastatur sich öffnet.
Suche ist aktiv
Abschnitt betitelt „Suche ist aktiv“Während die Suche aktiv ist, wird der Dock-Zustand temporär ignoriert. Die Toolbar erscheint immer als volle Toolbar in der Mitte, damit das Suchfeld und Ergebnis-Dropdown ihren Platz haben. Sobald du die Suche schließt, kehrt sie in den vorher gewählten Dock-Zustand zurück.
Auf einer ausgeschlossenen Route
Abschnitt betitelt „Auf einer ausgeschlossenen Route“Auf Routen wie Page Builder, Form Builder oder im Onboarding wird die Toolbar gar nicht angezeigt — unabhängig vom Dock-Zustand. Sobald du diese Bereiche verlässt, erscheint sie wieder.
Zwei-Finger-Setup
Wenn du intensiv mit Toolbar und Bildschirminhalten arbeitest, dock sie an die gegenüberliegende Seite deiner Schreibhand — so deckt der Indikator nichts ab, was du gerade bearbeitest.
Position zurücksetzen
Du willst die Toolbar wieder auf Standard-Position? Ziehe sie einfach an die gewünschte Stelle (z. B. ca. 80 px über dem unteren Rand) — sie merkt sich die neue Position.