devextreme
Version:
HTML5 JavaScript Component Suite for Responsive Web Development
258 lines (257 loc) • 9.46 kB
JavaScript
/**
* DevExtreme (esm/__internal/events/m_drag.js)
* Version: 24.2.6
* Build date: Mon Mar 17 2025
*
* Copyright (c) 2012 - 2025 Developer Express Inc. ALL RIGHTS RESERVED
* Read about DevExtreme licensing here: https://js.devexpress.com/Licensing/
*/
import registerEmitter from "../../common/core/events/core/emitter_registrator";
import registerEvent from "../../common/core/events/core/event_registrator";
import GestureEmitter from "../../common/core/events/gesture/emitter.gesture";
import {
eventData as eData,
fireEvent
} from "../../common/core/events/utils/index";
import {
data as elementData,
removeData
} from "../../core/element_data";
import $ from "../../core/renderer";
import {
wrapToArray
} from "../../core/utils/array";
import {
contains
} from "../../core/utils/dom";
import * as iteratorUtils from "../../core/utils/iterator";
const DRAG_START_EVENT = "dxdragstart";
const DRAG_EVENT = "dxdrag";
const DRAG_END_EVENT = "dxdragend";
const DRAG_ENTER_EVENT = "dxdragenter";
const DRAG_LEAVE_EVENT = "dxdragleave";
const DROP_EVENT = "dxdrop";
const DX_DRAG_EVENTS_COUNT_KEY = "dxDragEventsCount";
const knownDropTargets = [];
const knownDropTargetSelectors = [];
const knownDropTargetConfigs = [];
const dropTargetRegistration = {
setup(element, data) {
const knownDropTarget = knownDropTargets.includes(element);
if (!knownDropTarget) {
knownDropTargets.push(element);
knownDropTargetSelectors.push([]);
knownDropTargetConfigs.push(data || {})
}
},
add(element, handleObj) {
const index = knownDropTargets.indexOf(element);
this.updateEventsCounter(element, handleObj.type, 1);
const {
selector: selector
} = handleObj;
if (!knownDropTargetSelectors[index].includes(selector)) {
knownDropTargetSelectors[index].push(selector)
}
},
updateEventsCounter(element, event, value) {
if ([DRAG_ENTER_EVENT, DRAG_LEAVE_EVENT, DROP_EVENT].includes(event)) {
const eventsCount = elementData(element, "dxDragEventsCount") || 0;
elementData(element, "dxDragEventsCount", Math.max(0, eventsCount + value))
}
},
remove(element, handleObj) {
this.updateEventsCounter(element, handleObj.type, -1)
},
teardown(element) {
const handlersCount = elementData(element, "dxDragEventsCount");
if (!handlersCount) {
const index = knownDropTargets.indexOf(element);
knownDropTargets.splice(index, 1);
knownDropTargetSelectors.splice(index, 1);
knownDropTargetConfigs.splice(index, 1);
removeData(element, "dxDragEventsCount")
}
}
};
registerEvent(DRAG_ENTER_EVENT, dropTargetRegistration);
registerEvent(DRAG_LEAVE_EVENT, dropTargetRegistration);
registerEvent(DROP_EVENT, dropTargetRegistration);
const getItemDelegatedTargets = function($element) {
const dropTargetIndex = knownDropTargets.indexOf($element.get(0));
const dropTargetSelectors = knownDropTargetSelectors[dropTargetIndex].filter((selector => selector));
let $delegatedTargets = $element.find(dropTargetSelectors.join(", "));
if (knownDropTargetSelectors[dropTargetIndex].includes(void 0)) {
$delegatedTargets = $delegatedTargets.add($element)
}
return $delegatedTargets
};
const getItemConfig = function($element) {
const dropTargetIndex = knownDropTargets.indexOf($element.get(0));
return knownDropTargetConfigs[dropTargetIndex]
};
const getItemPosition = function(dropTargetConfig, $element) {
if (dropTargetConfig.itemPositionFunc) {
return dropTargetConfig.itemPositionFunc($element)
}
return $element.offset()
};
const getItemSize = function(dropTargetConfig, $element) {
if (dropTargetConfig.itemSizeFunc) {
return dropTargetConfig.itemSizeFunc($element)
}
return {
width: $element.get(0).getBoundingClientRect().width,
height: $element.get(0).getBoundingClientRect().height
}
};
const DragEmitter = GestureEmitter.inherit({
ctor(element) {
this.callBase(element);
this.direction = "both"
},
_init(e) {
this._initEvent = e
},
_start(e) {
e = this._fireEvent("dxdragstart", this._initEvent);
this._maxLeftOffset = e.maxLeftOffset;
this._maxRightOffset = e.maxRightOffset;
this._maxTopOffset = e.maxTopOffset;
this._maxBottomOffset = e.maxBottomOffset;
if (e.targetElements || null === e.targetElements) {
const dropTargets = wrapToArray(e.targetElements || []);
this._dropTargets = iteratorUtils.map(dropTargets, (element => $(element).get(0)))
} else {
this._dropTargets = knownDropTargets
}
},
_move(e) {
const eventData = eData(e);
const dragOffset = this._calculateOffset(eventData);
e = this._fireEvent("dxdrag", e, {
offset: dragOffset
});
this._processDropTargets(e);
if (!e._cancelPreventDefault) {
e.preventDefault()
}
},
_calculateOffset(eventData) {
return {
x: this._calculateXOffset(eventData),
y: this._calculateYOffset(eventData)
}
},
_calculateXOffset(eventData) {
if ("vertical" !== this.direction) {
const offset = eventData.x - this._startEventData.x;
return this._fitOffset(offset, this._maxLeftOffset, this._maxRightOffset)
}
return 0
},
_calculateYOffset(eventData) {
if ("horizontal" !== this.direction) {
const offset = eventData.y - this._startEventData.y;
return this._fitOffset(offset, this._maxTopOffset, this._maxBottomOffset)
}
return 0
},
_fitOffset(offset, minOffset, maxOffset) {
if (null != minOffset) {
offset = Math.max(offset, -minOffset)
}
if (null != maxOffset) {
offset = Math.min(offset, maxOffset)
}
return offset
},
_processDropTargets(e) {
const target = this._findDropTarget(e);
const sameTarget = target === this._currentDropTarget;
if (!sameTarget) {
this._fireDropTargetEvent(e, DRAG_LEAVE_EVENT);
this._currentDropTarget = target;
this._fireDropTargetEvent(e, DRAG_ENTER_EVENT)
}
},
_fireDropTargetEvent(event, eventName) {
if (!this._currentDropTarget) {
return
}
const eventData = {
type: eventName,
originalEvent: event,
draggingElement: this._$element.get(0),
target: this._currentDropTarget
};
fireEvent(eventData)
},
_findDropTarget(e) {
const that = this;
let result;
iteratorUtils.each(knownDropTargets, ((_, target) => {
if (!that._checkDropTargetActive(target)) {
return
}
const $target = $(target);
iteratorUtils.each(getItemDelegatedTargets($target), ((_, delegatedTarget) => {
const $delegatedTarget = $(delegatedTarget);
if (that._checkDropTarget(getItemConfig($target), $delegatedTarget, $(result), e)) {
result = delegatedTarget
}
}))
}));
return result
},
_checkDropTargetActive(target) {
let active = false;
iteratorUtils.each(this._dropTargets, ((_, activeTarget) => {
active = active || activeTarget === target || contains(activeTarget, target);
return !active
}));
return active
},
_checkDropTarget(config, $target, $prevTarget, e) {
const isDraggingElement = $target.get(0) === $(e.target).get(0);
if (isDraggingElement) {
return false
}
const targetPosition = getItemPosition(config, $target);
if (e.pageX < targetPosition.left) {
return false
}
if (e.pageY < targetPosition.top) {
return false
}
const targetSize = getItemSize(config, $target);
if (e.pageX > targetPosition.left + targetSize.width) {
return false
}
if (e.pageY > targetPosition.top + targetSize.height) {
return false
}
if ($prevTarget.length && $prevTarget.closest($target).length) {
return false
}
if (config.checkDropTarget && !config.checkDropTarget($target, e)) {
return false
}
return $target
},
_end(e) {
const eventData = eData(e);
this._fireEvent("dxdragend", e, {
offset: this._calculateOffset(eventData)
});
this._fireDropTargetEvent(e, DROP_EVENT);
delete this._currentDropTarget
}
});
registerEmitter({
emitter: DragEmitter,
events: ["dxdragstart", "dxdrag", "dxdragend"]
});
export {
DROP_EVENT as drop, DRAG_END_EVENT as end, DRAG_ENTER_EVENT as enter, DRAG_LEAVE_EVENT as leave, DRAG_EVENT as move, DRAG_START_EVENT as start
};