Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

:fullscreen — un elemento en estado de pantalla completa

La pseudoclase :fullscreen selecciona los elementos que están en estado de pantalla completa. Permite cambiar su aspecto durante la presentación a pantalla completa, pero no activa por sí misma ese modo.

Versión: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxis

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

:fullscreen es una pseudoclase sin argumentos. E:fullscreen selecciona un elemento de tipo E que está en estado de pantalla completa; :fullscreen por sí sola no limita el tipo de elemento. La regla CSS responde a un estado: no activa el modo de pantalla completa.

La Fullscreen API determina la coincidencia mediante una marca de pantalla completa activada. Un anfitrión de Shadow DOM también puede coincidir si, al reajustar el destino de pantalla completa con respecto a ese anfitrión, el resultado es el propio anfitrión. Por tanto, varios elementos pueden coincidir con :fullscreen a la vez, mientras que document.fullscreenElement identifica el elemento de pantalla completa situado más arriba que se expone en ese contexto.

No es una prueba de tamaño: llenar la ventana con CSS no activa la marca de pantalla completa. Los descendientes no coinciden automáticamente por el mero hecho de estar dentro de un elemento coincidente. #panel:fullscreen aplica estilos al panel, mientras que #panel:fullscreen p aplica estilos a sus párrafos en ese estado.

El ejemplo llama a requestFullscreen() tras hacer clic, gestiona el rechazo y actualiza el resultado después de fullscreenchange. Para entrar en el modo de pantalla completa se necesita permiso para usar la función. La condición de activación se cumple si hay una activación transitoria del usuario o si un cambio de orientación provocado por el usuario desencadena el algoritmo. El entorno puede denegar la solicitud. El resultado esperado describe una entrada y salida satisfactorias, no una disponibilidad garantizada de la API.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes