Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

:fullscreen — um elemento no estado de ecrã inteiro

A pseudoclasse :fullscreen seleciona os elementos que se encontram no estado de ecrã inteiro. Permite alterar o seu aspeto durante a apresentação em ecrã inteiro, mas não ativa, por si só, esse modo.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

:fullscreen { /* declarations */ }
E:fullscreen { /* declarations */ }

:fullscreen é uma pseudoclasse sem argumentos. E:fullscreen seleciona um elemento do tipo E no estado de ecrã inteiro; :fullscreen, por si só, não restringe o tipo de elemento. A regra CSS reage a um estado — não ativa o modo de ecrã inteiro.

A Fullscreen API define a correspondência através de uma flag de ecrã inteiro ativada. Um anfitrião de Shadow DOM também pode corresponder se o reajuste do destino de ecrã inteiro em relação a esse anfitrião resultar no próprio anfitrião. Assim, vários elementos podem corresponder simultaneamente a :fullscreen, enquanto document.fullscreenElement identifica o elemento de ecrã inteiro mais acima exposto nesse contexto.

Isto não é um teste de tamanho: preencher a janela com CSS não ativa a flag de ecrã inteiro. Os descendentes não correspondem automaticamente apenas por estarem dentro de um elemento correspondente. #panel:fullscreen aplica estilos ao painel, enquanto #panel:fullscreen p aplica estilos aos seus parágrafos nesse estado.

O exemplo chama requestFullscreen() após um clique, trata a rejeição e atualiza o resultado após fullscreenchange. A passagem para o modo de ecrã inteiro requer autorização para utilizar a funcionalidade. A condição de ativação é satisfeita se houver uma ativação transitória do utilizador ou se uma mudança de orientação provocada pelo utilizador desencadear o algoritmo. O ambiente pode recusar o pedido. O resultado esperado descreve uma entrada e saída bem-sucedidas, não uma disponibilidade garantida da API.

Exemplos

<!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>

Resultado

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes