24 de junio de 2022

Eventos del Mouse

En este capítulo vamos a entrar en más detalles sobre los eventos del mouse y sus propiedades.

Ten en cuenta que tales eventos pueden provenir no sólo del “dispositivo mouse”, sino también de otros dispositivos, como teléfonos y tabletas, donde se emulan por compatibilidad.

Tipos de eventos del mouse

Ya hemos visto algunos de estos eventos:

mousedown/mouseup
Se oprime/suelta el botón del ratón sobre un elemento.
mouseover/mouseout
El puntero del mouse se mueve sobre/sale de un elemento.
mousemove
Cualquier movimiento del mouse sobre un elemento activa el evento.
click
Se activa después de mousedown y un mouseup enseguida sobre el mismo elemento si se usó el botón.
dblclick
Se activa después de dos clicks seguidos sobre el mismo elemento. Hoy en día se usa raramente.
contextmenu
Se activa al pulsar el botón derecho del ratón. Existen otras formas de abrir el menú contextual, por ejemplo: usando un comando especial de teclado también puede activarse, de manera que no es exactamente un evento exclusivo del mouse.

…Existen otros eventos más que cubriremos más tarde.

El orden de los eventos

Como pudiste ver en la lista anterior, una acción del usuario puede desencadenar varios eventos.

Por ejemplo , un click izquierdo primero activa mousedowncuando se presiona el botón, enseguida mouseup y click cuando se suelta.

En casos así, el orden es fijo. Es decir, los controladores son llamados en el siguiente orden mousedownmouseupclick.

Haz click en el botón abajo y verás los eventos. Intenta con doble click también.

En el testeador de abajo todos los eventos quedan registrados. Si hay mas de un segundo de retraso entre cada uno de ellos quedan separados por una línea horizontal.

Además podemos ver la propiedad de button que nos permite detectar el botón del mouse. Lo explicaremos a continuación.

El botón del mouse

Los eventos relacionados con clics siempre tienen la propiedad button, esta nos permite conocer el botón exacto del mouse.

Normalmente no la usamos para eventos click y contextmenu events, porque sabemos que ocurren solo con click izquierdo y derecho respectivamente.

Por otro lado, los controladores mousedown y mouseup pueden necesitar event.button ya que estos eventos se activan con cualquier botón, y button nos permitirá distinguir entre “mousedown derecho” y “mousedown izquierdo”.

Los valores posibles para event.button son:

Estado del botón event.button
Botón izquierdo (primario) 0
Botón central (auxiliar) 1
Botón derecho (secundario) 2
Botón X1 (atrás) 3
Botón X2 (adelante) 4

La mayoría de los dispositivos de ratón sólo tienen los botones izquierdo y derecho, por lo que los valores posibles son 0 o 2. Los dispositivos táctiles también generan eventos similares cuando se toca sobre ellos.

También hay una propiedad event.buttons que guarda todos los botones presionados actuales en un solo entero, un bit por botón. En la práctica, esta propiedad es raramente utilizada. Puedes encontrar más detalles en MDN si alguna vez lo necesitas.

El obsoleto event.which

El código puede utilizar la propiedad event.which que es una forma antigua no estándar de obtener un botón con los valores posibles:

  • event.which == 1 – botón izquierdo,
  • event.which == 2 – botón central,
  • event.which == 3 – botón derecho.

Ahora event.which está en desuso, no deberíamos usarlo.

Modificadores: shift, alt, ctrl y meta

Todos los eventos del mouse incluyen la información sobre las teclas modificadoras presionadas.

Propiedades del evento:

  • shiftKey: Shift
  • altKey: Alt (p Opt para Mac)
  • ctrlKey: Ctrl
  • metaKey: Cmd para Mac

Su valor es true si la tecla fue presionada durante el evento.

Por ejemplo, el botón abajo solo funciona conAlt+Shift+click:

<button id="button">Alt+Shift+¡Click sobre mí!</button>

<script>
  button.onclick = function(event) {
    if (event.altKey && event.shiftKey) {
      alert('¡Genial!');
    }
  };
</script>
Atención: en Mac suele ser Cmd en lugar de Ctrl

En Windows y Linux existen las teclas modificadoras Alt, Shift y Ctrl. En Mac hay una más: Cmd, correspondiente a la propiedad metaKey.

En la mayoría de las aplicaciones, cuando Windows/Linux usan Ctrl, en Mac se usa Cmd.

Es decir: cuando un usuario de Windows usa Ctrl+Enter o Ctrl+A, un usuario Mac presionaría Cmd+Enter o Cmd+A, y así sucesivamente.

Entonces si queremos darle soporte a combinaciones como Ctrl+click, entonces para Mac tendría más sentido usar Cmd+click. Esto es más cómodo para los usuarios de Mac.

Incluso si quisiéramos obligar a los usuarios de Mac a hacer Ctrl+click – esto supone algo de dificultad. El problema es que: un click izquierdo con Ctrl es interpretado como click derecho en MacOS, y esto genera un evento contextmenu, no un click como en Windows/Linux.

