|
||
---|---|---|
.. | ||
__snapshots__ | ||
providers | ||
drag_drop.scss | ||
drag_drop.test.tsx | ||
drag_drop.tsx | ||
index.ts | ||
readme.md |
Drag / Drop
This is a simple drag / drop mechanism that plays nice with React.
We aren't using EUI or another library, due to the fact that Lens visualizations and datasources may or may not be written in React. Even visualizations which are written in React will end up having their own ReactDOM.render call, and in that sense will be a standalone React application. We want to enable drag / drop across React and native DOM boundaries.
Getting started
First, place a RootDragDropProvider at the root of your application.
<RootDragDropProvider>
... your app here ...
</RootDragDropProvider>
If you have a child React application (e.g. a visualization), you will need to pass the drag / drop context down into it. This can be obtained like so:
const context = useContext(DragContext);
In your child application, place a ChildDragDropProvider
at the root of that, and spread the context into it:
<ChildDragDropProvider {...context}>
... your child app here ...
</ChildDragDropProvider>
This enables your child application to share the same drag / drop context as the root application.
DragDropIdentifier
An item can be both draggable and droppable at the same time, but for simplicity's sake, we'll treat these two cases separately.
To enable dragging an item, use DragDrop
with both a draggable
and a value
attribute. Property value
has to be of a type object with a unique id
property.
<div className="field-list">
{fields.map((f) => (
<DragDrop key={f.id} className="field-list-item" value={f} draggable>
{f.name}
</DragDrop>
))}
</div>
Dropping
To enable dropping, use DragDrop
with both a droppable
attribute and an onDrop
handler attribute. Droppable should only be set to true if there is an item being dragged, and if a drop of the dragged item is supported.
const { dragging } = useContext(DragContext);
return (
<DragDrop
className="axis"
dropType={getDropProps(dragging)}
onDrop={(item) => onChange([...items, item])}
>
{items.map((x) => (
<div>{x.name}</div>
))}
</DragDrop>
);
Reordering
To create a reordering group, surround the elements from the same group with a ReorderProvider
:
<ReorderProvider id="groupId">
... elements from one group here ...
</ReorderProvider>
The children DragDrop
components must have props defined as in the example:
<ReorderProvider id="groupId">
<div className="field-list">
{fields.map((f) => (
<DragDrop
key={f.id}
draggable
droppable
dragType="move"
dropType="reorder"
reorderableGroup={fields} // consists all reorderable elements in the group, eg. [{id:'3'}, {id:'5'}, {id:'1'}]
value={{
id: f.id,
humanData: {
label: 'Label'
}
}}
onDrop={/*handler*/}
>
{f.name}
</DragDrop>
))}
</div>
</ReorderProvider>