tappify
v1.0.10
Published
A React.js library to detect touch/mobile/cursor
Downloads
11
Maintainers
Readme
Tappify.js
A lightweight zero dependency React.js library to handle the client's pointer. Easily detect client cursor type and hide/show html or perform custom logic!
Install
npm i tappify
Getting started
Basic hide/show
import Tappify from "tappify";
function myComponent() {
return <>
<Tappify.Finger>
Client is using finger 👉 *tap tap*
</Tappify.Finger>
<Tappify.Cursor>
Client is using mouse cursor 🖱️ *click click*
</Tappify.Cursor>
</>
}
Get the current pointer type
const isCursor = Tappify.isCursor(); // will be true if the pointer is mouse cursor. False if it's finger
Subscribe to pointer change
const unsubscribe = Tappify.subscribe(isCursor => {
if (isCursor) console.log("This client is now using a cursor");
else console.log("This client is now using a touch screen");
});
unsubscribe(); // it's strongly recommended to unsubscribe when component unmounts to avoid memory leaks
Live demo
Why Tappify?
With growing usage of touch screens on computer devices Tappify makes it seamless and easy to detect when user goes in or out of touch mode. In addition tappify provides an easy to use switch case scenario to handle different HTML elements depending on what pointer the client is using.
Tappify is completely event driven, that means no clocks/setintervals/requestAnimationFrame making it very preferment. It makes use of css's native @media condition to avoid any edge case bugs that JavaScript solutions might invoke.
How Tappify works
Tappify uses @media pointer rule to determine the pointer type. If a pointer change is detected the pointerChange event will be dispatched on window and thereafter notifying subscribers and updating the <Tappify.Cursor>
and <Tappify.Finger>
components.
Found an issue?
Please open a new issue on the Github repository
Want to contribute?
Simply create a new pull request on the pull requests tab.
Browser support
Tappify will work on all modern browsers. Tappify will not work on IE.