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

CKTIS / HTML

onplaying — gestionar la disponibilidad para reproducir

El atributo onplaying contiene código que gestiona el evento playing, utilizado por audio y video cuando la reproducción está lista para empezar o reanudarse tras una interrupción. No inicia la reproducción y no equivale a onplay.

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

Sintaxis

onplaying="JavaScript statements"
media.onplaying = (event) => { /* handler */ };

onplaying es un atributo de gestión del evento playing. Está disponible como atributo HTML en todos los elementos HTML, aunque su uso habitual corresponde a los elementos audio y video. Su valor es código JavaScript, no una dirección de archivo ni un valor booleano.

El evento playing indica que la reproducción está lista para comenzar después de una pausa o de un retraso causado por la falta de datos. En cambio, play señala que paused ha cambiado a false. playing puede producirse de nuevo después del almacenamiento en búfer; no garantiza una reproducción ininterrumpida ni que se oiga sonido.

En JavaScript, puedes asignar una función a media.onplaying; una asignación posterior sustituye la función anterior de ese controlador. Otra opción es media.addEventListener('playing', handler). Configurar un controlador no inicia la reproducción por sí solo.

El ejemplo envía un evento playing sintético para probar el atributo sin un archivo multimedia. El texto esperado es playing. Esto no comprueba la reproducción real; requiere que los scripts estén habilitados y que se permitan los controladores de eventos en línea.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>onplaying test</title>
<audio id="media" onplaying="document.getElementById('result').textContent = event.type"></audio>
<output id="result">pending</output>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('playing'));
</script>

Resultado

playing

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