Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

O atributo onclick

O atributo onclick contém JavaScript que trata um evento click. Deve ser distinguido da propriedade element.onclick.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

onclick="JavaScript statements"

Todos os elementos HTML suportam onclick. O seu valor é o corpo de uma função JavaScript, não um URL. O código é executado durante o tratamento de um evento click.

No atributo, event representa o evento e this o elemento que o trata, não necessariamente event.target. O atributo de texto onclick e a propriedade element.onclick, que aceita uma função ou null, controlam o mesmo espaço de tratamento. A atribuição de uma função substitui o tratamento anterior.

return false cancela o evento se este for cancelável; não interrompe a propagação. Uma Content Security Policy pode bloquear o código do atributo. Não insira nele conteúdo não fiável.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>onclick example</title>
</head>
<body>
  <button type="button" onclick="this.textContent = 'Done';">Run</button>
</body>
</html>

Resultado

Done

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes