summaryrefslogtreecommitdiffstats
path: root/webclients/novnc/core/input/mouse.js
diff options
context:
space:
mode:
Diffstat (limited to 'webclients/novnc/core/input/mouse.js')
-rw-r--r--webclients/novnc/core/input/mouse.js280
1 files changed, 280 insertions, 0 deletions
diff --git a/webclients/novnc/core/input/mouse.js b/webclients/novnc/core/input/mouse.js
new file mode 100644
index 0000000..524b065
--- /dev/null
+++ b/webclients/novnc/core/input/mouse.js
@@ -0,0 +1,280 @@
+/*
+ * noVNC: HTML5 VNC client
+ * Copyright (C) 2012 Joel Martin
+ * Copyright (C) 2013 Samuel Mannehed for Cendio AB
+ * Licensed under MPL 2.0 or any later version (see LICENSE.txt)
+ */
+
+import * as Log from '../util/logging.js';
+import { isTouchDevice } from '../util/browser.js';
+import { setCapture, stopEvent, getPointerEvent } from '../util/events.js';
+
+var WHEEL_STEP = 10; // Delta threshold for a mouse wheel step
+var WHEEL_STEP_TIMEOUT = 50; // ms
+var WHEEL_LINE_HEIGHT = 19;
+
+export default function Mouse(target) {
+ this._target = target || document;
+
+ this._doubleClickTimer = null;
+ this._lastTouchPos = null;
+
+ this._pos = null;
+ this._wheelStepXTimer = null;
+ this._wheelStepYTimer = null;
+ this._accumulatedWheelDeltaX = 0;
+ this._accumulatedWheelDeltaY = 0;
+
+ this._eventHandlers = {
+ 'mousedown': this._handleMouseDown.bind(this),
+ 'mouseup': this._handleMouseUp.bind(this),
+ 'mousemove': this._handleMouseMove.bind(this),
+ 'mousewheel': this._handleMouseWheel.bind(this),
+ 'mousedisable': this._handleMouseDisable.bind(this)
+ };
+};
+
+Mouse.prototype = {
+ // ===== PROPERTIES =====
+
+ touchButton: 1, // Button mask (1, 2, 4) for touch devices (0 means ignore clicks)
+
+ // ===== EVENT HANDLERS =====
+
+ onmousebutton: function () {}, // Handler for mouse button click/release
+ onmousemove: function () {}, // Handler for mouse movement
+
+ // ===== PRIVATE METHODS =====
+
+ _resetDoubleClickTimer: function () {
+ this._doubleClickTimer = null;
+ },
+
+ _handleMouseButton: function (e, down) {
+ this._updateMousePosition(e);
+ var pos = this._pos;
+
+ var bmask;
+ if (e.touches || e.changedTouches) {
+ // Touch device
+
+ // When two touches occur within 500 ms of each other and are
+ // close enough together a double click is triggered.
+ if (down == 1) {
+ if (this._doubleClickTimer === null) {
+ this._lastTouchPos = pos;
+ } else {
+ clearTimeout(this._doubleClickTimer);
+
+ // When the distance between the two touches is small enough
+ // force the position of the latter touch to the position of
+ // the first.
+
+ var xs = this._lastTouchPos.x - pos.x;
+ var ys = this._lastTouchPos.y - pos.y;
+ var d = Math.sqrt((xs * xs) + (ys * ys));
+
+ // The goal is to trigger on a certain physical width, the
+ // devicePixelRatio brings us a bit closer but is not optimal.
+ var threshold = 20 * (window.devicePixelRatio || 1);
+ if (d < threshold) {
+ pos = this._lastTouchPos;
+ }
+ }
+ this._doubleClickTimer = setTimeout(this._resetDoubleClickTimer.bind(this), 500);
+ }
+ bmask = this.touchButton;
+ // If bmask is set
+ } else if (e.which) {
+ /* everything except IE */
+ bmask = 1 << e.button;
+ } else {
+ /* IE including 9 */
+ bmask = (e.button & 0x1) + // Left
+ (e.button & 0x2) * 2 + // Right
+ (e.button & 0x4) / 2; // Middle
+ }
+
+ Log.Debug("onmousebutton " + (down ? "down" : "up") +
+ ", x: " + pos.x + ", y: " + pos.y + ", bmask: " + bmask);
+ this.onmousebutton(pos.x, pos.y, down, bmask);
+
+ stopEvent(e);
+ },
+
+ _handleMouseDown: function (e) {
+ // Touch events have implicit capture
+ if (e.type === "mousedown") {
+ setCapture(this._target);
+ }
+
+ this._handleMouseButton(e, 1);
+ },
+
+ _handleMouseUp: function (e) {
+ this._handleMouseButton(e, 0);
+ },
+
+ // Mouse wheel events are sent in steps over VNC. This means that the VNC
+ // protocol can't handle a wheel event with specific distance or speed.
+ // Therefor, if we get a lot of small mouse wheel events we combine them.
+ _generateWheelStepX: function () {
+
+ if (this._accumulatedWheelDeltaX < 0) {
+ this.onmousebutton(this._pos.x, this._pos.y, 1, 1 << 5);
+ this.onmousebutton(this._pos.x, this._pos.y, 0, 1 << 5);
+ } else if (this._accumulatedWheelDeltaX > 0) {
+ this.onmousebutton(this._pos.x, this._pos.y, 1, 1 << 6);
+ this.onmousebutton(this._pos.x, this._pos.y, 0, 1 << 6);
+ }
+
+ this._accumulatedWheelDeltaX = 0;
+ },
+
+ _generateWheelStepY: function () {
+
+ if (this._accumulatedWheelDeltaY < 0) {
+ this.onmousebutton(this._pos.x, this._pos.y, 1, 1 << 3);
+ this.onmousebutton(this._pos.x, this._pos.y, 0, 1 << 3);
+ } else if (this._accumulatedWheelDeltaY > 0) {
+ this.onmousebutton(this._pos.x, this._pos.y, 1, 1 << 4);
+ this.onmousebutton(this._pos.x, this._pos.y, 0, 1 << 4);
+ }
+
+ this._accumulatedWheelDeltaY = 0;
+ },
+
+ _resetWheelStepTimers: function () {
+ window.clearTimeout(this._wheelStepXTimer);
+ window.clearTimeout(this._wheelStepYTimer);
+ this._wheelStepXTimer = null;
+ this._wheelStepYTimer = null;
+ },
+
+ _handleMouseWheel: function (e) {
+ this._resetWheelStepTimers();
+
+ this._updateMousePosition(e);
+
+ var dX = e.deltaX;
+ var dY = e.deltaY;
+
+ // Pixel units unless it's non-zero.
+ // Note that if deltamode is line or page won't matter since we aren't
+ // sending the mouse wheel delta to the server anyway.
+ // The difference between pixel and line can be important however since
+ // we have a threshold that can be smaller than the line height.
+ if (e.deltaMode !== 0) {
+ dX *= WHEEL_LINE_HEIGHT;
+ dY *= WHEEL_LINE_HEIGHT;
+ }
+
+ this._accumulatedWheelDeltaX += dX;
+ this._accumulatedWheelDeltaY += dY;
+
+ // Generate a mouse wheel step event when the accumulated delta
+ // for one of the axes is large enough.
+ // Small delta events that do not pass the threshold get sent
+ // after a timeout.
+ if (Math.abs(this._accumulatedWheelDeltaX) > WHEEL_STEP) {
+ this._generateWheelStepX();
+ } else {
+ this._wheelStepXTimer =
+ window.setTimeout(this._generateWheelStepX.bind(this),
+ WHEEL_STEP_TIMEOUT);
+ }
+ if (Math.abs(this._accumulatedWheelDeltaY) > WHEEL_STEP) {
+ this._generateWheelStepY();
+ } else {
+ this._wheelStepYTimer =
+ window.setTimeout(this._generateWheelStepY.bind(this),
+ WHEEL_STEP_TIMEOUT);
+ }
+
+ stopEvent(e);
+ },
+
+ _handleMouseMove: function (e) {
+ this._updateMousePosition(e);
+ this.onmousemove(this._pos.x, this._pos.y);
+ stopEvent(e);
+ },
+
+ _handleMouseDisable: function (e) {
+ /*
+ * Stop propagation if inside canvas area
+ * Note: This is only needed for the 'click' event as it fails
+ * to fire properly for the target element so we have
+ * to listen on the document element instead.
+ */
+ if (e.target == this._target) {
+ stopEvent(e);
+ }
+ },
+
+ // Update coordinates relative to target
+ _updateMousePosition: function(e) {
+ e = getPointerEvent(e);
+ var bounds = this._target.getBoundingClientRect();
+ var x, y;
+ // Clip to target bounds
+ if (e.clientX < bounds.left) {
+ x = 0;
+ } else if (e.clientX >= bounds.right) {
+ x = bounds.width - 1;
+ } else {
+ x = e.clientX - bounds.left;
+ }
+ if (e.clientY < bounds.top) {
+ y = 0;
+ } else if (e.clientY >= bounds.bottom) {
+ y = bounds.height - 1;
+ } else {
+ y = e.clientY - bounds.top;
+ }
+ this._pos = {x:x, y:y};
+ },
+
+ // ===== PUBLIC METHODS =====
+
+ grab: function () {
+ var c = this._target;
+
+ if (isTouchDevice) {
+ c.addEventListener('touchstart', this._eventHandlers.mousedown);
+ c.addEventListener('touchend', this._eventHandlers.mouseup);
+ c.addEventListener('touchmove', this._eventHandlers.mousemove);
+ }
+ c.addEventListener('mousedown', this._eventHandlers.mousedown);
+ c.addEventListener('mouseup', this._eventHandlers.mouseup);
+ c.addEventListener('mousemove', this._eventHandlers.mousemove);
+ c.addEventListener('wheel', this._eventHandlers.mousewheel);
+
+ /* Prevent middle-click pasting (see above for why we bind to document) */
+ document.addEventListener('click', this._eventHandlers.mousedisable);
+
+ /* preventDefault() on mousedown doesn't stop this event for some
+ reason so we have to explicitly block it */
+ c.addEventListener('contextmenu', this._eventHandlers.mousedisable);
+ },
+
+ ungrab: function () {
+ var c = this._target;
+
+ this._resetWheelStepTimers();
+
+ if (isTouchDevice) {
+ c.removeEventListener('touchstart', this._eventHandlers.mousedown);
+ c.removeEventListener('touchend', this._eventHandlers.mouseup);
+ c.removeEventListener('touchmove', this._eventHandlers.mousemove);
+ }
+ c.removeEventListener('mousedown', this._eventHandlers.mousedown);
+ c.removeEventListener('mouseup', this._eventHandlers.mouseup);
+ c.removeEventListener('mousemove', this._eventHandlers.mousemove);
+ c.removeEventListener('wheel', this._eventHandlers.mousewheel);
+
+ document.removeEventListener('click', this._eventHandlers.mousedisable);
+
+ c.removeEventListener('contextmenu', this._eventHandlers.mousedisable);
+ }
+};