The width
read-only property of the PointerEvent
interface represents the width of the pointer's contact geometry along the x-axis, measured in CSS pixels. Depending on the source of the pointer device (such as a finger), for a given pointer, each event may produce a different value.
If the input hardware cannot report the contact geometry to the browser, the width defaults to 1
.
Syntax
var contactWidth = pointerEvent.width;
Return value
contactWidth
- The width of the event's contact area (in CSS pixels).
Example
This example illustrates using the PointerEvent
interface's width
and width
properties to calculate the contact area.
target.addEventListener("pointerdown", function(ev) { // Calculate the contact area var area = ev.width * ev.height; }, false);
Specifications
Specification | Status | Comment |
---|---|---|
Pointer Events – Level 2 The definition of 'width' in that specification. |
Editor's Draft | Non-stable version. |
Pointer Events The definition of 'width' in that specification. |
Recommendation | Initial definition. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | 55 | 12 | No 411 | 11 102 | 42 | No |
Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic support | 55 | 55 | 12 | No 411 | 11 102 | 42 | No |
1. From version 41: this feature is behind the dom.w3c_pointer_events.enabled
preference (needs to be set to true
). To change preferences in Firefox, visit about:config.
2. Returns values in screen pixels instead of CSS document pixels.