Map browser event handling for touch devices

By handling click, dblckick and drag sequences in MapBrowserEvent, we can overcome closure issues with touch events. In particular, these issues were double drag events (from mousemove and touchmove) and a missing dblclick event on touch devices.
This commit is contained in:
ahocevar
2012-09-25 17:27:17 +02:00
parent b151304630
commit ce977e5364
4 changed files with 266 additions and 46 deletions
+242
View File
@@ -1,6 +1,11 @@
goog.provide('ol.MapBrowserEvent');
goog.provide('ol.MapBrowserEvent.EventType');
goog.provide('ol.MapBrowserEventHandler');
goog.require('goog.asserts');
goog.require('goog.events.BrowserEvent');
goog.require('goog.events.EventTarget');
goog.require('goog.events.EventType');
goog.require('goog.style');
goog.require('ol.Coordinate');
goog.require('ol.MapEvent');
@@ -51,3 +56,240 @@ ol.MapBrowserEvent.prototype.getCoordinate = function() {
return coordinate;
}
};
/**
* @return {boolean} Do we have a left click?
*/
ol.MapBrowserEvent.prototype.isMouseActionButton = function() {
// always assume a left-click on touch devices
return ('ontouchstart' in document.documentElement) ||
this.browserEvent.isMouseActionButton();
};
/**
* @param {ol.Map} map The map with the viewport to listen to events on.
* @constructor
* @extends {goog.events.EventTarget}
*/
ol.MapBrowserEventHandler = function(map) {
/**
* This is the element that we will listen to the real events on.
* @type {ol.Map}
* @private
*/
this.map_ = map;
/**
* @type {Object}
* @private
*/
this.previous_ = null;
/**
* @type {boolean}
* @private
*/
this.dragged_ = false;
/**
* @type {number|undefined}
* @private
*/
this.timestamp_;
/**
* @type {Array.<number>}
* @private
*/
this.dragListenerKeys_ = null;
/**
* @type {goog.events.BrowserEvent}
* @private
*/
this.down_ = null;
/**
* @type {boolean}
* @private
*/
this.isTouch_ = document && ('ontouchstart' in document.documentElement);
var element = this.map_.getViewport();
goog.events.listen(element,
this.isTouch_ ?
goog.events.EventType.TOUCHSTART :
goog.events.EventType.MOUSEDOWN,
this.dragstart_, false, this);
goog.events.listen(element,
this.isTouch_ ?
goog.events.EventType.TOUCHEND :
goog.events.EventType.MOUSEUP,
this.dblclick_, false, this);
goog.events.listen(element,
goog.events.EventType.CLICK, this.click_, false, this);
};
goog.inherits(ol.MapBrowserEventHandler, goog.events.EventTarget);
/**
* @param {goog.events.BrowserEvent} browserEvent Browser event.
* @private
*/
ol.MapBrowserEventHandler.prototype.touchEnableBrowserEvent_ =
function(browserEvent) {
if (this.isTouch_) {
goog.asserts.assert(browserEvent instanceof goog.events.BrowserEvent);
var nativeEvent = browserEvent.getBrowserEvent();
if (nativeEvent.touches && nativeEvent.touches.length) {
var nativeTouch = nativeEvent.touches[0];
browserEvent.clientX = nativeTouch.clientX;
browserEvent.clientY = nativeTouch.clientY;
}
}
};
/**
* @param {goog.events.BrowserEvent} browserEvent Browser event.
* @private
*/
ol.MapBrowserEventHandler.prototype.click_ = function(browserEvent) {
if (!this.dragged_) {
this.touchEnableBrowserEvent_(browserEvent);
var newEvent = new ol.MapBrowserEvent(
ol.MapBrowserEvent.EventType.CLICK, this.map_, browserEvent);
this.down_ = null;
this.dispatchEvent(newEvent);
}
};
/**
* @param {goog.events.BrowserEvent} browserEvent Browser event.
* @private
*/
ol.MapBrowserEventHandler.prototype.dblclick_ = function(browserEvent) {
if (!this.dragged_) {
var now = new Date().getTime();
if (!this.timestamp_ || now - this.timestamp_ > 250) {
this.timestamp_ = now;
} else {
this.timestamp_ = undefined;
this.touchEnableBrowserEvent_(this.down_);
var newEvent = new ol.MapBrowserEvent(
ol.MapBrowserEvent.EventType.DBLCLICK, this.map_, this.down_);
this.down_ = null;
this.dispatchEvent(newEvent);
}
}
};
/**
* @param {goog.events.BrowserEvent} browserEvent Browser event.
* @private
*/
ol.MapBrowserEventHandler.prototype.dragstart_ = function(browserEvent) {
if (!this.previous_) {
this.touchEnableBrowserEvent_(browserEvent);
this.previous_ = {
clientX: browserEvent.clientX,
clientY: browserEvent.clientY
};
this.down_ = browserEvent;
this.dragged_ = false;
if (this.isTouch_) {
this.dragListenerKeys_ = [
goog.events.listen(document,
goog.events.EventType.TOUCHMOVE, this.drag_, false, this),
goog.events.listen(document,
goog.events.EventType.TOUCHEND, this.dragend_, false, this)
];
} else {
this.dragListenerKeys_ = [
goog.events.listen(document,
goog.events.EventType.MOUSEMOVE, this.drag_, false, this),
goog.events.listen(document,
goog.events.EventType.MOUSEUP, this.dragend_, false, this)
];
}
var newEvent = new ol.MapBrowserEvent(
ol.MapBrowserEvent.EventType.DRAGSTART, this.map_, browserEvent);
this.dispatchEvent(newEvent);
}
};
/**
* @param {goog.events.BrowserEvent} browserEvent Browser event.
* @private
*/
ol.MapBrowserEventHandler.prototype.drag_ = function(browserEvent) {
this.dragged_ = true;
this.touchEnableBrowserEvent_(browserEvent);
this.previous_ = {
clientX: browserEvent.clientX,
clientY: browserEvent.clientY
};
// prevent viewport dragging on touch devices
browserEvent.preventDefault();
var newEvent = new ol.MapBrowserEvent(
ol.MapBrowserEvent.EventType.DRAG, this.map_, browserEvent);
this.dispatchEvent(newEvent);
};
/**
* @param {goog.events.BrowserEvent} browserEvent Browser event.
* @private
*/
ol.MapBrowserEventHandler.prototype.dragend_ = function(browserEvent) {
if (this.previous_) {
goog.array.forEach(this.dragListenerKeys_, goog.events.unlistenByKey);
this.dragListenerKeys_ = null;
this.previous_ = null;
var newEvent = new ol.MapBrowserEvent(
ol.MapBrowserEvent.EventType.DRAGEND, this.map_, browserEvent);
this.down_ = null;
this.dispatchEvent(newEvent);
}
};
/** @override */
ol.MapBrowserEventHandler.prototype.disposeInternal = function() {
var element = this.map_.getViewport();
goog.events.unlisten(element,
this.isTouch_ ?
goog.events.EventType.TOUCHSTART :
goog.events.EventType.MOUSEDOWN,
this.dragstart_, false, this);
goog.events.unlisten(element,
this.isTouch_ ?
goog.events.EventType.TOUCHEND :
goog.events.EventType.MOUSEUP,
this.dblclick_, false, this);
goog.events.unlisten(element,
goog.events.EventType.CLICK, this.click_, false, this);
goog.asserts.assert(goog.isDef(this.dragListenerKeys_));
goog.array.forEach(this.dragListenerKeys_, goog.events.unlistenByKey);
this.dragListenerKeys_ = null;
};
/**
* Constants for event names.
* @enum {string}
*/
ol.MapBrowserEvent.EventType = {
CLICK: goog.events.EventType.CLICK,
DBLCLICK: goog.events.EventType.DBLCLICK,
DRAGSTART: 'dragstart',
DRAG: 'drag',
DRAGEND: 'dragend'
};