CKTIS / CSS
:fullscreen — prvek ve stavu celé obrazovky
Pseudo-třída :fullscreen vybírá prvky, které jsou ve stavu celé obrazovky. Umožňuje změnit jejich vzhled během zobrazení na celé obrazovce, sama však tento režim nezapíná.
Verze: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
:fullscreen { /* declarations */ }
E:fullscreen { /* declarations */ }:fullscreen je pseudo-třída bez argumentů. E:fullscreen vybírá prvek typu E ve stavu celé obrazovky; samotné :fullscreen typ prvku neomezuje. Pravidlo CSS reaguje na stav — režim celé obrazovky nezapíná.
Fullscreen API určuje shodu podle nastaveného příznaku celé obrazovky. Shodovat se může také hostitel Shadow DOM, pokud přesměrování cíle celé obrazovky vůči tomuto hostiteli vrátí samotného hostitele. Současně tedy může selektoru :fullscreen vyhovovat několik prvků, zatímco document.fullscreenElement označuje nejvyšší prvek celé obrazovky zpřístupněný v daném kontextu.
Nejde o test velikosti: vyplnění okna pomocí CSS příznak celé obrazovky nenastaví. Potomci se automaticky neshodují jen proto, že jsou uvnitř prvku, který shodu splňuje. #panel:fullscreen styluje panel, zatímco #panel:fullscreen p styluje jeho odstavce v tomto stavu.
Příklad po kliknutí zavolá requestFullscreen(), ošetří odmítnutí a po události fullscreenchange aktualizuje výsledek. Přechod do režimu celé obrazovky vyžaduje povolení k použití této funkce. Podmínka aktivace je splněna, pokud probíhá přechodná aktivace uživatelem nebo pokud algoritmus spustí změna orientace vyvolaná uživatelem. Prostředí může požadavek odmítnout. Očekávaný výsledek popisuje úspěšný vstup a odchod, nikoli zaručenou dostupnost API.
Příklady
<!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>Výsledek
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
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.