--- title: GlobalEventHandlers.onclick slug: Web/API/GlobalEventHandlers/onclick translation_of: Web/API/GlobalEventHandlers/onclick ---
{{ ApiRef("HTML DOM") }}

A propriedade onclick do mixin {{domxref("GlobalEventHandlers")}} é o {{event("Event_handlers", "event handler")}} para o processamento de eventos de {{event("click")}} em um dado elemento.

O evento click acontece quando o usuário clica em um elemento. É disparado após os eventos {{event("mousedown")}} e{{event("mouseup")}} na respectiva ordem.

Note: Ao usar o evento click para disparar uma ação, considere também adicionar essa mesma ação ao evento {{event("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 {{domxref("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 {{domxref("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

{{EmbedLiveSample("Example")}}

Especificação

Specification Status Comment
{{SpecName('HTML WHATWG','webappapis.html#handler-onclick','onclick')}} {{Spec2('HTML WHATWG')}}  

Compatibilidade com navegadores

{{Compat("api.GlobalEventHandlers.onclick")}}

Veja também