An opinionated shim that polyfills HTML5 drag and drop support on mobile devices with Event.ComposedPath() support
Where I wander through the demos in this repo and talk about a little about the inner workings: https://www.youtube.com/watch?v=MUF6R-tk_vY
While this is in large part an ES Modules refactor of Bernado's dragdroptouch polyfill (which deserves the bulk of the love by the way), this version differs in two keys areas:
-
Re: finding the draggable. Uses event.composedPath() to allow use to hunt for draggables within open ShadowRoots
-
Re: finding the dropzone. Uses event.composedPath() to find the target shadowRoot, then uses DocumentOrShadowRoot.elementFromPoint to locate our dropzone target.
This allows it to be more readily be used with ShadowDOM and web components, which is my primary use case for it to be honest.
Install via yarn or npm:
yarn add @justinribeiro/html5-dragdroptouch-shim
Only load the module if device has touch support.
if ('ontouchstart' in document) {
import('@justinribeiro/html5-dragdroptouch-shim/dist/esm.js').then(module => {
const shim = new module.default();
});
status.textContent = 'TOUCH DETECTED: DragDropTouch shim loaded!';
} else {
status.textContent = 'NATIVE DRAGDROP DETECTED: no shim loaded.';
}
The class constructor can take an array of options if you want more control over the various triggers and delays within the shim:
import { default as DdtShim } from '@justinribeiro/html5-dragdroptouch-shim';
const opts = {
threshold = 5,
opacity = 0.8,
dblClick = 500,
ctxMenu = 900,
isPressHoldMode = 400,
pressHoldAwait = 400,
pressHoldMargin = 25,
pressHoldThreshold = 0
}
const startUpTheShim = new DdtShim(opts);
You can run the examples via the demo site.
There are a host of examples within the demo holder, including a set of example web components that support drag and drop and the shim. To run locally:
yarn dev