Перейти к основному содержимому

beforeShapeMove

Описание

Срабатывает перед перемещением фигуры

Примечание

Событие срабатывает только для целевого элемента независимо от количества выбранных элементов. Идентификаторы перетаскиваемых элементов передаются в параметре batch колбека.

Использование

"beforeShapeMove": ({
id: string | number,
batch: (string | number)[],
coords: object,
event: PointerEvent
}) => boolean | void;

Параметры

Колбек события вызывается с объектом, содержащим следующие параметры:

  • id - идентификатор фигуры
  • batch - массив идентификаторов перемещённых элементов
  • coords - объект с координатами x и y положения фигуры до перемещения, где:
    • x - горизонтальное положение фигуры при перемещении слева направо
    • y - вертикальное положение фигуры при перемещении сверху вниз
  • event - объект события

Возвращаемое значение

Колбек возвращает false, чтобы предотвратить перемещение фигуры; в противном случае — true

К сведению

Для обработки внутренних событий Diagram Editor можно использовать метод on().

Пример

// инициализация Diagram Editor
const editor = new dhx.DiagramEditor("editor_container");
// загрузка данных
editor.parse(data);

// подключение обработчика события
editor.events.on("beforeShapeMove", ({ id, coords }) => {
console.log(`
Shape ${id} is at the position:
x: ${coords.x}
y: ${coords.y}
`);
return true;
});

Журнал изменений:

  • Параметр batch добавлен в v6.0
  • Колбек принимает объект в качестве параметра начиная с v6.0
  • Параметры id и coords добавлены в v4.0