Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

oncommand — gestire l’evento command

L’attributo oncommand specifica il codice JavaScript da eseguire quando viene ricevuto un evento command. Va inserito sull’elemento che riceve il comando; non seleziona la destinazione e non avvia un comando da solo.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

oncommand="JavaScript statements"

oncommand è un attributo di contenuto globale per la gestione dell’evento command, disponibile sugli elementi HTML. Il suo valore è il corpo di una funzione JavaScript, non il nome di un comando. Alla sua controparte DOM, element.oncommand, è possibile assegnare una funzione.

Nel meccanismo dei comandi, un pulsante usa commandfor per indicare l’elemento di destinazione e command per specificare l’azione. Inserisci il gestore oncommand sulla destinazione, non necessariamente sul pulsante. I nomi dei comandi personalizzati iniziano con --; il loro comportamento viene implementato dal codice dell’autore.

Nel gestore, event.command contiene il comando ed event.source identifica l’elemento che ha avviato l’azione, nel rispetto delle regole di retargeting dello Shadow DOM. this si riferisce all’elemento che gestisce l’evento. Nell’esempio, il pulsante invia --report e il paragrafo sostituisce il proprio testo con quel valore.

L’esempio richiede che il browser supporti le funzionalità pertinenti e che sia consentita l’esecuzione di script inline. Una Content Security Policy può bloccare l’attributo del gestore; in alternativa, un’applicazione può registrare un gestore con addEventListener('command', handler) in uno script consentito.

Esempi

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

Risultato

--report

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti