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

CKTIS / HTML

onplay — gestionar el evento play

El atributo onplay contiene JavaScript que se ejecuta ante el evento play, normalmente en un elemento audio o video. Este evento indica que se sale del estado de pausa, pero no garantiza que el sonido o el vídeo ya se esté reproduciendo.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

onplay="JavaScript statements"

onplay es un atributo de contenido de controlador de eventos para play. Su valor es el cuerpo de una función JavaScript, no una dirección de archivo ni un atributo booleano. Se usa normalmente en elementos audio y video; añadir el atributo no inicia la reproducción.

El navegador dispara play cuando paused cambia de true a false, por ejemplo mediante play() o autoplay. Esto todavía no significa que haya reproducción efectiva: puede que no haya datos disponibles. El evento playing, gestionado mediante onplaying, se refiere al inicio o la reanudación de la reproducción después de detenerse por falta de datos.

En JavaScript, asigna una función a media.onplay o usa media.addEventListener('play', handler). Asignar la propiedad sustituye la función anterior de ese espacio de controlador de eventos. La Content Security Policy puede bloquear el código escrito directamente en el atributo.

El ejemplo dispara un play sintético, por lo que no necesita un archivo multimedia. El texto esperado es play; esto comprueba la conexión del controlador, no la reproducción.

Ejemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onplay test</title>
<audio id="media" onplay="document.getElementById('result').textContent = event.type;"></audio>
<p id="result">pending</p>
<script>
  document.getElementById('media').dispatchEvent(new Event('play'));
</script>
</html>

Resultado

play

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