GlobalEventHandlers.onclick

A propriedade onclick do mixin GlobalEventHandlers é o event handler para o processamento de eventos de click (en-US) em um dado elemento.

O evento click acontece quando o usuário clica em um elemento. É disparado após os eventos mousedown (en-US) emouseup (en-US) na respectiva ordem.

Nota: Ao usar o evento click para disparar uma ação, considere também adicionar essa mesma ação ao evento keydown (en-US), para permitir o uso dessa mesma ação a pessoas que não usam um mouse ou uma touchscreen.

Sintaxe

elemento.onclick = refDeFuncao;

Value

refDeFuncao é o nome de uma função ou uma expressão de função. Essa função recebe um objeto MouseEvent como único argumento. Dentro da função, this será o elemento de qual o evento foi disparado.

Apenas um manipulador onclick pode estar associado a um objeto em um momento. Em vez disso, você talvez prefira usar o método EventTarget.addEventListener(), já que ele é mais flexível.

Exemplo

Esse evento registra a posição dos cliques.

HTML

html
<p>Clique em qualquer lugar nesse exemplo.</p>
<p id="log"></p>

JavaScript

js
let log = document.getElementById('log');

document.onclick = inputChange;

function inputChange(e) {
  log.textContent = `Posição: (${e.clientX}, ${e.clientY})`;
}

Result

Especificação

{{Specifications}}

Compatibilidade com navegadores

{{Compat}}

Veja também