React Movable Versions Save

The library is now pure ESM and it can't be loaded through require() anymore.

More details, questions, answers.

container

container?: Element;

Provide custom DOM element where moved item will be rendered.

When you start putting things like inputs into your list items, you could get into troubles. React Movable is now smarter and ignores mouse/keyboard inputs when you are trying to type or click. There's a new example:

Also, all deps are updated and React Hooks in all examples.

The drop is now animated so it provides user a nice visual feedback. Previously, it just re-appeared in the final position. The length of animation is controlled by the transitionDuration prop.

This release also fixes a bug when an item move far top didn't end up reordered.

Before

After

There is a new removableByMove top API that will allow you to remove items when being moved far left or right. PR. Example.

This also adds targetRect as an another parameter that's being passed to you through onChange callback. This can be useful when you want to detect where exactly the item was dropped.

There is a new top level API beforeDrag that allows to do some measurements of elements and implement a table with dynamic column widths.

Items now recognize disable: true prop that prevents them to be dragged. Example.

/* ... */
state = {
    items: [
      { label: 'Item 1' },
      { label: 'Item 2' },
      { label: 'Item 3' },
      { label: 'Item 4', disabled: true },
      { label: 'Item 5', disabled: true },
      { label: 'Item 6' }
    ]
  };
  render() {
    return (
      <List
        values={this.state.items}
/* ... */

You should notice a big improvement if you are using Safari on iOS. The drag and drop action will now block the scrolling. The previous version didn't do that and it made react-movable almost unusable on iOS.

It was necessary to overhaul some internal event handling. There is a slight API change in case you are using custom handle target. You should now mark it with data-movable-handle attribute as you can see here.

It's simple like this:

<button
  data-movable-handle
>
  MOVE HANDLE
</button>

If no element inside of the list item has data-movable-handle, the whole item is draggable.

renderItem is not passing onMouseDown and onTouchStart into your list items anymore. It's now handled globally via document.addEventListener. That was necessary to set these events as non-passive and enable scroll blocking in iOS Safari.

Also, you don't have to anymore event.stopPropagation on interactive elements (buttons etc) that are placed inside of your list items. Those are now filtered automatically when react-movable considers if the dnd action started.

So unless, you were somehow utilizing onMouseDown or onTouchStart, you can safely upgrade.

Flow types were fixed and updated as well.