@react-querybuilder/dnd

@react-querybuilder/dnd

Augments react-querybuilder with drag-and-drop functionality.

To see this in action, check out the react-querybuilder demo with the drag-and-drop option enabled.

Full documentation

Installation

npm i react-querybuilder @react-querybuilder/dnd
# OR yarn add / pnpm add / bun add

Then install the drag-and-drop library of your choice (see Adapters).

Usage

Nest QueryBuilder under a QueryBuilderDnD provider, passing an adapter to the dnd prop:

import { combine } from '@atlaskit/pragmatic-drag-and-drop/combine';
import {
  draggable,
  dropTargetForElements,
  monitorForElements,
} from '@atlaskit/pragmatic-drag-and-drop/element/adapter';
import { QueryBuilderDnD } from '@react-querybuilder/dnd';
import { createPragmaticDndAdapter } from '@react-querybuilder/dnd/pragmatic-dnd';
import { QueryBuilder } from 'react-querybuilder';

const dnd = createPragmaticDndAdapter({
  draggable,
  dropTargetForElements,
  monitorForElements,
  combine,
});

const App = () => (
  <QueryBuilderDnD dnd={dnd}>
    <QueryBuilder />
  </QueryBuilderDnD>
);

Adapters

@react-querybuilder/dnd uses an adapter pattern to support multiple drag-and-drop libraries without requiring all of them as dependencies. Each adapter is available as a separate subpath import, so only the library you use needs to be installed.

We recommend Pragmatic DnD if you have no other constraints.

Built-in adapters:

Adapter	Import path	Install
@atlaskit/pragmatic-drag-and-drop (recommended)	@react-querybuilder/dnd/pragmatic-dnd	@atlaskit/pragmatic-drag-and-drop
react-dnd	@react-querybuilder/dnd/react-dnd	react-dnd + react-dnd-html5-backend
@dnd-kit/core	@react-querybuilder/dnd/dnd-kit	@dnd-kit/core

You can also create custom adapters by implementing the DndAdapter interface (exported from @react-querybuilder/dnd). See the full documentation for details.

Notes

• QueryBuilderDnD automatically sets enableDragAndDrop to true on descendant QueryBuilder elements unless explicitly set to false.
• QueryBuilderDnD does not need to be an immediate ancestor to QueryBuilder.
• Multiple QueryBuilders may be nested beneath a single QueryBuilderDnD, and drag-and-drop works across them.
• If your application already uses react-dnd, use QueryBuilderDndWithoutProvider instead of QueryBuilderDnD to avoid conflicting DndProvider contexts.