Moving to gesture-based event handling

This commit is contained in:
Max Lynch
2013-08-26 15:53:57 -05:00
parent 8a8dab2598
commit f6b91c33e3
5 changed files with 402 additions and 130 deletions

22
example/adams/events.html Normal file
View File

@ -0,0 +1,22 @@
<html>
<head>
<meta charset="utf-8">
<title>Example</title>
<!-- Sets initial viewport load and disables zooming -->
<meta name="viewport" content="initial-scale=1, maximum-scale=1, user-scalable=no">
<link rel="stylesheet" href="../../dist/framework-with-theme.css">
<link rel="stylesheet" href="app.css">
<script>
</script>
</head>
<body>
<div class="content content-padded">
<a href="#" class="button button-success">Tap me!</a>
<a href="#" class="button button-success">Swipe me!</a>
<div id="event-log"></div>
</div>
<script src="../../js/framework/framework-events.js"></script>
<script src="events.js"></script>
</body>
</html>

View File

@ -13,8 +13,10 @@
<body> <body>
<div class="content content-padded"> <div class="content content-padded">
<a href="#" class="button button-success">Tap me!</a> <a href="#" class="button button-success">Tap me!</a>
<a href="#" class="button button-success">Swipe me!</a>
<div id="event-log"></div> <div id="event-log"></div>
</div> </div>
<script src="../../js/framework/framework-gestures.js"></script>
<script src="../../js/framework/framework-events.js"></script> <script src="../../js/framework/framework-events.js"></script>
<script src="events.js"></script> <script src="events.js"></script>
</body> </body>

View File

@ -12,3 +12,10 @@ window.FM.on('tap', function(e) {
event: e event: e
}); });
}); });
window.FM.on('touch', function(e) {
console.log('GOT TOUCH', e);
logEvent({
type: 'touch',
event: e
});
});

View File

