Una función que se ejecuta una vez cuando el rueda del ratón se mueve.
Declarar la función mouseWheel()
establece un bloque de código para ejecutarse automáticamente cuando el usuario hace scroll con el ratón:
function mouseWheel() { // Code to run. }
Las variables del sistema del ratón, como mouseX y mouseY, se actualizarán con su valor más reciente cuando mouseWheel()
sea llamada por p5.js:
function mouseWheel() { if (mouseX < 50) { // Code to run if the mouse is on the left. }if (mouseY > 50) { // Code to run if the mouse is near the bottom. } }
El parámetro, event
, es opcional. mouseWheel()
siempre se le pasa un MouseEvent objeto con propiedades que describen el evento de desplazamiento del ratón:
function mouseWheel(event) { // Code to run that uses the event. console.log(event); }
El objeto event
tiene muchas propiedades incluyendo delta
, un Number
que contiene la distancia que el usuario ha hecho scroll. Por ejemplo, event.delta
podría tener el valor 5 cuando el usuario hace scroll hacia arriba. event.delta
es positivo si el usuario hace scroll hacia arriba y negativo si hace scroll hacia abajo. Los signos son opuestos en macOS con "natural" scrolling habilitado.
Los navegadores pueden tener comportamientos predeterminados asociados a eventos de ratón. Por ejemplo, algunos navegadores resaltan texto cuando el usuario mueve el ratón mientras mantiene un botón presionado. Para evitar cualquier comportamiento predeterminado para este evento, agregue return false;
al final de la función.
Nota: En Safari, mouseWheel()
podría no funcionar de manera esperada si no se agrega return false;
al final de la función.
Ejemplos
Sintaxis
mouseWheel([event])
Parámetros
Argumento opcional WheelEvent
.
Referencias Relacionadas
doubleClicked
Una función que se ejecuta una vez cuando el botón del mouse se hace doble click rápidamente.
exitPointerLock
Sale de un bloqueo de puntero iniciado con requestPointerLock.
mouseButton
Una variable de tipo String del sistema que contiene el valor del último botón del mouse presionado.
mouseClicked
Una función que se ejecuta una vez después de que se presiona y se suelta un botón del mouse.