CKTIS / CSS
:fullscreen – ein Element im Vollbildzustand
Die Pseudoklasse :fullscreen wählt Elemente aus, die sich im Vollbildzustand befinden. So lässt sich ihr Erscheinungsbild während der Vollbildanzeige ändern; den Vollbildmodus selbst aktiviert sie jedoch nicht.
Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
:fullscreen { /* declarations */ }
E:fullscreen { /* declarations */ }:fullscreen ist eine Pseudoklasse ohne Argumente. E:fullscreen wählt ein Element vom Typ E im Vollbildzustand aus; :fullscreen allein schränkt den Elementtyp nicht ein. Die CSS-Regel reagiert auf einen Zustand – sie aktiviert den Vollbildmodus nicht.
Die Fullscreen API bestimmt die Übereinstimmung anhand eines gesetzten Vollbild-Flags. Auch ein Shadow-DOM-Host kann übereinstimmen, wenn das Neuausrichten des Vollbildziels auf diesen Host den Host selbst ergibt. Daher können mehrere Elemente gleichzeitig auf :fullscreen passen, während document.fullscreenElement das oberste Vollbildelement bezeichnet, das in diesem Kontext verfügbar ist.
Dies ist keine Größenprüfung: Das Fenster mit CSS auszufüllen setzt das Vollbild-Flag nicht. Nachfahren passen nicht automatisch, nur weil sie sich innerhalb eines passenden Elements befinden. #panel:fullscreen formatiert das Panel, während #panel:fullscreen p dessen Absätze in diesem Zustand formatiert.
Das Beispiel ruft nach einem Klick requestFullscreen() auf, behandelt eine Ablehnung und aktualisiert das Ergebnis nach fullscreenchange. Der Wechsel in den Vollbildmodus setzt die Berechtigung zur Nutzung dieser Funktion voraus. Die Aktivierungsprüfung ist erfolgreich, wenn eine vorübergehende Benutzeraktivierung vorliegt oder wenn eine vom Benutzer verursachte Orientierungsänderung den Algorithmus auslöst. Die Umgebung kann die Anfrage ablehnen. Das erwartete Ergebnis beschreibt einen erfolgreichen Wechsel in den Vollbildmodus und zurück, nicht eine garantierte Verfügbarkeit der API.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:fullscreen demo</title>
<style>
#panel { padding: 24px; background: white; color: black; }
#panel:fullscreen { background: navy; color: white; }
</style>
<section id="panel">
<button id="toggle" type="button">Toggle fullscreen</button>
<p id="status" role="status">fullscreen: false</p>
</section>
<script>
const panel = document.querySelector('#panel');
const status = document.querySelector('#status');
document.querySelector('#toggle').addEventListener('click', async () => {
try {
if (document.fullscreenElement) {
await document.exitFullscreen();
} else {
await panel.requestFullscreen();
}
} catch {
status.textContent = 'Fullscreen request failed';
}
});
document.addEventListener('fullscreenchange', () => {
status.textContent = `fullscreen: ${panel.matches(':fullscreen')}`;
});
</script>
</html>Ergebnis
Initially: fullscreen: false After successful entry: fullscreen: true; navy background and white text. After exit: fullscreen: false; white background and black text. If a request is rejected: Fullscreen request failed
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.