console.log(e)} /> \n}\n```\n\n## Why Pointer Events?\n\nMouse events and touch events are fundamentally different beasts in browsers today, and that makes it hard to write cross-platform apps.\n\nFor example, a simple finger paint app needs plenty of work to behave correctly with mouse and touch:\n\nCurrent platforms that implement touch events also provide mouse events for backward compatibility; however, only a subset of mouse events are fired and the semantics are changed.\n\n- Mouse events are only fired after the touch sequence ends.\n- Mouse events are not fired on elements without a `click` event handler. One must be attached by default, or directly on the element with `onclick`.\n- `click` events are not fired if the content of the page changes in a `mousemove` or `mouseover` event.\n- `click` events are fired 300ms after the touch sequence ends.\n- More information: [Apple Developer Documentation](http://developer.apple.com/library/safari/#documentation/appleapplications/reference/safariwebcontent/HandlingEvents/HandlingEvents.html).\n\nAdditionally, touch events are sent only to the element that received the `touchstart`. This is fundamentally different than mouse events, which fire on the element that is under the mouse. To make them behave similarly, touch events need to be retargeted with `document.elementFromPoint`.\n\nThese incompatibilities lead to applications having to listen to 2 sets of events, mouse on desktop and touch for mobile.\n\n**This forked interaction experience is cumbersome and hard to maintain.**\n\nInstead, there should exist a set of events that are normalized such that they behave exactly the same, no matter the source: touch, mouse, stylus, skull implant, etc. To do this right, this normalized event system needs to be available for all the web platform to use.\n\n*Thus, Pointer Events!*\n\n## Polyfill Limitations\n\n### touch-action\n\nAccording to the spec, the\n[touch-action](http://www.w3.org/TR/pointerevents/#the-touch-action-css-property) CSS property controls whether an element will perform a \"default action\" such as scrolling, or receive a continuous stream of pointer events.\n\nDue to the difficult nature of polyfilling new CSS properties, this library uses a touch-action *attribute* instead. For PEP to work correctly, you will therefore need to include `touch-action=\"...\"` attributes in your HTML that mirror any `touch-action:...` properties you have in your CSS.\n\n```\n\n...\n
...
\n```\nRun time changes involving the `touch-action` attribute are monitored using Mutation Observers for maximum flexibility.\n\nTouches will not generate events unless inside of an area that has a valid `touch-action` attribute defined. This is to maintain composition scrolling optimizations where possible.\n\n### Capturing Phase\n\nPEP does not currently polyfill the capturing phase for pointer events.\n\n## navigator.maxTouchPoints\n\nAs the information necessary to populate [`navigator.maxTouchPoints`](https://www.w3.org/TR/pointerevents/#extensions-to-the-navigator-interface) is not available in browsers that do not natively implement pointer events, PEP sets the value to `0`, which is \"the minimum number guaranteed to be recognized\" as required by the specification.\n\n### Browser Compatibility\n\nPEP should work on IE 10+ and the latest versions of Chrome, Safari, Firefox, and Opera. In any [browser implementing pointer events natively](http://caniuse.com/#feat=pointer) (detected by checking for `window.PointerEvent`), PEP won't do anything.\n\n## Building PEP\n\nIf you want to build PEP yourself from source, you'll need to install [Node.js](https://nodejs.org/en/download/) and run the following commands:\n\n```sh\n# Install all dependencies\nnpm install\n\n# Build PEP\nnpm run build\n```\n\nWhen the build completes, the generated files will be available in the `dist/` directory.\n\n*NOTE: Running the demos requires building PEP.*\n","maintainers":[{"name":"scott.gonzalez","email":"scott.gonzalez@gmail.com"},{"name":"ahocevar","email":"andreas.hocevar@gmail.com"},{"name":"drcmda","email":"drcmda@gmail.com"},{"name":"patrick_h_lauke","email":"redux@splintered.co.uk"}],"time":{"modified":"2022-06-23T18:02:50.992Z","created":"2015-04-21T13:40:36.485Z","0.3.0":"2015-04-21T13:40:36.485Z","0.4.0":"2015-11-05T14:45:36.916Z","0.4.1":"2016-01-14T17:59:51.018Z","0.4.2":"2016-09-29T14:36:22.619Z","0.4.3":"2017-05-07T14:00:51.688Z","0.5.0":"2019-04-02T15:46:58.810Z","0.5.1":"2019-04-11T07:33:14.029Z","0.5.2":"2019-04-15T17:42:12.081Z","0.5.3":"2020-12-01T15:07:11.372Z"},"homepage":"https://github.com/jquery/PEP#readme","repository":{"type":"git","url":"git://github.com/jquery/PEP.git"},"author":{"name":"jQuery Foundation and other contributors","url":"https://github.com/jquery/PEP/blob/master/AUTHORS.txt"},"bugs":{"url":"https://github.com/jquery/PEP/issues"},"readmeFilename":"README.md","users":{"movever":true,"cypark":true,"jez9999":true,"vorg":true,"daniel-zahariev":true},"license":"MIT"}