CKTIS / HTML
oncommand — gestionar el evento command
El atributo oncommand especifica el código JavaScript que se ejecuta al recibir un evento command. Se coloca en el elemento que recibe el comando; no selecciona el destino ni inicia un comando por sí solo.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
oncommand="JavaScript statements"oncommand es un atributo de contenido global de controlador de eventos para el evento command, disponible en elementos HTML. Su valor es el cuerpo de una función JavaScript, no el nombre de un comando. A su equivalente en el DOM, element.oncommand, se le puede asignar una función.
En el mecanismo de comandos, un botón usa commandfor para indicar el elemento de destino y command para especificar la acción. Coloca el controlador oncommand en el destino, no necesariamente en el botón. Los nombres de comandos personalizados empiezan por --; el código del autor implementa su comportamiento.
Dentro del controlador, event.command contiene el comando y event.source identifica el elemento que inició la acción, sujeto a las reglas de redireccionamiento del Shadow DOM. this se refiere al elemento que gestiona el evento. En el ejemplo, el botón envía --report y el párrafo sustituye su texto por ese valor.
El ejemplo requiere que el navegador admita las funciones correspondientes y que se permita ejecutar scripts inline. Una Content Security Policy puede bloquear el atributo del controlador; una aplicación puede registrar en su lugar un controlador con addEventListener('command', handler) en un script permitido.
Ejemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>oncommand example</title>
<button type="button" commandfor="target" command="--report">Run</button>
<p id="target" oncommand="if (event.command === '--report') this.textContent = event.command;">Ready</p>
</html>Resultado
--report
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.