Was macht Fokusverwaltung mit CSS-Animationen?
Dieses Dokument beschreibt Lösungen für Tastaturnavigationsprobleme bei schwebenden Komponenten (Select, DropdownMenu, Popover) mit CSS-Öffnungs-/Schließanimationen.
Das Problem
Wenn schwebende Inhaltselemente CSS-Animationen haben, die bei opacity: 0 beginnen (wie Tailwinds animate-in fade-in-0), kann der Browser element.focus()-Aufrufe ablehnen, weil das Element unsichtbar ist.
Symptome
- Die Komponente öffnet sich korrekt mit Mausklicks
- Die Tastaturnavigation (Pfeiltasten, Escape) funktioniert nicht nach dem Öffnen mit der Tastatur
- Funktioniert einwandfrei in Demos ohne Animationsklassen
- Fehlerhaft in Demos mit Animationsklassen
Grundursache
- CSS-Animationen wie
fade-in-0starten das Element beiopacity: 0 - Wenn
focus()unmittelbar nach dem Rendern aufgerufen wird, ist das Element noch unsichtbar - Der Browser lehnt den Fokus auf unsichtbare Elemente ab
- Der Fokus bleibt auf dem Auslöser-Button statt auf dem Inhalt
- Tastaturereignisse gehen an den Auslöser (der im geöffneten Zustand nichts tut) statt an den Inhalt
Nachweis durch Konsolen-Debugging
// Nach dem Öffnen von Select gehen Tastaturereignisse an den Auslöser, nicht an den Inhalt:
Document keydown: ArrowDown Target: <button role="combobox" ...>
// Aktives Element ist der Auslöser, nicht der Inhalt:
Active: BUTTON summit-select-...-trigger
Die Lösung
Implementieren Sie einen Wiederholungsmechanismus für den Fokus, der es der Animation ermöglicht, über opacity: 0 hinaus fortzuschreiten, bevor aufgegeben wird.
JavaScript-Implementierung
// src/SummitUI/Scripts/floating.js
/**
* Fokussiert ein Element mit Wiederholungsmechanismus für animierte Elemente.
* Elemente mit CSS-Animationen, die bei opacity:0 beginnen, können anfänglich focus() ablehnen.
* Dies wiederholt den Fokus bis zu 5 Mal mit 20ms Verzögerung, um der Animation
* zu ermöglichen, den unsichtbaren Zustand zu verlassen.
* @param {HTMLElement} element - Zu fokussierendes Element
*/
export function focusElement(element) {
if (!element) return;
function tryFocus(attempts) {
element.focus();
// Wenn der Fokus nicht erfolgreich war und noch Versuche übrig sind, wiederholen
if (document.activeElement !== element && attempts > 0) {
setTimeout(() => tryFocus(attempts - 1), 20);
}
}
// Erster Versuch nach einem Frame, damit CSS angewendet werden kann
requestAnimationFrame(() => tryFocus(5));
}
Kernpunkte
requestAnimationFramezuerst verwenden – Stellt sicher, dass CSS angewendet wurde, bevor der Fokus versucht wirddocument.activeElementprüfen – Überprüfen, ob der Fokus tatsächlich erfolgreich war- Mit Verzögerungen wiederholen – 20ms-Intervalle ermöglichen das Fortschreiten der Animation
- Begrenzte Versuche – 5 Wiederholungen = 100ms maximale Wartezeit, ausreichend für typische Animationen
- Auf alle Fokusfunktionen anwenden – Sowohl
focusElement(element)als auchfocusElementById(id)benötigen dieses Muster
Aktualisierte Funktionen
floating.js:focusElement(element)– Wird von SelectContent verwendetfloating.js:focusElementById(elementId)– Wird von DropdownMenuContent verwendet
Testen
"Mit Animationen"-Abschnitte zu Test-Demo-Seiten und entsprechende Playwright-Tests hinzugefügt.
CSS-Animationsklassen für Tests
/* tests/SummitUI.Tests.Manual/SummitUI.Tests.Manual/wwwroot/app.css */
@keyframes fadeInZoomIn {
from {
opacity: 0;
transform: scale(0.95);
}
to {
opacity: 1;
transform: scale(1);
}
}
@keyframes fadeOutZoomOut {
from {
opacity: 1;
transform: scale(1);
}
to {
opacity: 0;
transform: scale(0.95);
}
}
.animated-content[data-state="open"] {
animation: fadeInZoomIn 150ms ease-out forwards;
}
.animated-content[data-state="closed"] {
animation: fadeOutZoomOut 150ms ease-in forwards;
}
Testfälle
Für jede Komponente (Select, DropdownMenu, Popover):
| Test | Was wird geprüft |
|---|---|
Animated*_ShouldOpen_OnEnterKey | Öffnen mit Tastatur bei vorhandenen Animationen |
Animated*_ShouldNavigate_WithArrowKeys | Pfeiltasten funktionieren nach animiertem Öffnen |
Animated*_ShouldSelect/Activate_OnEnterKey | Auswahl/Aktivierung nach animiertem Öffnen möglich |
Animated*_ShouldClose_OnEscape | Escape löst Schließanimation aus |
Animationstests ausführen
dotnet run --project tests/SummitUI.Tests.Playwright -- --treenode-filter '/*/*/*/Animated*'
Beteiligte Dateien
| Datei | Zweck |
|---|---|
src/SummitUI/Scripts/floating.js | Enthält die Funktionen focusElement und focusElementById |
src/SummitUI/Components/Select/SelectContent.cs | Ruft FocusElementAsync beim Öffnen auf |
src/SummitUI/Components/DropdownMenu/DropdownMenuContent.cs | Ruft FocusElementByIdAsync für Menüeinträge auf |
src/SummitUI/Components/Popover/PopoverContent.cs | Verwaltet den Fokus für Popover-Inhalte |
Alternativansätze
- Längere anfängliche Verzögerung – Könnte 50-100ms Verzögerung vor dem ersten Fokusversuch verwenden, fügt jedoch spürbare Verzögerung hinzu
- Fokus vor Animationsstart – Würde Änderungen an der Render-Reihenfolge erfordern, komplex
- Animation während Fokus deaktivieren – Würde einen visuellen Fehler verursachen
- CSS
visibilitystattopacity– Würde Änderungen an der Art und Weise erfordern, wie Animationen erstellt werden
Der Wiederholungsmechanismus wurde gewählt, weil er:
- Mit jeder Animationsdauer funktioniert
- Keine Änderungen an der CSS-Erstellung erfordert
- Minimale Auswirkungen auf die Leistung hat
- Sich bei fehlgeschlagenem Fokus ordentlich verhält
Verwandte Muster
Dieses Muster ähnelt der Handhabung von animierter Präsenz in bits-ui für Svelte-Komponenten. Die zentrale Erkenntnis ist, dass DOM-Operationen (wie Fokus) möglicherweise darauf warten müssen, dass CSS-Animationen einen fokussierbaren Zustand erreichen.