Vue DnD Kit 3.0: reescritura completa de la biblioteca Drag & Drop para Vue 3Artículo · digest del 5 de noviembre
Ilustración dinámica estilo cómic europeo del proceso de arrastre interactivo de una tarjeta de tarea con borrador reactivo en Vue DnD Kit 3.0.
Artículo4 secciones≈ 8 min

Vue DnD Kit 3.0: reescritura completa de la biblioteca Drag & Drop para Vue 3

Arrastrar elementos en interfaces web (Drag and Drop) es una de esas tareas que los desarrolladores frontend abordan con un suspiro pesado. La API nativa HTML5 Drag and Drop del navegador nació en la era del escritorio y sigue mal adaptada a pantallas táctiles móviles: la imagen fantasma (drag image) es difícil de estilizar, la transparencia se comporta de forma impredecible y las animaciones de desplazamiento de los elementos vecinos hay que escribirlas a mano.

En el ecosistema React, el paquete @dnd-kit se convirtió hace tiempo en el estándar reconocido. Para Vue, el desarrollador bajo el alias ZiZIGY creó el port vue-dnd-kit, que rápidamente acumuló miles de estrellas. Pero a medida que crecían los proyectos, la segunda versión de la biblioteca entró en un callejón sin salida arquitectónico.

En lugar de parches interminables, el autor tomó una decisión radical: demoler por completo la base de código antigua y lanzar la biblioteca Vue DnD Kit versión 3.0 desde cero. Analicemos el artículo en Habr y veamos cómo funciona la nueva arquitectura.

El callejón sin salida arquitectónico de la versión 2: 57 bugs, layout thrashing y TypeScript roto

La segunda versión de la biblioteca sufría por un nivel de abstracción demasiado bajo. Al desarrollador se le ofrecían las primitivas básicas makeDraggable y makeDroppable. Para armar una simple lista de tareas ordenable, había que escribir decenas de líneas de código repetitivo: rastrear índices manualmente, escuchar el evento onDrop, invocar la función auxiliar suggestSort, mutar el arreglo y envolver los elementos en un componente <TransitionGroup> para lograr algo de fluidez.

Una auditoría del código reveló todo un cúmulo de problemas fundamentales:

  • Complejidad algorítmica $O(N^2)$: la búsqueda de la zona de destino (contenedor droppable) bajo el cursor se realizaba recorriendo ingenuamente todos los elementos registrados en la página. En cada fotograma de movimiento del ratón se llamaba al método getBoundingClientRect(), lo que provocaba un recálculo forzado de la geometría (layout thrashing) y hacía caer los FPS de 120 a unos bruscos 25 FPS en listas largas.
  • 57 defectos ocultos en el núcleo: cualquier evento mouseup en el documento restablecía las propiedades CSS globales user-select y touch-action, el retardo de activación activationDelay en milisegundos se multiplicaba por error como segundos y en los archivos de tipos .d.ts los genéricos clave se convertían silenciosamente en el tipo any.

El intento de apoyarse en el núcleo ajeno de bajo nivel @dnd-kit/dom tampoco tuvo éxito: el motor externo exigía comandos imperativos mediante el método move() y no sabía aprovechar la reactividad nativa de Vue 3.5+. Solo quedaba una salida: escribir un motor especializado propio.

El concepto de borrador reactivo: por qué los datos de negocio ya no sufren cuando se interrumpe un gesto

El principal hallazgo arquitectónico de Vue DnD Kit 3.0 es el concepto de borrador reactivo (Draft State).

Antes, la biblioteca mutaba directamente el arreglo original de elementos durante el arrastre. Si el usuario arrastraba una tarjeta sobre la lista, los elementos cambiaban de posición en memoria. Pero ¿qué ocurría si en ese instante el dedo se resbalaba de la pantalla, el usuario pulsaba la tecla Escape o soltaba el cursor sobre una zona prohibida? Comenzaba la reversión: había que devolver el arreglo al estado inicial, provocando parpadeos en la interfaz y disparos innecesarios de observadores reactivos (watchers).

En el composable makeSortableList, el arreglo items es un borrador reactivo:

  1. El arreglo original de tareas en tu ref o Pinia Store permanece totalmente intacto durante todo el proceso de arrastre.
  2. La biblioteca manipula únicamente el borrador: las tarjetas vecinas se apartan, la animación muestra la posición futura del elemento, pero en la lógica de negocio no ocurre ningún cambio.
  3. Si el gesto se cancela, el borrador se descarta al instante sin efectos secundarios.
  4. Si el usuario confirma la suelta (Drop), el orden final se escribe de forma atómica en el estado de negocio.

Así de concisa luce una lista ordenable básica en Vue 3.5+:

