Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

onauxclick — controlador de clic con un botón auxiliar

El atributo onauxclick asigna código JavaScript al evento auxclick, relacionado con hacer clic con un botón no principal de un dispositivo apuntador. Se puede usar en todos los elementos HTML.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

onauxclick="JavaScript statements"

onauxclick es un atributo global de gestión de eventos de HTML. Gestiona el evento auxclick, relacionado con hacer clic con un botón no principal, como el botón central del ratón. No sustituye a onclick.

El valor del atributo es el cuerpo de una función JavaScript, no una URL ni el nombre de un evento. El código recibe el objeto event. La propiedad DOM correspondiente, onauxclick, acepta una función o null; en cambio, el atributo escrito en HTML contiene código en forma de texto.

La Content Security Policy puede bloquear esta gestión de eventos integrada en HTML. No insertes texto que no sea de confianza en el valor del atributo: es código ejecutable.

El ejemplo despacha auxclick mediante programación, por lo que no requiere un ratón con un botón auxiliar. Comprueba la conexión entre el atributo y su controlador, no el comportamiento de un dispositivo físico ni las acciones nativas del navegador.

Ejemplos

<!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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes