StefanMoCoAt
1b20e480f4
Some checks failed
Desktop CI — Headless Tests & Build / Compose Desktop — Tests (headless) & Build (push) Failing after 1m0s
Build and Publish Docker Images / build-and-push (., backend/services/ping/Dockerfile, ping-service, ping-service) (push) Has been cancelled
Build and Publish Docker Images / build-and-push (., config/docker/caddy/web-app/Dockerfile, web-app, web-app) (push) Has been cancelled
Build and Publish Docker Images / build-and-push (., config/docker/keycloak/Dockerfile, keycloak, keycloak) (push) Has been cancelled
Build and Publish Docker Images / build-and-push (., backend/infrastructure/gateway/Dockerfile, api-gateway, api-gateway) (push) Has been cancelled
43 lines
2.2 KiB
Markdown
43 lines
2.2 KiB
Markdown
# Journal-Eintrag: Fokus-Navigation & Keyboard-UX Korrektur (DeviceInitialization)
|
|
|
|
**Datum:** 18. April 2026
|
|
**Status:** Abgeschlossen
|
|
**Kontext:** Desktop-Zentrale Onboarding
|
|
|
|
## 🔍 Problembeschreibung
|
|
Der User berichtete von anhaltenden Problemen bei der Tastatur-Navigation (Tabulator- und Enter-Taste) im `DeviceInitialization`-Screen. Trotz vorangegangener Optimierungen mit `ImeAction.Next` war der Fokus-Fluss in Compose Desktop unzuverlässig, insbesondere beim Wechsel zwischen `MsSettingsField` und Standard-`OutlinedTextField` sowie beim dynamischen Einblenden von Sektionen.
|
|
|
|
## 🛠️ Lösung & Implementierung
|
|
Um die Navigation absolut deterministisch zu machen, wurde von der automatischen Fokus-Suche auf eine explizite **Focus-Requester-Kette** umgestellt.
|
|
|
|
### 1. Explizite FocusRequester
|
|
In `DeviceInitializationConfig.jvm.kt` wurden `FocusRequester` für alle Hauptfelder definiert:
|
|
- `deviceNameFocus`
|
|
- `sharedKeyFocus`
|
|
- `backupPathFocus`
|
|
|
|
### 2. Harte KeyboardActions
|
|
Anstatt sich auf `focusManager.moveFocus(FocusDirection.Next)` zu verlassen (was bei komplexen Hierarchien fehlschlagen kann), rufen die `onNext`-Handler nun explizit den `requestFocus()` des logisch nächsten Feldes auf.
|
|
- `Gerätename` -> `sharedKeyFocus.requestFocus()`
|
|
- `Sync-Key` -> `backupPathFocus.requestFocus()` (falls Rolle = MASTER)
|
|
|
|
### 3. Dialog-Auto-Fokus
|
|
Beim Klick auf "+ Client hinzufügen" wird nun mittels `LaunchedEffect` sofort der Fokus auf das neue Eingabefeld (`addClientNameFocus`) gesetzt, was einen nahtlosen Übergang ohne Maus-Interaktion ermöglicht.
|
|
|
|
### 4. Komponenten-Refactoring
|
|
Die `MsSettingsField`-Komponente wurde erweitert, um den `Modifier` korrekt an das interne `OutlinedTextField` durchzureichen, was die Bindung der `FocusRequester` ermöglichte.
|
|
|
|
## ✅ Ergebnis
|
|
Die Tastatur-Navigation folgt nun exakt dem fachlichen Workflow:
|
|
1. Gerätename (Enter/Tab) ->
|
|
2. Sync-Key (Enter/Tab) ->
|
|
3. Backup-Pfad (Enter/Tab) ->
|
|
4. Interaktive Elemente (Slider/Buttons)
|
|
|
|
Dies entspricht dem professionellen Anspruch an eine hocheffiziente Desktop-Anwendung ("Information Density over White Space").
|
|
|
|
---
|
|
🏗️ **[Lead Architect]**
|
|
🧐 **[QA Specialist]**
|
|
🧹 **[Curator]**
|