CKTIS / CSS
:fullscreen — un elemento nello stato a schermo intero
La pseudoclasse :fullscreen seleziona gli elementi che si trovano nello stato a schermo intero. Permette di modificarne l’aspetto durante la visualizzazione a schermo intero, ma non attiva da sola questa modalità.
Versione: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintassi
:fullscreen { /* declarations */ }
E:fullscreen { /* declarations */ }:fullscreen è una pseudoclasse senza argomenti. E:fullscreen seleziona un elemento di tipo E nello stato a schermo intero; :fullscreen da sola non limita il tipo di elemento. La regola CSS reagisce a uno stato: non attiva la modalità a schermo intero.
La Fullscreen API definisce la corrispondenza tramite un flag di schermo intero impostato. Può corrispondere anche un host Shadow DOM, se il riorientamento del target a schermo intero rispetto a tale host restituisce l’host stesso. Di conseguenza, più elementi possono corrispondere contemporaneamente a :fullscreen, mentre document.fullscreenElement identifica l’elemento a schermo intero più in alto esposto in quel contesto.
Non si tratta di un test delle dimensioni: riempire la finestra con CSS non imposta il flag di schermo intero. I discendenti non corrispondono automaticamente solo perché si trovano all’interno di un elemento corrispondente. #panel:fullscreen applica uno stile al pannello, mentre #panel:fullscreen p applica uno stile ai suoi paragrafi in quello stato.
L’esempio chiama requestFullscreen() dopo un clic, gestisce il rifiuto e aggiorna il risultato dopo fullscreenchange. Per passare alla modalità a schermo intero serve l’autorizzazione a usare la funzionalità. La condizione di attivazione è soddisfatta se è in corso un’attivazione transitoria dell’utente oppure se un cambio di orientamento provocato dall’utente avvia l’algoritmo. L’ambiente può rifiutare la richiesta. Il risultato atteso descrive un ingresso e un’uscita riusciti, non la disponibilità garantita dell’API.
Esempi
<!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>Risultato
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
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.