MSPointer.capture allows you to optionally event.preventDefault the pointer events (was previously always on)

MSPointer.event now stores the most recent pointer event.
MSPointer.pointerDownCallback, pointerMoveCallback and pointerUpCallback all allow you to set your own event based callbacks.

Author: photonstorm

README.md

@@ -65,6 +65,9 @@ Version 2.3.0 - "Tarabon" - in dev
 * `Physics.Arcade.isPaused` allows you to toggle Arcade Physics processing on and off. If `true` the `Body.preUpdate` method will be skipped, halting all motion for all bodies. Note that other methods such as `collide` will still work, so be careful not to call them on paused bodies.
 * `Arcade.Body.friction` allows you to have more fine-grained control over the amount of velocity passed between bodies on collision.
 * BitmapData.text will render the given string to the BitmapData, with optional font, color and shadow settings.
+* MSPointer.capture allows you to optionally event.preventDefault the pointer events (was previously always on)
+* MSPointer.event now stores the most recent pointer event.
+* MSPointer.pointerDownCallback, pointerMoveCallback and pointerUpCallback all allow you to set your own event based callbacks.
 
 ### Updates
 

src/input/MSPointer.js

@@ -26,6 +26,34 @@ Phaser.MSPointer = function (game) {
     */
     this.callbackContext = this.game;
 
+    /**
+    * @property {function} pointerDownCallback - A callback that can be fired on a MSPointerDown event.
+    */
+    this.pointerDownCallback = null;
+
+    /**
+    * @property {function} pointerMoveCallback - A callback that can be fired on a MSPointerMove event.
+    */
+    this.pointerMoveCallback = null;
+
+    /**
+    * @property {function} pointerUpCallback - A callback that can be fired on a MSPointerUp event.
+    */
+    this.pointerUpCallback = null;
+
+    /**
+    * @property {boolean} capture - If true the Pointer events will have event.preventDefault applied to them, if false they will propagate fully.
+    */
+    this.capture = false;
+
+    /**
+    * The browser MSPointer DOM event. Will be null if no event has ever been received.
+    * Access this property only inside a Pointer event handler and do not keep references to it.
+    * @property {MSPointerEvent|null} event
+    * @default
+    */
+    this.event = null;
+
     /**
     * MSPointer input will only be processed if enabled.
     * @property {boolean} enabled
@@ -106,12 +134,23 @@ Phaser.MSPointer.prototype = {
     */
     onPointerDown: function (event) {
 
+        this.event = event;
+
+        if (this.capture)
+        {
+            event.preventDefault();
+        }
+
+        if (this.pointerDownCallback)
+        {
+            this.pointerDownCallback.call(this.callbackContext, event);
+        }
+
         if (!this.game.input.enabled || !this.enabled)
         {
             return;
         }
 
-        event.preventDefault();
         event.identifier = event.pointerId;
 
         this.game.input.startPointer(event);
@@ -125,12 +164,23 @@ Phaser.MSPointer.prototype = {
     */
     onPointerMove: function (event) {
 
+        this.event = event;
+
+        if (this.capture)
+        {
+            event.preventDefault();
+        }
+
+        if (this.pointerMoveCallback)
+        {
+            this.pointerMoveCallback.call(this.callbackContext, event);
+        }
+
         if (!this.game.input.enabled || !this.enabled)
         {
             return;
         }
 
-        event.preventDefault();
         event.identifier = event.pointerId;
 
         this.game.input.updatePointer(event);
@@ -144,12 +194,23 @@ Phaser.MSPointer.prototype = {
     */
     onPointerUp: function (event) {
 
+        this.event = event;
+
+        if (this.capture)
+        {
+            event.preventDefault();
+        }
+
+        if (this.pointerUpCallback)
+        {
+            this.pointerUpCallback.call(this.callbackContext, event);
+        }
+
         if (!this.game.input.enabled || !this.enabled)
         {
             return;
         }
 
-        event.preventDefault();
         event.identifier = event.pointerId;
 
         this.game.input.stopPointer(event);