SilkTouch is a small library for handling touch event in mobile web apps.
In mobile browser, mainly Android Browser and iOS Safari, click event had a 300-350ms delay. Since the delay irritates users, we've had to handle it so as to react quickly to their tap operations. The good news is that in recent versions of those browsers it has been removed. However, we have to continue to handle it for a while to support older browsers.
This library will append the following viewport meta tag to a current page if not specified there.
<meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1">
If want to enable user-scalable, specify the viewport in advance. By the way, in iOS 10, the user-scalable=no is ignored. Take note if plan to support this version.
It will also append the following css if the browser supports it.
html {
touch-action: manipulation;
}
In this way, in recent browsers the delay is able to be removed. In older browsers, this library will remove it with own method (using a touchend event).
All the above are not applied to desktop browser. In any case, can handle touch event through the same interface.
via npm:
$ npm install silktouch
via Bower:
$ bower install silktouch
directly:
<script src="/path/to/silktouch.min.js"></script>
<body>
<div class="container">
<div id="block">SSS...</div>
</div>
</body>
document.addEventListener('DOMContentLoaded', function () {
// Initializing only once.
silktouch.enchant(document.querySelector('.container'));
// Register a new touch event.
silktouch.on('green', '#block', function () {
console.log('Creeper!');
});
}, false);
document.The enchant method initializes the SilkTouch object. This method must be called only once at the beginning. The baseElement will listen to all touch or click events for itsself and the descendant elements, and then dispatch them.
silktouch.enchant(); // equivalent to `silktouch.enchant(document)`
At least in iOS Safari, touch or click event usually will NOT be fired on the document. Thus, if your app supports iOS, the baseElement must be something other than it. The example is as follows:
<body>
<div class="container">
</div>
</body>
silktouch.enchant(document.querySelector('.container'));
The on method registers a new touch event, and returns the SilkTouch object.
<div id="cactus">block</div>
<div id="stone">block</div>
// method chaining
silktouch
.on('green', '#cactus', function () {
console.log('Creeper!');
})
.on('gray', '#stone', function () {
console.log('Skeleton!');
});
The one method registers a new touch event that is fired only once, and returns the SilkTouch object.
The off method deletes from the registered events, and returns the SilkTouch object.
silktouch.off('green');
// It's deleted all the events.
silktouch.off();
The suspend method suspends one or all of the registed events, and returns the SilkTouch object. The events won't be fired until it's called the resume method.
silktouch.suspend('gray');
// It's suspended all the events.
silktouch.suspend();
The resume method resumes one or all of the suspended events, and returns the SilkTouch object.
silktouch.resume('gray');
// It's resumed all the suspended events.
silktouch.resume();
The names method returns all the registered or suspended event names.
silktouch
.on('green', '#cactus', function () {
console.log('Creeper!');
})
.on('gray', '#stone', function () {
console.log('Skeleton!');
})
.suspend('gray');
console.log(silktouch.names()); // ['green', 'gray']
console.log(silktouch.names(true)); // ['gray']
You can use preventDefault in event handler.
silktouch.on('url-link', 'a', function (evt) {
// Prevents to jump to another page.
evt.preventDefault();
})
stopPropagation, too.
silktouch.on('absorbing', '.bubble', function (evt) {
// Prevents the event bubbling.
evt.stopPropagation();
})
Android Browser 4+, Chrome, Firefox, Safari, Edge and IE9+
MIT
FAQs
A small library for handling touch event in mobile web apps
The npm package silktouch receives a total of 0 weekly downloads. As such, silktouch popularity was classified as not popular.
We found that silktouch demonstrated a not healthy version release cadence and project activity because the last version was released a year ago.Ā It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Malicious PyPI checkers validate stolen emails against TikTok and Instagram APIs, enabling targeted account attacks and dark web credential sales.
Security News
The Node.js TSC opted not to endorse a feature bounty program, citing concerns about incentives, governance, and project neutrality.
Research
Security News
A look at the top trends in how threat actors are weaponizing open source packages to deliver malware and persist across the software supply chain.