Giter Club home page Giter Club logo

svelte-drag-drop-touch's Introduction

svelte-drag-drop-touch

HTML5 Drag-and-Drop support for mobile devices (not only for Svelte)

NPM users: please consider the Github README for the latest description of this package (as updating the docs would otherwise always require a new NPM package version)

Just a small note: if you like this module and plan to use it, consider "starring" this repository (you will find the "Star" button on the top right of this page), so that I know which of my repositories to take most care of.

Installation

svelte-drag-drop-touch may be used as an ECMAScript module (ESM), a CommonJS or AMD module or from a global variable.

You may either install the package into your build environment using NPM with the command

npm install svelte-drag-drop-touch

or load the plain script file directly

<script src="https://unpkg.com/svelte-drag-drop-touch"></script>

Access

When used within Svelte, you should always import the package in a module context:

<script context="module">
  import DragDropTouch from 'svelte-drag-drop-touch'
</script>

Otherwise, the kind of import depends on the type of module you prefer.

  • ESM: import DragDropTouch from 'svelte-drag-drop-touch'
  • CommonJS: const DragDropTouch = require('svelte-drag-drop-touch')
  • AMD: require(['svelte-drag-drop-touch'], (DragDropTouch) => {...})

In any case, a simple import is all you need to use HTML5 Drag-and-Drop on mobile devices - (apart from handling DragEvents) there is no extra programming required.

Example

Several examples are available on the Svelte REPL - feel free to play with them! The most basic one is

Additional, more detailled examples may be found below.

Background Information

Bernardo Castilho has written a nice (and lightweight) Drag-and-Drop polyfill which brings HTML5 Drag-and-Drop capabilities to mobile devices. Unfortunately, the NPM package for that polyfill is outdated and does not seem to be updated.

svelte-drag-drop-touch just brings a TypeScript definition file and a trivial wrapper around the original code and bundles these with the latest version of DragDropTouch.js into an NPM package that may easily be imported into (not only) a Svelte application.

All the heavy lifting is done by DragDropTouch.js, thus, all credits go to Bernardo Castilho!

Additional Examples

Build Instructions

You may easily build this package yourself.

Just install NPM according to the instructions for your platform and follow these steps:

  1. either clone this repository using git or download a ZIP archive with its contents to your disk and unpack it there
  2. open a shell and navigate to the root directory of this repository
  3. run npm install in order to install the complete build environment
  4. execute npm run build to create a new build

You may also look into the author's build-configuration-study for a general description of his build environment.

License

MIT License

svelte-drag-drop-touch's People

Contributors

rozek avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

svelte-drag-drop-touch's Issues

"Cannot find module 'svelte-drag-drop-touch' or its corresponding type declarations."

Hi, first of all thank you for this amazing lib.

I'm not finding a compelling reason to get the error message in title: "Cannot find module 'svelte-drag-drop-touch' or its corresponding type declarations.". Just did a normal npm install as per instructions.

Since you're wrapping other core dependency, what i'm doing to circumvent this is importing from "dragdroptouch-bug-fixed" directly, like this:

import DragDropTouch from "dragdroptouch-bug-fixed";

This works for me.

Any tips?

Thanks,
Nuno

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.