Repository navigation
Closed
10 / 1110 of 11 issues completedLabels
enhancementNew feature or requestNew feature or requestuxUser interface and usabilityUser interface and usability
Milestone
Description
Goal
A Lagebuchführer can run the whole incident from the keyboard alone, quickly and under pressure, without reaching for the mouse and without input landing somewhere it can't be seen.
This grew out of the field note in #466 ("bei tab diesen einen auswählen"). An audit of main (74b2837) showed that the Tab note is the tip of a wider gap: no app-wide shortcuts, overlays that neither take nor return focus, inconsistent Enter-submit, grids without row keys, and focus that is invisible on most controls. Earlier context: #262 (UX review, "few KeyBindings"), #282 (Alt mnemonics).
Keyboard contract
Every child issue implements part of this contract. New UI follows it too.
- Overlay: focus goes inside once it is shown, Tab cycles inside it, Esc cancels, Enter triggers the primary action (except in multi-line text), and focus goes back to the control that opened it.
- Exception, destructive confirms (remove, discard, close): initial focus is on Cancel, and Enter activates the focused button. Confirming takes a deliberate step: Tab to the destructive button, or its own key. A reflex Del → Enter must never delete.
- Entry form: Enter submits from any single-line field. Afterwards the form is cleared and focus goes to the first field. The initial focus is the first field, unless the view's issue says otherwise and gives a reason.
- Sticky fields: a form may mark fields that usually repeat between entries (e.g. Kräfte FEUERWEHR). Those keep their value after a submit, with the text selected, so typing replaces it and Tab keeps it. Each view's issue lists its sticky fields, or says it has none.
- Suggestion box: one behaviour covers open-on-focus, Enter, Tab and Esc.
- Enter submits in a single press when no row is highlighted.
- Tab never takes a match the user can't see. It takes a match only if it is highlighted in the list or shown as selected inline completion in the box. A blind "only match is a prefix" rule is ruled out: "Florian X 1/46" is a prefix of "Florian X 1/46-1", and "Müll" is a prefix of "Müller" (see the risk in feat(input): one keyboard model for suggestion boxes (Tab, Enter, Esc) #466).
- Grid or list: Enter/F2 = primary action or edit, Del = remove (always confirmed, see 1), Space = toggle, arrow keys move.
- No Del on ETB rows. The Einsatztagebuch is a record, not a list; entries are edited with history, never removed.
- Every keyboard-triggered toggle or remove can be undone: a short "Rückgängig" notice, also on Ctrl+Z. One stray Space must not silently close an Aufgabe.
- Global:
- Module shortcuts are stable per module, bound to the module key, not to the rail position. The rail order comes from the Stammdaten navigation and the incident's checklists (
NavigationLayout.Resolve), so "the third module" differs between departments and incidents. Ctrl+Tab / Ctrl+Shift+Tab cycle the rail as shown. - No global shortcut takes a text-editing key (Ctrl+A/C/V/X/Z/Y).
- A shortcut for a new ETB entry and one to jump to the most urgent warning, in a written order (proposal: Rückzug > Druckabfrage > Aufgabe fällig > ILS; decide in feat(shell): global shortcuts and a shortcut overview #544).
- An F1 overview generated from the shortcut registry. F1 only: Ctrl+? needs Shift+ß on a German keyboard.
- Key hints are shown inline on the rail and on the primary buttons, not only in tooltips. A keyboard user never hovers.
- No global shortcut fires while an overlay is open.
- Module shortcuts are stable per module, bound to the module key, not to the rail position. The rail order comes from the Stammdaten navigation and the incident's checklists (
- Visible focus: a
:focus-visibleedge on every interactive control, in its own focus token, notSignalColor.Tokens.axamlreserves SignalColor for the emergency accent; a red ring roaming every control would wear out the meaning of red next to a Rückzugsalarm. Use:focus-visible, never plain:focus, because all XAML is shared with Android. - Stable focus: reaching a view by arrowing the rail doesn't steal focus, and neither sync rebuilds nor reconnects move the user.
Children (suggested order)
- test(keyboard): shared keyboard helpers and an overlay contract test #537 test helpers + overlay contract test (+ the runtime checks)
- feat(theme): visible keyboard focus on every interactive control #541 visible keyboard focus. First after the helpers: nobody can dogfood, review or screenshot a keyboard flow while focus is invisible
- feat(overlay): dialogs and inline panels take focus, keep Tab inside, close on Esc, return focus #538 overlay contract (TaskDialog, PdfExport, ConfirmDialog, inline panels)
- feat(atemschutz): Druckkontrolle by keyboard — Enter records, warning bar focuses the Trupp #539 Druckkontrolle by keyboard
- feat(input): Enter submits every entry form and focus returns to the first field #540 Enter-submit + refocus in every entry form
- feat(input): one keyboard model for suggestion boxes (Tab, Enter, Esc) #466 one keyboard model for suggestion boxes
- fix(focus): focus stays where the user left it (rail, sync rebuilds, reconnect, ETB filter) #542 focus stability
- feat(lists): row keys in grids and lists — Enter/F2, Del with confirm, Space #543 row keys in grids and lists
- feat(shell): global shortcuts and a shortcut overview #544 global shortcuts + overview
Done when
- Every overlay passes the contract test from test(keyboard): shared keyboard helpers and an overlay contract test #537.
- A scripted keyboard-only walkthrough of an Übung (create incident → Kräfte → Atemschutz with Druckkontrolle → ETB entries → Aufgabe → PDF export) passes as a headless test, without any pointer event.
- Keystroke budget. For three flows — one ETB entry, one Druckkontrolle from the warning bar, adding one vehicle in Kräfte — the key presses are counted on
mainbefore this milestone and after it, and the numbers are in this issue. Reachable is not the same as fast. (table) - Übung check. At least two Lagebuchführer run a scripted scenario keyboard-only, observed and timed; what tripped them up is filed as issues.
- The shortcut overview lists every shortcut, and the README links to it.
Metadata
Metadata
Assignees
Labels
enhancementNew feature or requestNew feature or requestuxUser interface and usabilityUser interface and usability
Activity
DeepDiver1975 commentedon Oct 1, 2026
UX review of the milestone; the body and the children are updated. What changed:
SignalColor, whichTokens.axamlreserves for the emergency accent. Moved up to directly after test(keyboard): shared keyboard helpers and an overlay contract test #537: no keyboard flow can be reviewed while focus is invisible.MinimumProtocolVersion); Access-key (Alt+mnemonic) navigation across primary action buttons #282 moved to v0.11.test(keyboard): shared keyboard helpers, overlay contract test and ru…
fix(overlay): give every dialog one keyboard contract (#555)
DeepDiver1975 commentedon Oct 6, 2026
The tests below are in #568.
Keystroke budget: before and after v0.8
Measured headless with real key presses, the same flows on
3b4f24d(the parent of #537, before this milestone) and onmainafter #567. Each flow starts with focus in another module's form, the way the Lagebuchführer's hands are mid-Einsatz. Only keys spent getting there are counted; the typed text is identical in both versions (one press per character, a chord such as Strg+N counts once).Why "not possible" before: the module rail was not in the Tab order. Forward Tab cycled the form → the grid → the command bar → back to the grid and never reached a rail tab; Shift+Tab stuck on the first field (
VehicleBox, the ETB'sHideSystemCheckBox). Switching modules needed the mouse. For a comparable number, the "before" column assumes one click on the rail tab and counts the cheapest keyboard path after it (forward or backward Tab, whichever is shorter).KeystrokeBudgetTestsnow pins the "after" numbers as budgets (4 / 2 / 3), so a change that makes one of these flows dearer fails the build and has to argue for it.Other Done when items
KeyboardWalkthroughTests.An_Uebung_runs_from_Home_to_the_PDF_by_keyboard_aloneruns Home → NEUER EINSATZ → Lagebuchführer → Kräfte → Atemschutz Trupp → Druckkontrolle via F9 → two ETB entries → Aufgabe → PDF export, with key presses only (no pointer event, no command or view model set). It found one gap, fixed in the same PR: the PDF dialog opened with focus on the first section checkbox, so a reflex Enter unticked the Checkliste instead of exporting. It now opens on EXPORTIEREN.OverlayContractTestscovers everyPending*overlay and the inline panels. The ETBHistoryPanelis not covered on purpose: it is a read-only docked panel that never takes focus, so it is not an overlay in the sense of the contract.ShortcutRegistryandGlobalShortcutTestschecks it lists exactly the registered shortcuts; the README's Mit der Tastatur section links to it (feat(shell): global shortcuts and a shortcut overview #567).test(keyboard): keyboard-only Übung walkthrough and keystroke budget (#…
feat: ask before Esc or ABBRECHEN discards a typed CO reading or Eins…