Así que si queremos que los usuarios de todos los sistemas operativos se sientan cómodos, entonces junto con ctrlKey debemos verificar metaKey.

Para código JS significa que debemos hacer la comprobación if (event.ctrlKey || event.metaKey).

También hay dispositivos móviles

Las combinaciones de teclado son buenas como una adición al flujo de trabajo. De modo que si el visitante usa un teclado – funcionan.

Pero si su dispositivo no lo tiene – entonces debería haber una manera de vivir sin teclas modificadoras.

Coordenadas: clientX/Y, pageX/Y

Todos los eventos del ratón proporcionan coordenadas en dos sabores:

  1. Relativas a la ventana: clientX y clientY.
  2. Relativos al documento: pageX y pageY.

Ya cubrimos la diferencia entre ellos en el capítulo Coordenadas.

En resumen, las coordenadas relativas al documento pageX/Yse cuentan desde la esquina superior izquierda del documento y no cambian cuando se desplaza la página, mientras que clientX/Y se cuentan desde la esquina superior actual. Cambian cuando se desplaza la página.

Por ejemplo, si tenemos una ventana del tamaño 500x500, y el mouse está en la esquina superior izquierda, entonces clientX y clientY son 0, sin importar cómo se desplace la página.

Y si el mouse está en el centro, entonces clientX y clientY son 250, No importa en qué parte del documento se encuentren. Esto es similar a position:fixed en ese aspecto.

Mueve el mouse sobre el campo de entrada para ver clientX/clientY (el ejemplo está dentro del iframe, así que las coordenadas son relativas al iframe):

<input onmousemove="this.value=event.clientX+':'+event.clientY" value="Pasa el mouse sobre mí">

Previniendo la selección en mousedown

El doble clic del mouse tiene un efecto secundario que puede ser molesto en algunas interfaces: selecciona texto.

Por ejemplo, un doble clic en el texto de abajo lo selecciona además de activar nuestro controlador:

<span ondblclick="alert('dblclick')">Haz doble click en mi</span>

Si se pulsa el botón izquierdo del ratón y, sin soltarlo, mueve el ratón, también hace la selección, a menudo no deseado.

Hay varias maneras de evitar la selección, que se pueden leer en el capítulo Selection y Range.

En este caso particular, la forma más razonable es evitar la acción del navegador mousedown. Esto evita ambas selecciones:

Antes...
<b ondblclick="alert('Click!')" onmousedown="return false">
  Haz doble click en mí
</b>
...Después

Ahora el elemento en negrita no se selecciona con doble clic, y al mantener presionado el botón izquierdo y arrastrar no se iniciará la selección.

Tenga en cuenta: el texto dentro de él todavía es seleccionable. Sin embargo, la selección no debe comenzar en el texto en sí, sino antes o después. Por lo general, eso está bien para los usuarios.

Previniendo copias

Si queremos inhabilitar la selección para proteger nuestro contenido de la página del copy-paste, entonces podemos utilizar otro evento: oncopy.

<div oncopy="alert('¡Copiado prohibido!');return false">
  Querido usuario,
  El copiado está prohibida para ti.
  Si sabes JS o HTML entonces puedes obtener todo de la fuente de la página.
</div>

Si intenta copiar un fragmento de texto en el <div> no va a funcionar porque la acción default de oncopy fue evitada.

Seguramente el usuario tiene acceso a la fuente HTML de la página, y puede tomar el contenido desde allí, pero no todos saben cómo hacerlo.

Resumen

Los eventos del mouse tienen las siguientes propiedades:

  • Botón: button.

  • Teclas modificadoras (true si fueron presionadas): altKey, ctrlKey, shiftKey y metaKey (Mac).

    • Si quieres controlar las acciones de la tecla Ctrl no te olvides de los usuarios de Mac que generalmente usan Cmd, de manera que es mejor verificar con la condicional: if (e.metaKey || e.ctrlKey).
  • Coordenadas relativas a la ventana: clientX/clientY.

  • Coordenadas relativas al documento: pageX/pageY.

La acción predeterminada del navegador mousedown es la selección del texto, si no es bueno para la interfaz, entonces debe evitarse.

En el próximo capítulo veremos más detalles sobre los eventos que siguen al movimiento del puntero y cómo rastrear los cambios de elementos debajo de él.

Tareas

importancia: 5

Cree una lista donde los elementos son seleccionables, como en los administradores de archivos.

  • Un clic en un elemento de la lista selecciona solo ese elemento (agrega la clase .selected), deselecciona todos los demás.
  • Si se hace un clic con Ctrl (Cmd para Mac), el estado seleccionado/deseleccionado cambia para ese solo elemento, los otros elementos no se modifican.

Demo:

PD: Para esta tarea, podemos suponer que los elementos de la lista son solo de texto. No hay etiquetas anidadas.

PPD: Evita la selección nativa del navegador del texto en los clics.

Abrir un entorno controlado para la tarea.

Mapa del Tutorial