Component size, gzipped: 19kb

Drag and Drop List

Props

Style Overrides

items

['Item 1', 'Item 2', 'Item 3']

['Item 1', 'Item 2', 'Item 3']

removable

onChange

({oldIndex, newIndex}) =>
        setItems(newIndex === -1 ?
          arrayRemove(items, oldIndex) :
          arrayMove(items, oldIndex, newIndex))

({oldIndex, newIndex}) =>
        setItems(newIndex === -1 ?
          arrayRemove(items, oldIndex) :
          arrayMove(items, oldIndex, newIndex))

removableByMove

import * as React from "react";
import {
  List,
  arrayMove,
  arrayRemove
} from "baseui/dnd-list";

export default () => {
  const [items, setItems] = React.useState([
    "Item 1",
    "Item 2",
    "Item 3"
  ]);
  return (
    <List
      items={items}
      onChange={({ oldIndex, newIndex }) =>
        setItems(
          newIndex === -1
            ? arrayRemove(items, oldIndex)
            : arrayMove(items, oldIndex, newIndex)
        )
      }
    />
  );
}

import * as React from "react";
import {
  List,
  arrayMove,
  arrayRemove
} from "baseui/dnd-list";
export default () => {
  const [items, setItems] = React.useState([
    "Item 1",
    "Item 2",
    "Item 3"
  ]);
  return (
    <List
      items={items}
      onChange={({ oldIndex, newIndex }) =>
        setItems(
          newIndex === -1
            ? arrayRemove(items, oldIndex)
            : arrayMove(items, oldIndex, newIndex)
        )
      }
    />
  );
}

API

Allows users to create vertically sortable lists supporting drag and drop, touch or keyboard input.

When to use

When a user wants to change a collection order.

Accessibility

tab and shift+tab to focus items
space to lift or drop the item
j or arrow down to move the lifted item down
k or arrow up to move the lifted item up
escape to cancel the lift and return the item to its initial position

This component also supports iOS and Android browsers and screen readers.

Examples

Drag and Drop basic usage

Item 1
Item 2
Item 3
Item 4
Item 5
Item 6

Drag and Drop stateful usage

Item 1
Item 2
Item 3
Item 4
Item 5
Item 6

Drag and Drop with removable items

Item 1
Item 2
Item 3
Item 4
Item 5
Item 6

Drag and Drop with varying heights

Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Donec ornare.
Morbi malesuada id ante ac tincidunt. Phasellus at varius enim, fringilla pretium lorem. Integer placerat, est in aliquam tempus, ex urna hendrerit quam, eu sagittis nulla lorem eu magna.
Morbi nibh nunc.
Nunc consequat erat id ante mollis tincidunt in a nulla.

Drag and Drop with custom drag handle

Item 1
Item 2
Item 3
Item 4
Item 5
Item 6

Drag and Drop with label override

Item 1
Item 2
Item 3
Item 4
Item 5
Item 6

API

Dnd List props

Name	Type	Description
items	array	The total number of items to display.
onChange	function	MovableLists onChange handler.
overrides	custom	Lets you customize all aspects of the component.
removable	boolean	Indicates if items can be removed from the list.
removableByMove	boolean	Indicates if items can be removed from the list by dnd outside of the list.

Dnd List exports

You can import this module like so:

import {arrayMove} from 'baseui/dnd-list'

It exports the following components or utility functions: