useDroppable
.png?alt=media&token=083911df-02fc-4aed-a81d-95e8edd2f65f)
interface UseDroppableArguments {
id: string | number;
disabled?: boolean;
data?: Record<string, any>;
}
The
id argument is a string or number that should be a unique identifier, meaning there should be no other droppable elements that share that same identifier within a given DndContext provider.If you're building a component that uses both the
useDroppable and useDraggable hooks, they can both share the same identifier since droppable elements are stored in a different key-value store than draggable elements.Since hooks cannot be conditionally invoked, use the
disabled argument and set it to true if you need to temporarily disable a droppable area.The
data argument is for advanced use-cases where you may need access to additional data about the droppable element in event handlers, modifiers or custom sensors.For example, if you were building a sortable preset, you could use the
data attribute to store the index of the droppable element within a sortable list to access it within a custom sensor.const {setNodeRef} = useDroppable({
id: props.id,
data: {
index: props.index,
},
});
Another more advanced example where the
data argument can be useful is create relationships between draggable nodes and droppable areas, for example, to specify which types of draggable nodes your droppable accepts:import {DndContext, useDraggable, useDroppable} from '@dnd-kit/core';
function Droppable() {
const {setNodeRef} = useDroppable({
id: 'droppable',
data: {
accepts: ['type1', 'type2'],
},
});
/* ... */
}
function Draggable() {
const {attributes, listeners, setNodeRef, transform} = useDraggable({
id: 'draggable',
data: {
type: 'type1',
},
});
/* ... */
}
function App() {
return (
<DndContext onDragEnd={handleDragEnd}>
/* ... */
</DndContext>
);
function handleDragEnd(event) {
const {active, over} = event;
if (over && over.data.current.accepts.includes(active.data.current.type)) {
// do stuff
}
}
}
{
rect: React.MutableRefObject<LayoutRect | null>;
isOver: boolean;
node: React.RefObject<HTMLElement>;
over: {id: UniqueIdentifier} | null;
setNodeRef(element: HTMLElement | null): void;
}
In order for the
useDroppable hook to function properly, it needs the setNodeRef property to be attached to the HTML element you intend on turning into a droppable area:function Droppable(props) {
const {setNodeRef} = useDroppable({
id: props.id,
});
return (
<div ref={setNodeRef}>
{/* ... */}
</div>
);
}
For advanced use cases, if you need the bounding rect measurement of the droppable area.
Use the
isOver boolean returned by the useDroppable hook to change the appearance or content displayed when a draggable element is dragged over your droppable container. If you'd like to change the appearance of the droppable in response to a draggable being dragged over a different droppable container, check whether the
over value is defined. Depending on your use-case, you can also read the id of the other droppable that the draggable item to make changes to the render output of your droppable component.Last modified 8mo ago