Chrome 47 has a new feature that makes it easier to understand the how users interact with your site: InputDeviceCapabilities! Let’s step back a bit and learn why this is important.
DOM input events are an abstraction above low-level input events, loosely tied
to physical device input (e.g., click
events can be fired by a mouse,
touchscreen, or keyboard). However, there is a problem: there is no simple method
to obtain the details of the physical device responsible for an event.
In addition, certain types of input can generate further “fake” DOM input events for compatibility reasons. One such fake DOM event happens when a user taps a touch screen (such as on a mobile phone); it not only fires touch events but, for compatibility reasons, mouse events as well.
This causes problems for developers when supporting both mouse and touch input. It’s
difficult to know if a mousedown
event actually represents new input from a mouse, or
is just a compatibility event for a previously-processed touchstart event.
The new InputDeviceCapabilities
API provides details about the underlying
sources of input events via a sourceCapabilities
object on the UIEvent.
The object has a firesTouchEvents
property that is set to true
or false
based on how
the event was generated by the user action.
The question is: Where should this be used?
Outside of Pointer Events, many developers today handle the logic for interaction in the touch-layer, preventing Default to avoid creating “fake” mouse events in the first place.This design works well in many scenarios and doesn’t need to change to take advantage of InputDeviceCapabilities.
But in some scenarios you really don’t want to preventDefault the touch event;
for example, you still want taps to send ‘click’ events and change focus. For
these cases, the information held in the
MouseEvent.sourceCapabilities.firesTouchEvents
property allows you to start
consolidating the logic for touch- and mouse-based events into a model that is
similar to how you would manage the logic with Pointer Events. That is, you can
have just one set of code that manages the interaction logic and provides developers
a simpler way to share logic among browsers that do and don’t support Pointer Events.
function addMouseEventListener(target, type, handler, capture) {
target.addEventListener(type, function(e) {
if (e.sourceCapabilities.firesTouchEvents)
return false;
return handler(e);
}, capture);
}
The good news is that this has been Polyfilled by Rick Byers so that you can use it across most platforms.
Today this API is minimal, focused on solving a specific problem with
identifying mouse events derived from touch
events.
It is even possible to instantiate an instance of InputDeviceCapabilities
;
however, it only contains firesTouchEvents
. In the future it’s expected to
expand
to enable you to understand more about all of the input devices on a user’s
system. We would love to get your feedback on
use cases.