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.

Note: 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

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

JavaScript

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

document.onclick = inputChange;

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

Result

Especificação

Specification Status Comment
HTML Living Standard
The definition of 'onclick' in that specification.
Padrão em tempo real  

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também