<script setup lang="ts">
import { ref, useTemplateRef } from 'vue';
import { makeSortableList } from '@vue-dnd-kit/core';

interface Task {
  id: string;
  title: string;
}

const listRef = useTemplateRef<HTMLElement>('listRef');
const tasks = ref<Task[]>([
  { id: '1', title: 'Diseñar el esquema de PostgreSQL' },
  { id: '2', title: 'Configurar pruebas BDD con Playwright' },
  { id: '3', title: 'Actualizar variables de Claude Code' }
]);

// makeSortableList devuelve el borrador items para renderizar
const { items } = makeSortableList(listRef, {
  items: tasks,
  id: 'tasks-sortable-list'
});
</script>

<template>
  <ul ref="listRef" class="task-list">
    <li 
      v-for="task in items" 
      :key="task.id" 
      :data-dnd-id="task.id"
      class="task-item"
    >
      {{ task.title }}
    </li>
  </ul>
</template>

Fíjate: sin componente <TransitionGroup> y sin llamadas manuales a funciones de ordenación. La propia biblioteca sigue el DOM mediante referencias de plantilla useTemplateRef y el atributo data-dnd-id.

Cinemática integrada sin TransitionGroup: tableros kanban y árboles de serie

El segundo dolor de cabeza de los desarrolladores es la física del movimiento. Configurar un deslizamiento suave de elementos según el algoritmo FLIP (First, Last, Invert, Play) solía llevar días de trabajo.

En la versión 3.0, la cinemática viene integrada en el propio núcleo:

  • El desplazamiento de las tarjetas vecinas se calcula matemáticamente sin crear nodos DOM intermedios;
  • El retorno de la tarjeta a su lugar original al pulsar Escape ocurre con una interpolación física fluida;
  • El motor comprueba automáticamente la preferencia del sistema prefers-reduced-motion: si el usuario tiene activado el modo de movimiento reducido, las animaciones se desactivan al instante por comodidad y accesibilidad.

Para construir tableros kanban ya no hace falta montar apaños para sincronizar eventos. Basta con unir las listas bajo un mismo identificador de grupo en cadena de texto:

import { useTemplateRef } from 'vue';
import { makeSortableList } from '@vue-dnd-kit/core';
import { useKanbanStore } from '@/stores/kanban';

const kanbanStore = useKanbanStore();
const columnRef = useTemplateRef<HTMLElement>('columnRef');

const { items } = makeSortableList(columnRef, {
  id: 'column-review',
  group: 'project-kanban-board',
  items: () => kanbanStore.columns['review'],
  onDrop: (event) => {
    event.preventDefault();
    // Actualizamos de forma atómica las columnas en el store
    for (const [columnId, newItems] of event.result) {
      kanbanStore.updateColumn(columnId, newItems);
    }
  }
});

Además, la biblioteca aprendió de serie a trabajar con árboles jerárquicos: desplazar a la derecha el nodo arrastrado cambia automáticamente el nivel de anidación respetando un límite de profundidad configurable.

Como vimos recientemente al estudiar el digest del ecosistema Vue y Nuxt, pasar las herramientas frontend a las primitivas reactivas estrictas de Vue 3.5 permite desechar megabytes de código antiguo, haciendo que las interfaces respondan mejor y sean más estables.

Simbiosis con Claude Code: cómo los agentes de IA ayudaron a reescribir la biblioteca desde cero

También resulta interesante la trastienda de ingeniería del lanzamiento 3.0. El autor cuenta abiertamente que la reescritura de la biblioteca se llevó a cabo en estrecha colaboración con el agente de consola Claude Code:

  1. El agente realizó una auditoría completa del código antiguo, cruzó cientos de issues abiertos en GitHub con el código fuente y elaboró el registro de esos mismos 57 bugs críticos.
  2. El agente investigó la arquitectura de soluciones competidoras (Pragmatic Drag and Drop de Atlassian) y ayudó a redactar el borrador del RFC técnico.
  3. En sesiones de terminal paralelas, el agente generó decenas de pruebas de estrés para condiciones límite: tirón brusco del ratón fuera de la pantalla, multitáctil en dispositivos móviles y comportamiento con scroll activo de página.

Al mismo tiempo, las decisiones de producto —el diseño de la API pública, la renuncia a dependencias externas y la semántica de trabajo de los borradores— siguieron en manos del humano.

Vue DnD Kit 3.0 demuestra con claridad cómo el desarrollo frontend maduro se deshace de apaños de años, convirtiendo las interacciones de interfaz más complejas en un par de líneas de código declarativo limpio.

Quiero un análisis detalladoLos votos ayudan a elegir qué analizar a fondo. Este material tiene 0 votos.
Fuentes · 3