Skip to Content
Vue Flow v2 is here and joins xyflow! Read more here →
ExamplesInteraction

Drag and Drop

In these examples, we use a custom Sidebar component to create new nodes when dragging from the sidebar into the Vue Flow pane.

Drag and Drop with HTML Drag and Drop API

The HTML Drag and Drop API is a native API that is supported by all major browsers. It is a simple API that allows you to drag and drop elements between different elements on the page.

Note: HTML Drag and Drop API is not properly supported on touch devices. See the example below for an alternative approach using pointer events.

import type { InjectionKey, Ref } from 'vue'; import { inject, provide, shallowRef } from 'vue'; // the node type currently being dragged from the sidebar, shared between the sidebar and the flow const DnDKey: InjectionKey<Ref<string | null>> = Symbol('dnd-type'); export function provideDnD() { const type = shallowRef<string | null>(null); provide(DnDKey, type); return type; } export function useDnD() { const type = inject(DnDKey); if (!type) { throw new Error( 'useDnD must be used within a component that called provideDnD', ); } return type; }

Drag and Drop with Pointer Events

Another way to implement drag and drop is to use pointer events.

The Pointer Events API is a modern API that is supported by all major browsers. It is slightly more complex to implement than the HTML Drag and Drop API, but by using pointer events we can make sure that the drag and drop behavior is consistent across all devices, both mouse and touch.

import type { InjectionKey, Ref } from 'vue'; import type { XYPosition } from '@xyflow/vue'; import { inject, onMounted, onUnmounted, provide, shallowRef, watch, } from 'vue'; import { useVueFlow } from '@xyflow/vue'; export type OnDropAction = (params: { position: XYPosition }) => void; interface DnDContext { isDragging: Ref<boolean>; dropAction: Ref<OnDropAction | null>; } const DnDKey: InjectionKey<DnDContext> = Symbol('dnd-custom'); // Wrap the flow subtree so the sidebar can start dragging a node without registering any callback on the // flow itself. export function provideDnD() { provide(DnDKey, { isDragging: shallowRef(false), dropAction: shallowRef<OnDropAction | null>(null), }); } export function useDnD() { const context = inject(DnDKey); if (!context) { throw new Error( 'useDnD must be used within a component tree that called provideDnD', ); } const { isDragging, dropAction } = context; const { screenToFlowPosition } = useVueFlow(); // start dragging a new node into the flow (used by the sidebar entries) function onDragStart(event: PointerEvent, onDrop: OnDropAction) { event.preventDefault(); (event.target as HTMLElement).setPointerCapture(event.pointerId); isDragging.value = true; dropAction.value = onDrop; } function onDragEnd(event: PointerEvent) { if (!isDragging.value) { return; } (event.target as HTMLElement).releasePointerCapture(event.pointerId); event.preventDefault(); // only drop when the pointer is released over the flow const elementUnderPointer = document.elementFromPoint( event.clientX, event.clientY, ); if (elementUnderPointer?.closest('.vue-flow')) { dropAction.value?.({ position: screenToFlowPosition({ x: event.clientX, y: event.clientY }), }); } isDragging.value = false; } watch(isDragging, (dragging) => { if (dragging) { document.addEventListener('pointerup', onDragEnd); } else { document.removeEventListener('pointerup', onDragEnd); } }); onUnmounted(() => document.removeEventListener('pointerup', onDragEnd)); return { isDragging, onDragStart }; } export function useDnDPosition() { const position = shallowRef<XYPosition>(); function onDrag(event: PointerEvent) { event.preventDefault(); position.value = { x: event.clientX, y: event.clientY }; } onMounted(() => document.addEventListener('pointermove', onDrag)); onUnmounted(() => document.removeEventListener('pointermove', onDrag)); return { position }; }

Drag and Drop with Neodrag

Neodrag  is a library that provides a simple and easy to use drag and drop API. In a real-world application, you may want to use the Neodrag library to handle the drag and drop behavior in a cross-platform compatible way, compatible with both mouse and touch devices.

