CKTIS / CSS
:fullscreen — een element in de schermvullende status
De pseudoklasse :fullscreen selecteert elementen die zich in de schermvullende status bevinden. Hiermee kun je hun uiterlijk tijdens de schermvullende weergave aanpassen, maar de pseudoklasse schakelt die modus niet zelf in.
Versie: 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 is een pseudoklasse zonder argumenten. E:fullscreen selecteert een element van het type E in de schermvullende status; :fullscreen alleen beperkt het elementtype niet. De CSS-regel reageert op een status — deze schakelt de schermvullende modus niet in.
De Fullscreen API bepaalt of iets overeenkomt aan de hand van een ingestelde schermvullende vlag. Ook een Shadow DOM-host kan overeenkomen als het aanpassen van het schermvullende doel aan die host de host zelf oplevert. Daarom kunnen meerdere elementen tegelijk overeenkomen met :fullscreen, terwijl document.fullscreenElement het bovenste schermvullende element aanduidt dat in die context beschikbaar is.
Dit is geen groottetest: het venster met CSS vullen stelt de schermvullende vlag niet in. Afstammelingen komen niet automatisch overeen alleen omdat ze zich binnen een overeenkomend element bevinden. #panel:fullscreen geeft het paneel stijlen, terwijl #panel:fullscreen p de alinea’s erin in die status stijlen geeft.
Het voorbeeld roept na een klik requestFullscreen() aan, handelt afwijzing af en werkt het resultaat bij na fullscreenchange. Om over te schakelen naar de schermvullende modus is toestemming nodig om de functie te gebruiken. Aan de activeringsvoorwaarde is voldaan als er tijdelijke gebruikersactivatie is of als een door de gebruiker veroorzaakte wijziging van de schermoriëntatie het algoritme in gang zet. De omgeving kan het verzoek weigeren. Het verwachte resultaat beschrijft een geslaagde overgang naar en uit de schermvullende modus, niet een gegarandeerde beschikbaarheid van de API.
Voorbeelden
<!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>Resultaat
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
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.