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.