Skip to content

Sortable lists with Svelte 3. Animated, touch-friendly, and accessible.

Notifications You must be signed in to change notification settings

jwlarocque/svelte-dragdroplist

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Svelte-DragDropList

Sortable lists made with Svelte. Available from NPM!

Why this component?

  • Bidirectional binding - data order updates as soon as the user drags a list item into a new position, even before it is dropped
  • Full touch support - doesn't use the HTML5 drag and drop API
  • Accessible - includes buttons to move elements without dragging
  • Easier than writing a new one, probably.

Usage

Basic REPL
REPL with every feature!

The simplest way to use the component is to pass it an array of unique strings. If you bind:data, the source array will be updated as the user rearranges its items.

<script>
    import DragDropList from "svelte-dragdroplist";

    let data = ["Adams", "Boston", "Chicago", "Denver"];
</script>

<DragDropList bind:data={data}/>
Unique IDs

If you aren't sure that your strings will be unique, you should instead pass an array of objects, each with a unique ID:

let data = [{"id": 0, "text": "Boston"}, 
            {"id": 1, "text": "Boston"}, 
            {"id": 2, "text": "Chicago"}, 
            {"id": 3, "text": "Denver"}];
HTML

You can also include an "html" attribute instead of "text". It's up to you to make sure the html is clean.
If you want, you can even use both in one list.

let data = [{"id": 0, "text": "Adams"}, 
            {"id": 1, "text": "Boston"}, 
            {"id": 2, "html": "<p style='color: blue;'>Chicago</p>"}, 
            {"id": 3, "html": "<p style='color: red;'>Denver</p>"}];
Removable Items

A delete button can be added to each item with the removesItems prop:

<DragDropList bind:data={data} removesItems={true}/>

Note: adding items is as simple as adding them to the data array.

Styling

To style the list and its elements from a parent component or global stylesheet, prefix your selectors with .dragdroplist. You may need to increase the specificity of your selectors or even use the !important rule in order to override the classes applied by Svelte. For example:

:global(.dragdroplist) {} /* entire component */
:global(.dragdroplist > .list > div.item) {} /* list item */
:global(.dragdroplist div.buttons > button.down) {} /* move down button */
:global(.dragdroplist div.content) {} /* text/html contents of item */

If you only need to style the contents of an item, you can also use an object with an html property as described above.

In Progress

  • Additional animations on drop

About

Sortable lists with Svelte 3. Animated, touch-friendly, and accessible.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages