HTML Drag and Drop или Pointer Events: что выбрать
- Как разделить перенос данных и управление жестом
- Когда нужен DataTransfer, а когда Pointer Events
- Что проверить для мыши, пера и сенсорного экрана
- Как испытать выбранную модель на синтетическом прототипе
Карточку на доске нужно свободно вести за указателем, а файл — перетащить из проводника в окно браузера. Внешне это один жест, но за ним стоят разные задачи и событийные модели.
HTML Drag and Drop стоит рассматривать, когда важен обмен данными или файлами между страницей и внешней средой. Pointer Events подходят для управляемого жеста внутри интерфейса: разработчик сам определяет движение, завершение и отмену. Если нужны оба сценария, их можно проверять отдельно, а не искать один API на все случаи.
Практическую границу между моделями поможет провести редакционный чек-лист ниже. Его нужно адаптировать к интерфейсу, поддерживаемым устройствам и рискам проекта: это не обязательный стандарт, испытание продукта или клиентский кейс. Смежные вопросы разработки разобраны в материале о PWA-приложении из сайта, а варианты реализации веб-интерфейсов собраны на странице контента и сайтов.
Два уровня задачи: перенос данных и управление жестом
HTML Drag and Drop охватывает три разных сценария: перемещение элементов внутри страницы, перенос данных из страницы и приём данных в неё. Общий API не делает эти сценарии одинаковыми — требования к ним и реализация могут различаться.
При обмене со сторонней страницей или внешним приложением произвольный JavaScript-объект передать нельзя. Данные в хранилище переноса должны быть представлены строкой либо объектом File. Это важно, если интерфейс принимает файлы из системы или передаёт сериализованные данные за пределы страницы.
Pointer Events решают другую часть задачи. Они дают единую модель DOM-событий для мыши, пера и касаний, включая несколько пальцев. Поэтому для редактора, доски или перестановки элементов сначала полезно решить, нужен ли настоящий перенос данных или только непрерывное управление положением объекта.
Ограничения HTML Drag and Drop: DataTransfer, dragstart и drop
У HTML Drag and Drop есть заданный жизненный цикл хранилища DataTransfer. Изменять его разрешено в обработчике dragstart. Прикладное состояние интерфейса может обновляться и в других обработчиках, но само хранилище переносимых данных там недоступно для изменения.
Читать это хранилище можно во время dragstart, а затем при drop, когда цель получает данные. Поэтому схема, в которой содержимое переноса произвольно переписывается на каждом шаге движения, не соответствует ограничениям API.
Большинство элементов по умолчанию не принимают сброс. Минимальное условие для цели — отменить dragover через preventDefault(). Это ещё не проверка содержимого: допустимые типы, место вставки и реакцию на ошибочные данные приложение определяет отдельно.
Pointer Events: тип устройства, захват и несколько указателей
В Pointer Events свойство pointerType сообщает, чем создано событие: мышью, пером или касанием. Само свойство не задаёт поведение жеста, но позволяет развести обработку там, где различия устройств действительно нужны.
Захват через setPointerCapture() помогает продолжать получать события после выхода контакта за границы исходного элемента. При этом меняется адресация последующих событий, а pointerover, pointerenter, pointerleave и pointerout во время захвата не срабатывают. Логику подсветки целей нужно проверять с учётом этого ограничения.
Каждый активный указатель имеет pointerId. Свойство isPrimary выделяет основной указатель отдельно для каждого типа устройства, а не один общий среди мыши, пера и касаний. Если второй палец должен отменять перенос, запускать другой жест или игнорироваться, это поведение следует задать явно.
Сенсорный экран: pointercancel и touch-action
На сенсорном устройстве браузер может решить, что движение предназначено для панорамирования или масштабирования, и отправить pointercancel. Обработчик отмены должен привести интерфейс в определённое состояние: например, убрать временное представление и освободить захват указателя.
CSS-свойство touch-action указывает, разрешено ли стандартное сенсорное поведение браузера в выбранной области. У отдельных значений могут быть различия в реализации, поэтому недостаточно проверить только настольную мышь или назначить одно правило всей странице.
Редакционная рекомендация — определить зоны жеста отдельно. Для ручки карточки, рабочей области и прокручиваемого списка могут требоваться разные сочетания перетаскивания и обычной прокрутки. Итоговое поведение следует проверить на тех устройствах и в тех браузерах, которые входят в границы проекта.
Что проверить на синтетическом прототипе до выбора библиотеки
Сначала зафиксируйте матрицу устройств и браузеров проекта, чтобы одинаково прогнать по ней всех кандидатов.
- Если нужен обмен с внешней средой, разделите проверки по направлениям: примите синтетический файл из ОС, а исходящий перенос строки проверьте с предусмотренной целью.
- В тестовой сцене воспроизведите
pointerdown,pointermoveиpointerupдля каждого требуемого типа указателя, а затем повторите сценарии физическими мышью, пером и касанием. - Сравните выход указателя за границы элемента с
setPointerCapture()и без него; отдельно обработайте завершение и отмену. - Задайте ожидаемое
touch-actionдля каждой зоны и на реальном сенсорном устройстве совместите проверку жеста с обычной прокруткой и масштабированием страницы. - Создайте несколько
pointerIdи зафиксируйте реакцию на события сisPrimary=false; реальный сценарий со вторым касанием проверьте отдельно.
Для условной доски можно собрать три синтетические сцены: перестановку карточки мышью, движение пером за пределы карточки и касание с последующим вторым пальцем. После прогона обработчиков повторите те же сценарии на устройствах и в браузерах из зафиксированной матрицы.
Отдельная сцена с реальным файлом из ОС покажет, нужен ли проекту входящий перенос через DataTransfer, а не только визуальное перемещение элемента. Исходящий обмен проверяйте отдельно для конкретной цели и формата данных, не предполагая симметричного поведения в обоих направлениях.
Результаты этих проверок превращаются в критерии сравнения библиотек: поддержка нужной событийной модели, работа с требуемыми указателями, обработка выхода за границы и отмены жеста.