omicron-dnd v0.2.1

Omicron drag&drop

Omicron is a fast JavaScript drag-and-drop library for desktop and mobile browsers.

Basic usage: Demo (see code in JS Fiddle)

Test page: https://mcfrax.github.io/omicron-dnd/basic-example.html

Features

• excellent performance, can handle thousands of items across multiple containers
• remains reasonably responsive under heavy load
• supports touch devices
• supports nested containers
• CSS animation for moving items
• smooth autoscroll
• no dependencies

Basic usage

  import OmicronDnd from './omicron-dnd.js';

  ...

  const containerElement = document.getElementById('drag-container');
  OmicronDnd.init(container);

JS Fiddle

Configuration & API

(see source code comments for more details)

OmicronDnd.init(container, {
    // CSS selector for draggable children of the container.
    draggableSelector: null,
    // CSS selector for elements that can't be used to drag an item.
    filterSelector: null,
    // CSS selector for handle element.
    handleSelector: null,
    // Scale factor for making the dragged element smaller.
    floatElScale: 1,

    // Called just after the conditions for the drag start are met.
    onBeforeDragStart: null,
    // The element is actually being dragged now. The return value is ignored.
    onDragStart: null,
    // This will fire right after onDragStart and for every entered container.
    onContainerEntered: null,
    // This will fire at the end of the drag, too, before the drag finish events.
    onContainerLeft: null,
    // Called on change when container didn't change.
    onInternalChange: null,
    // Called on fromEl when toEl !== fromEl.
    onDropToOtherContainer: null,
    // Called on toEl when toEl !== fromEl.
    onDropFromOtherContainer: null,
    // The drag or pre-drag was finished.
    onDragFinished: null,
});

Why "Omicron"?

I started this project when I was sick with Covid-19 in December 2021. It probably wasn't Omicron variant, but I liked the sound of the name.