Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti