PatternFly

Drag and drop

Beta

The drag and drop interaction can be used to reposition elements on screen into a layout that benefits the user. This gives the user more flexibility to arrange and/or group items without having to make code changes.

Info alert:Beta feature

This beta component is currently under review and is still open for further evolution. It is available for use in product. Beta components are considered for promotion on a quarterly basis. Please join in and give us your feedback or submit any questions on the PatternFly forum or via Slack. To learn more about the process, visit our about page or our Beta components page on GitHub.

Note: This drag and drop implementation lives in its own package at @patternfly/react-drag-drop!

Sorting demos

To enable drag and drop for compatible components, wrap the component with <DragDropSort>, define the variant property, and pass both the sortable items and onDrop callback to <DragDropSort>. <DragDropSort> will create the component's usual children internally based on the items property, so children should not be passed to the wrapped component.

Drag and drop sortable data list

To enable reordering in a <DataList>, wrap the <DataList> component with <DragDropSort> and define the variant as "DataList".

  • item-0
  • item-1
  • item-2
  • item-3
  • item-4
  • item-5
  • item-6
  • item-7
  • item-8
  • item-9

Drag and drop sortable dual list selector

To enable reordering in a <DualListSelector> pane wrap the <DualListSelectorList> component with <DragDropSort> and define the variant as "DualListSelectorList".

Available
0 of 3 options selected
  • Apple
  • Banana
  • Pineapple
Chosen
0 of 4 options selected

Multiple drop zone demos

To enable multiple drop zones, wrap the component with <DragDropContainer>, place one or more <Droppable> components within the container, and define the variant property on all components. A collection of all draggable items should be passed to <DragDropContainer>, and each <Droppable> should be passed their respective draggable items.

<Droppable> will create the component's usual children internally based on the items property, so children should not be passed where the <Droppable> is defined.

To avoid a wrapping div inserted by <Droppable>, pass the desired container element to the wrapper property.

Data list

To enable multiple drop zones with <DataList> components, place one or more <Droppable> within <DragDropContainer> and define the variant on all components as "DataList".

group 1

  • item-0
  • item-1
  • item-2
  • item-3
  • item-4

group 2

  • item-5
  • item-6
  • item-7
  • item-8
  • item-9

Dual list selector

To enable multiple drop zones in a <DualListSelector>, wrap the <DualListSelector> component with <DragDropContainer>, and then include a <Droppable> component within each pane. Both <DragDropContainer> and <Droppable> should define the variant property as "DualListSelectorList".

Available
0 of 3 options selected
Chosen
0 of 4 options selected

Props

DragDropSort

DragDropSortProps extends dnd-kit's props which may be viewed at https://docs.dndkit.com/api-documentation/context-provider#props.
*required
NameTypeDefaultDescription
itemsrequiredDraggableObject[]Sorted array of draggable objects
childrenReact.ReactElementCustom defined content wrapper for draggable items. By default, draggable items are wrapped in a styled div. Intended to be a 'DataList' or 'DualListSelectorList' without children.
onDrag(event: DragDropSortDragStartEvent, oldIndex: number) => void() => {}Callback when use begins dragging a draggable object
onDrop(event: DragDropSortDragEndEvent, items: DraggableObject[], oldIndex?: number, newIndex?: number) => void() => {}Callback when user drops a draggable object
overlayPropsanyAdditional classes to apply to the drag overlay
variant'default' | 'defaultWithHandle' | 'DataList' | 'DualListSelectorList' | 'TableComposable''default'The variant determines which component wraps the draggable object. Default and defaultWithHandle varaints wrap the draggable object in a div. DataList vairant wraps the draggable object in a DataListItem DualListSelectorList variant wraps the draggable objects in a DualListSelectorListItem and a div.pf-c-dual-list-selector__item-text element TableComposable variant wraps the draggable objects in TODO

DraggableObject

*required
NameTypeDefaultDescription
contentrequiredReact.ReactNodeContent rendered in the draggable object
idrequiredstring | numberUnique id of the draggable object
propsanyProps spread to the rendered wrapper of the draggable object

View source on GitHub