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

CKTIS / HTML

onauxclick — gestor de cliques com um botão auxiliar

O atributo onauxclick associa código JavaScript ao evento auxclick, relacionado com o clique num botão não principal de um dispositivo apontador. Pode ser usado em todos os elementos HTML.

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

Sintaxe

onauxclick="JavaScript statements"

onauxclick é um atributo global de gestão de eventos HTML. Gere o evento auxclick, relacionado com o clique num botão não principal, como o botão do meio do rato. Não substitui onclick.

O valor do atributo é o corpo de uma função JavaScript, não um URL nem o nome de um evento. O código recebe o objeto event. A propriedade DOM correspondente, onauxclick, aceita uma função ou null; já o atributo escrito em HTML contém código sob a forma de texto.

Uma Content Security Policy pode bloquear esta gestão de eventos incorporada no HTML. Não insira texto não fidedigno no valor do atributo: trata-se de código executável.

O exemplo despacha auxclick por programação, pelo que não precisa de um rato com um botão auxiliar. Testa a ligação entre o atributo e o respetivo gestor, não o comportamento de um dispositivo físico nem as ações nativas do navegador.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onauxclick example</title>
<button id="target" type="button" onauxclick="document.getElementById('result').textContent = event.type;">Test target</button>
<output id="result">Waiting</output>
<script>
  document.getElementById('target').dispatchEvent(
    new MouseEvent('auxclick', { button: 1, bubbles: true })
  );
</script>
</html>

Resultado

auxclick

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