/* Extras for the xyflow examples. These styles sit on top of `@xyflow/vue/xy-theme.css`, which has to be imported before this file. They only add what the library theme doesn't ship with. */ .vue-flow__panel { color: var(--xy-theme-panel-text); } .vue-flow__node { box-shadow: var(--xy-node-boxshadow-default); } .vue-flow__node-resizer { border-radius: 0; border: none; } /* Custom Example CSS - This CSS is to improve the example experience. You can remove it if you want to use the default styles. New Theme Classes: .xy-theme__button - Styles for buttons. .xy-theme__input - Styles for text inputs. .xy-theme__checkbox - Styles for checkboxes. .xy-theme__select - Styles for dropdown selects. .xy-theme__label - Styles for labels. .xy-theme__range - Styles for range sliders (set --range-progress for the filled part). Use these classes to apply consistent theming across your components. */ :root { --color-primary: var(--xy-theme-primary); --color-background: light-dark(#fefefe, #1a1b1e); --color-hover-bg: light-dark(#f6f6f6, #24262c); --color-disabled: light-dark(#76797e, #8b9099); --color-primary-muted: color-mix( in srgb, var(--color-primary) 40%, transparent ); --color-primary-focus: color-mix( in srgb, var(--color-primary) 30%, transparent ); } .xy-theme__button-group { display: flex; align-items: center; .xy-theme__button:first-child { border-radius: 100px 0 0 100px; } .xy-theme__button:last-child { border-radius: 0 100px 100px 0; margin: 0; } } /* Custom Button Styling */ .xy-theme__button { display: inline-flex; align-items: center; justify-content: center; height: 2.5rem; padding: 0 1rem; border-radius: 100px; border: 1px solid var(--color-primary); background-color: var(--color-background); color: var(--color-primary); transition: background-color 0.2s ease, border-color 0.2s ease; box-shadow: var(--xy-node-boxshadow-default); cursor: pointer; } .xy-theme__button.active { background-color: var(--color-primary); color: white; border-color: var(--color-primary); } .xy-theme__button.active:hover, .xy-theme__button.active:active { background-color: var(--color-primary); opacity: 0.9; } .xy-theme__button:hover { background-color: var(--xy-controls-button-background-color-hover-default); } .xy-theme__button:active { background-color: var(--color-hover-bg); } .xy-theme__button:disabled { color: var(--color-disabled); opacity: 0.8; cursor: not-allowed; border: 1px solid var(--color-disabled); } .xy-theme__button > span { margin-right: 0.2rem; } /* Add gap between adjacent buttons */ .xy-theme__button + .xy-theme__button { margin-left: 0.3rem; } /* Example Input Styling */ .xy-theme__input { padding: 0.5rem 0.75rem; border: 1px solid var(--color-primary); border-radius: 7px; background-color: var(--color-background); transition: background-color 0.2s ease, border-color 0.2s ease; font-size: 1rem; color: var(--xy-theme-panel-text); } .xy-theme__input:focus { outline: none; border-color: var(--color-primary); box-shadow: 0 0 0 2px var(--color-primary-focus); } /* Specific Checkbox Styling */ .xy-theme__checkbox { appearance: none; -webkit-appearance: none; width: 1.25rem; height: 1.25rem; border-radius: 7px; border: 2px solid var(--color-primary); background-color: var(--color-background); transition: background-color 0.2s ease, border-color 0.2s ease; cursor: pointer; display: inline-block; vertical-align: middle; margin-right: 0.5rem; } .xy-theme__checkbox:checked { background-color: var(--color-primary); border-color: var(--color-primary); } .xy-theme__checkbox:focus { outline: none; box-shadow: 0 0 0 2px var(--color-primary-focus); } /* Dropdown Styling */ .xy-theme__select { padding: 0.5rem 0.75rem; border: 1px solid var(--color-primary); border-radius: 50px; background-color: var(--color-background); transition: background-color 0.2s ease, border-color 0.2s ease; font-size: 1rem; color: var(--xy-theme-panel-text); margin-right: 0.5rem; box-shadow: var(--xy-node-boxshadow-default); } .xy-theme__select:focus { outline: none; border-color: var(--color-primary); box-shadow: 0 0 0 2px var(--color-primary-focus); } .xy-theme__label { margin-top: 10px; margin-bottom: 3px; display: inline-block; color: var(--xy-theme-panel-text); } /* Range Slider Styling */ .xy-theme__input[type='range'], .xy-theme__range { -webkit-appearance: none; appearance: none; display: block; width: 100%; height: 0.5rem; padding: 0; border: none; border-radius: 100px; background: transparent; cursor: pointer; } .xy-theme__input[type='range']:focus, .xy-theme__range:focus { outline: none; box-shadow: none; } .xy-theme__input[type='range']::-webkit-slider-runnable-track, .xy-theme__range::-webkit-slider-runnable-track { width: 100%; height: 0.5rem; border-radius: 100px; background: linear-gradient( to right, var(--color-primary-muted) 0%, var(--color-primary-muted) var(--range-progress, 0%), var(--color-hover-bg) var(--range-progress, 0%), var(--color-hover-bg) 100% ); } .xy-theme__input[type='range']::-webkit-slider-thumb, .xy-theme__range::-webkit-slider-thumb { -webkit-appearance: none; appearance: none; width: 1.25rem; height: 1.25rem; margin-top: -0.375rem; border-radius: 50%; border: 2px solid var(--color-background); background: var(--color-primary); box-shadow: var(--xy-node-boxshadow-default); } .xy-theme__input[type='range']::-moz-range-track, .xy-theme__range::-moz-range-track { width: 100%; height: 0.5rem; border-radius: 100px; background: var(--color-hover-bg); } .xy-theme__input[type='range']::-moz-range-thumb, .xy-theme__range::-moz-range-thumb { width: 1.25rem; height: 1.25rem; border: none; border-radius: 50%; background: var(--color-primary); box-shadow: var(--xy-node-boxshadow-default); } .xy-theme__input[type='range']::-moz-range-progress, .xy-theme__range::-moz-range-progress { height: 0.5rem; border-radius: 100px 0 0 100px; background: var(--color-primary-muted); }