GlobalEventHandlers.onclick

Esta tradução está incompleta. Ajude a traduzir este artigo em inglês

A propriedade onclick do mixin GlobalEventHandlers é o EventHandler para o processamento de eventos de click em um dado elemento.

O evento click acontece quando o usuário clica em um elemento. É disparado após os eventos mousedown emouseup 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, 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 de Navegador

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
onclickChrome Full support 1Edge Full support 12Firefox Full support 1IE Full support 9Opera Full support 9Safari Full support 3WebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support 10.1Safari iOS Full support 1Samsung Internet Android Full support 1.0

Legend

Full support  
Full support

Veja também