Link Search Menu Expand Document

bcx-aurelia-dnd

A generic drag-and-drop lib mainly for Aurelia, mobile friendly, with APIs fit in MVC/MVVM natively.

Get Started View on Github

bcx-aurelia-reorderable-repeat

Built on top of bcx-aurelia-dnd, a customised Aurelia repeater that supports drag-and-drop reordering automatically.

Get Started View on Github


bcx-aurelia-dnd use dragula algorithm, but is not just a dragula wrapper

bcx-aurelia-dnd use dragula’s algorithm to avoid native HTML5 DnD API, but doesn’t inherit or expose any dragula API (they don’t even exist in the code). APIs are designed to fit in MVC/MVVM natively.

Why based on dragula, not native HTML5 DnD API

dragula implements DnD in plain mouse/touch events, not in native HTML5 DnD API. Here is the place where we were introduced to dragula, it has some links for issues around native HTML5 DnD API. It resonated with our experience on React DnD which uses native HTML5 DnD API. We had issues on nested source/target and some annoying browser behaviour (cursor in IE) in native HTML5 DnD API. None of that affected our dragula based DnD.

Another bonus of dragula, it supports mobile devices. All examples here works on iPad and phones.

Inspired by react-dnd

The API design is heavily inspired by react-dnd. And it is largely simplified because of Aurelia’s ability to observe plain JavaScript object.

bcx-aurelia-dnd is not an Aurelia plugin

Technically, bcx-aurelia-dnd doesn’t depend on Aurelia, it only uses aurelia-event-aggregator to provide better integration with Aurelia. There is nothing preventing you from using it with other front-end frameworks or even vanilla JavaScript.

Alternative projects

There are few alternative projects in Aurelia community. List them here for reference.

  1. aurelia-dragula
    • a dragula wrapper to provide convenient interface to Aurelia. Handy to existing dragula users.
  2. oribella-aurelia-sortable
    • based on very interesting oribella, can sort list or multiple lists.
  3. aurelia-sortablejs
    • based on Sortablejs, can sort list or multiple lists, visually appealing.

License

bcx-aurelia-dnd is licensed under the MIT license.