@ -11,150 +11,124 @@
*/ */
(function(window, document, framework) { (function(window, document, framework) {
framework.EventController = function (){}; framework.EventController = {
// A map of event types that we virtually detect and emit
framework.EventController.prototype.VIRTUAL_EVENT_TYPES = ['tap', 'swipeleft', 'swiperight'];
// A map of event types that we virtually detect and emit
VIRTUAL_EVENT_TYPES: ['tap', 'swipeleft', 'swiperight'],
/** /**
* Trigger a new event. * Trigger a new event.
*/ */
framework.EventController.prototype.trigger = function(eventType, data) { trigger: function(eventType, data) {
// TODO: Do we need to use the old-school createEvent stuff? // TODO: Do we need to use the old-school createEvent stuff?
window.dispatchEvent(new CustomEvent(eventType, data)); window.dispatchEvent(new CustomEvent(eventType, data));
}; },
/** /**
* Shorthand for binding a new event listener to the given * Shorthand for binding a new event listener to the given
* event type. * event type.
*/ */
framework.EventController.prototype.on = function(type, callback, element) { on: function(type, callback, element) {
var i; var i;
var e = element || window; var e = element || window;
/* /*
var virtualTypes = framework.EventController.VIRTUAL_EVENT_TYPES; var virtualTypes = framework.EventController.VIRTUAL_EVENT_TYPES;
for(i = 0; i < virtualTypes.length; i++) { for(i = 0; i < virtualTypes.length; i++) {
if(type.toLowerCase() == virtualTypes[i]) { if(type.toLowerCase() == virtualTypes[i]) {
// TODO: listen for virtual event // TODO: listen for virtual event
return;
}
}
*/
// Native listener
e.addEventListener(type, callback);
},
/**
* Process a touchstart event.
*/
handleTouchStart: function(e) {
console.log("EVENT: touchstart", e);
framework.GestureController.detectGesture(e);
},
/**
* Process a touchmove event.
*/
handleTouchMove: function(e) {
console.log("EVENT: touchmove", e);
framework.GestureController.detectGesture(e);
},
/**
* Process a touchend event.
*/
handleTouchEnd: function(e) {
console.log("EVENT: touchend", e);
framework.GestureController.detectGesture(e);
},
/**
* Process a touchcancel event.
*/
handleTouchCancel: function(e) {
this._hasMoved = false;
this._touchStartX = null;
this._touchStartY = null;
},
// With a click event, we need to check the target
// and if it's an internal target that doesn't want
// a click, cancel it
handleClick: function(e) {
var target = e.target;
if (
! target
|| e.which > 1
|| e.metaKey
|| e.ctrlKey
//|| isScrolling
|| location.protocol !== target.protocol
|| location.host !== target.host
// Not sure abotu this one
//|| !target.hash && /#/.test(target.href)
|| target.hash && target.href.replace(target.hash, '') === location.href.replace(location.hash, '')
//|| target.getAttribute('data-ignore') == 'push'
) {
// Allow it
console.log("EVENT: click", e);
return; return;
} }
} // We need to cancel this one
*/ e.preventDefault();
// Native listener // TODO: should we do this?
e.addEventListener(type, callback); // e.stopPropagation();
}; },
/**
* Process a touchstart event.
*/
framework.EventController.prototype.handleTouchStart = function(e) {
console.log("EVENT: touchstart", e);
if(e.type === 'touchstart') {
// We are now touching
this._isTouching = true;
}
// Reset the movement indicator handlePopState: function(event) {
this._hasMoved = false; console.log("EVENT: popstate", event);
},
// Store touch coords
this._touchStartX = e.type === 'touchstart' ? e.touches[0].clientX : e.clientX;
this._touchStartY = e.type === 'touchstart' ? e.touches[0].clientY : e.clientY;
}; };
/**
* Process a touchmove event.
*/
framework.EventController.prototype.handleTouchMove = function(e) {
console.log("EVENT: touchmove", e);
var x = e.type === 'touchmove' ? e.touches[0].clientX : e.clientX,
y = e.type === 'touchmove' ? e.touches[0].clientY : e.clientY;
// Check if the finger moved more than 10px, and then indicate we should cancel the tap
if (Math.abs(x - this._touchStartX) > 10 || Math.abs(y - this._touchStartY) > 10) {
this._hasMoved = true;
console.log('DID MOVE');
}
};
/**
* Process a touchend event.
*/
framework.EventController.prototype.handleTouchEnd = function(e) {
console.log("EVENT: touchend", e);
if(this._isTouching && !this._hasMoved) {
console.log("EVENT: (virtual) tap", event);
framework.trigger('tap', {
bubbles: true,
cancelable: true
});
}
framework.EventController._isTouching = false;
};
/**
* Process a touchcancel event.
*/
framework.EventController.prototype.handleTouchCancel = function(e) {
this._hasMoved = false;
this._touchStartX = null;
this._touchStartY = null;
};
// With a click event, we need to check the target
// and if it's an internal target that doesn't want
// a click, cancel it
framework.EventController.prototype.handleClick = function(e) {
var target = e.target;
if (
! target
|| e.which > 1
|| e.metaKey
|| e.ctrlKey
//|| isScrolling
|| location.protocol !== target.protocol
|| location.host !== target.host
// Not sure abotu this one
//|| !target.hash && /#/.test(target.href)
|| target.hash && target.href.replace(target.hash, '') === location.href.replace(location.hash, '')
//|| target.getAttribute('data-ignore') == 'push'
) {
// Allow it
console.log("EVENT: click", e);
return;
}
// We need to cancel this one
e.preventDefault();
// TODO: should we do this?
// e.stopPropagation();
}
framework.EventController.prototype.handlePopState = function(event) {
console.log("EVENT: popstate", event);
}
// Map some convenient top-level functions for event handling // Map some convenient top-level functions for event handling
framework.on = framework.EventController.prototype.on; framework.on = framework.EventController.on;
framework.trigger = framework.EventController.prototype.trigger; framework.trigger = framework.EventController.trigger;
// Set up various listeners // Set up various listeners
window.addEventListener('touchstart', framework.EventController.prototype.handleTouchStart); window.addEventListener('touchstart', framework.EventController.handleTouchStart);
window.addEventListener('touchmove', framework.EventController.prototype.handleTouchMove); window.addEventListener('touchmove', framework.EventController.handleTouchMove);
window.addEventListener('touchcancel', framework.EventController.prototype.handleTouchCancel); window.addEventListener('touchcancel', framework.EventController.handleTouchCancel);
window.addEventListener('touchend', framework.EventController.prototype.handleTouchEnd); window.addEventListener('touchend', framework.EventController.handleTouchEnd);
window.addEventListener('click', framework.EventController.prototype.handleClick); window.addEventListener('click', framework.EventController.handleClick);
window.addEventListener('popstate', framework.EventController.prototype.handlePopState); window.addEventListener('popstate', framework.EventController.handlePopState);
})(this, document, FM = this.FM || {}); })(this, document, FM = this.FM || {});

View File

@ -0,0 +1,267 @@
/**
* Simple gesture controllers with some common gestures that emit
* gesture events.
*
* Much adapted from github.com/EightMedia/Hammer.js
*/
(function(window, document, framework) {
// Gesture support
framework.Gesture = {}
// Simple touch gesture that triggers an event when an element is touched
framework.Gesture.Touch = {
handle: function(e) {
framework.EventController.trigger('touch', {
cancelable: true,
bubbles: true
});
}
};
// Simple tap gesture
framework.Gesture.Tap = {
handle: function(e) {
switch(e.type) {
case 'touchstart':
// We are now touching
this._isTouching = true;
// Reset the movement indicator
this._hasMoved = false;
break;
case 'touchmove':
this._touchStartX = e.type === 'touchstart' ? e.touches[0].clientX : e.clientX;
this._touchStartY = e.type === 'touchstart' ? e.touches[0].clientY : e.clientY;
var x = e.type === 'touchmove' ? e.touches[0].clientX : e.clientX,
y = e.type === 'touchmove' ? e.touches[0].clientY : e.clientY;
// Check if the finger moved more than 10px, and then indicate we should cancel the tap
if (Math.abs(x - this._touchStartX) > 10 || Math.abs(y - this._touchStartY) > 10) {
this._hasMoved = true;
}
break;
case 'touchend':
if(this._hasMoved == false) {
framework.EventController.trigger('tap', {
cancelable: true,
bubbles: true
});
}
break;
}
}
};
// A swipe-left gesture that emits the 'swipeleft' event when a left swipe
// is performed
framework.Gesture.SwipeLeft = {
handle: function(e) {
}
};
framework.GestureController = {
gestures: [
framework.Gesture.Touch,
framework.Gesture.Tap
],
detectGesture: function(e) {
var i;
for(i = 0; i < this.gestures.length; i++) {
if(this.gestures[i].handle(e)) {
console.log('GESTURECONTROLLER: Gesture handled');
return;
}
}
},
/**
* find if a node is in the given parent
* used for event delegation tricks
* @param {HTMLElement} node
* @param {HTMLElement} parent
* @returns {boolean} has_parent
*/
hasParent: function(node, parent) {
while(node){
if(node == parent) {
return true;
}
node = node.parentNode;
}
return false;
},
/**
* get the center of all the touches
* @param {Array} touches
* @returns {Object} center
*/
getCenter: function getCenter(touches) {
var valuesX = [], valuesY = [];
for(var t= 0,len=touches.length; t<len; t++) {
valuesX.push(touches[t].pageX);
valuesY.push(touches[t].pageY);
}
return {
pageX: ((Math.min.apply(Math, valuesX) + Math.max.apply(Math, valuesX)) / 2),
pageY: ((Math.min.apply(Math, valuesY) + Math.max.apply(Math, valuesY)) / 2)
};
},
/**
* calculate the velocity between two points
* @param {Number} delta_time
* @param {Number} delta_x
* @param {Number} delta_y
* @returns {Object} velocity
*/
getVelocity: function getVelocity(delta_time, delta_x, delta_y) {
return {
x: Math.abs(delta_x / delta_time) || 0,
y: Math.abs(delta_y / delta_time) || 0
};
},
/**
* calculate the angle between two coordinates
* @param {Touch} touch1
* @param {Touch} touch2
* @returns {Number} angle
*/
getAngle: function getAngle(touch1, touch2) {
var y = touch2.pageY - touch1.pageY,
x = touch2.pageX - touch1.pageX;
return Math.atan2(y, x) * 180 / Math.PI;
},
/**
* angle to direction define
* @param {Touch} touch1
* @param {Touch} touch2
* @returns {String} direction constant, like Hammer.DIRECTION_LEFT
*/
getDirection: function getDirection(touch1, touch2) {
var x = Math.abs(touch1.pageX - touch2.pageX),
y = Math.abs(touch1.pageY - touch2.pageY);
if(x >= y) {
return touch1.pageX - touch2.pageX > 0 ? Hammer.DIRECTION_LEFT : Hammer.DIRECTION_RIGHT;
}
else {
return touch1.pageY - touch2.pageY > 0 ? Hammer.DIRECTION_UP : Hammer.DIRECTION_DOWN;
}
},
/**
* calculate the distance between two touches
* @param {Touch} touch1
* @param {Touch} touch2
* @returns {Number} distance
*/
getDistance: function getDistance(touch1, touch2) {
var x = touch2.pageX - touch1.pageX,
y = touch2.pageY - touch1.pageY;
return Math.sqrt((x*x) + (y*y));
},
/**
* calculate the scale factor between two touchLists (fingers)
* no scale is 1, and goes down to 0 when pinched together, and bigger when pinched out
* @param {Array} start
* @param {Array} end
* @returns {Number} scale
*/
getScale: function getScale(start, end) {
// need two fingers...
if(start.length >= 2 && end.length >= 2) {
return this.getDistance(end[0], end[1]) /
this.getDistance(start[0], start[1]);
}
return 1;
},
/**
* calculate the rotation degrees between two touchLists (fingers)
* @param {Array} start
* @param {Array} end
* @returns {Number} rotation
*/
getRotation: function getRotation(start, end) {
// need two fingers
if(start.length >= 2 && end.length >= 2) {
return this.getAngle(end[1], end[0]) -
this.getAngle(start[1], start[0]);
}
return 0;
},
/**
* boolean if the direction is vertical
* @param {String} direction
* @returns {Boolean} is_vertical
*/
isVertical: function isVertical(direction) {
return (direction == Hammer.DIRECTION_UP || direction == Hammer.DIRECTION_DOWN);
},
/**
* stop browser default behavior with css props
* @param {HtmlElement} element
* @param {Object} css_props
*/
stopDefaultBrowserBehavior: function stopDefaultBrowserBehavior(element, css_props) {
var prop,
vendors = ['webkit','khtml','moz','Moz','ms','o',''];
if(!css_props || !element.style) {
return;
}
// with css properties for modern browsers
for(var i = 0; i < vendors.length; i++) {
for(var p in css_props) {
if(css_props.hasOwnProperty(p)) {
prop = p;
// vender prefix at the property
if(vendors[i]) {
prop = vendors[i] + prop.substring(0, 1).toUpperCase() + prop.substring(1);
}
// set the style
element.style[prop] = css_props[p];
}
}
}
// also the disable onselectstart
if(css_props.userSelect == 'none') {
element.onselectstart = function() {
return false;
};
}
// and disable ondragstart
if(css_props.userDrag == 'none') {
element.ondragstart = function() {
return false;
};
}
}
}
})(this, document, FM = this.FM || {});