Fullscreen API

Para cualquier elemento que quieras presentar en pantalla completa (como por ejemplo, un elemento <video>), puedes presentarlo en pantalla completa, simplemente invocando a su método requestFullscreen().

Consideremos este elemento <video>:

<video controls id="myvideo">
  <source src="somevideo.webm"></source>
  <source src="somevideo.mp4"></source>
</video>

Podemos poner este video en pantalla completa con un script como éste:

var elem = document.getElementById("myvideo");
if (elem.requestFullscreen) {
  elem.requestFullscreen();
}

Cabe aclarar una diferencia clave entre las implementaciones de Gecko y WebKit: Gecko automáticamente añade reglas CSS al elemento para ajustarlo a las dimensiones de la pantalla: "width: 100%; height: 100%". WebKit no hace esto; en su lugar, centra el elemento con su mismo tamaño original en un fondo negro. Para obtener el mismo comportamiento en WebKit, necesitas añadir manualmente las reglas CSS "width: 100%; height: 100%;" al elemento:

#myvideo:-webkit-full-screen {
  width: 100%;
  height: 100%;
}

Por otro lado, si quieres emular el comportamiento de WebKit en Gecko, necesitarías colocar el elemento a presentar dentro de otro elemento, con las reglas CSS necesarias para ajustarlo a la apariencia requerida, y será dicho elemento contenedor el que se establecerá para aparecer en pantalla completa.

Cuando el modo de pantalla completa sea invocado exitosamente, el documento que contiene al elemento recibe un evento fullscreenchange (en-US). Cuando se sale del modo de pantalla completa, el documento recibe de nuevo un evento fullscreenchange (en-US). Nótese que el evento fullscreenchange (en-US) no provee información alguna sobre si el documento está entrando o saliendo a modo de pantalla completa, pero puedes saber si está en dicho modo si la propiedad fullscreenElement (en-US) del documento no es nula.

No es garantía que se pueda cambiar a modo de pantalla completa. Por ejemplo, los elementos <iframe> tienen un atributo allowfullscreen para decidir si se permitirá que el contenido se muestre en pantalla completa. Además, ciertos tipos de contenido, como plug-ins en ventana, no pueden ser presentados en modo de pantalla completa. Intentar hacerlo con elementos que no lo permitan (o el padre o descendente de un elemento así), no funcionará. En su lugar, el elemento que solicitó la pantalla completa recibirá un evento fullscreenerror. En Firefox, cuando falla una solicitud de pantalla completa, el navegador registrará un mensaje de error en la consola, explicando la falla de la solicitud. En Chrome y versiones recientes de Opera, sin embargo, no se genera ninguna advertencia.

El usuario siempre tendrá la habilidad de salir del modo de pantalla completa por su propia cuenta; véase Cosas que los usuarios querrán saber. Incluso se puede hacer programáticamente, llamando al método exitFullscreen().

El objeto document provee información adiciional que puede ser útil al desarrollar aplicaciones de pantalla completa:

fullscreenElement (en-US)

El atributo fullscreenElement apunta al elemento actualmente en modo pantalla. Si no es nulo, el documento está en pantalla completa, y si es nulo, no lo está.

fullscreenEnabled (en-US)

El atributo fullscreenEnabled indica si el documento está actualmente en un estado que permitiría solicitudes al modo de pantalla completa.

Puedes asegurarte de hacer saber a los usuarios que pueden presionar la tecla ESC (o F11) para salir del modo de pantalla completa.

Adicionalmente, navegando a otra página, cambiando de pestaña, o cambiando a otra aplicación(usando, por ejemplo, Alt-Tab) mientras se está en pantalla completa, también se saldrá de dicho modo.

En este ejemplo, se presenta un video en una página web. Presionando la tecla Return o Enter el usuario podrá moverse entre modo de ventana o de pantalla completa para la presentación del video.

Ver ejemplo en vivo

Cuando la página se carga, este código se ejecuta para establecer un evento para cuando se presione la tecla Enter.

document.addEventListener(
  "keydown",
  function (e) {
    if (e.keyCode == 13) {
      toggleFullScreen();
    }
  },
  false,
);

Este código es llamado cuando el usuario presiona la tecla Enter, como se ve arriba.

function toggleFullScreen() {
  if (!document.fullscreenElement) {
    document.documentElement.requestFullscreen();
  } else {
    if (document.exitFullscreen) {
      document.exitFullscreen();
    }
  }
}

En este código, primero se observa si el atributo fullscreenElement de document (comprobando si tiene prefijo moz, ms, o webkit). Si es null, el documento está en modo de ventana actualmente, así que necesitamos cambiarlo a modo de pantalla completa. Esto se hace llamando a la función element.requestFullscreen().

Si el modo de pantalla completa está activado (fullscreenElement no es null), llamamos a la función document.exitFullscreen().

• Element.requestFullscreen()
• Document.exitFullscreen()
• Document.fullscreen (en-US)
• Document.fullscreenElement (en-US)
• :fullscreen, ::backdrop
• allowfullscreen