Zum Hauptinhalt springen

beforeItemMove

Beschreibung​

Wird ausgelöst, bevor ein Element verschoben wird

Hinweis

Das Event funktioniert nicht mit dem Objekt line.

Das Event wird unabhängig von der Anzahl der ausgewählten Elemente nur für das Zielelement ausgelöst. Die IDs der gezogenen Elemente werden im Parameter batch der Callback-Funktion bereitgestellt.

Verwendung​

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

Parameter​

Die Callback-Funktion des Events wird mit einem Objekt aufgerufen, das die folgenden Parameter enthält:

  • id - die ID eines Elements
  • batch - ein Array mit den IDs der verschobenen Elemente
  • coords - ein Objekt mit den Koordinaten x und y der Elementposition vor der Verschiebung, wobei:
    • x - die horizontale Position des Elements, von links nach rechts
    • y - die vertikale Position des Elements, von oben nach unten
  • event - ein Event-Objekt

Rückgabewert​

Die Callback-Funktion gibt false zurück, um zu verhindern, dass das Element verschoben wird; andernfalls true

Info

Für die Verarbeitung interner Diagram-Editor-Events können Sie die Methode on() verwenden.

Beispiel​

// Diagram Editor initialisieren
const editor = new dhx.DiagramEditor("editor_container");
// Daten laden
editor.parse(data);

// Handler an das Event anhängen
editor.events.on("beforeItemMove", ({ id, coords }) => {
    console.log(`
        Item ${id} is at the position:
            x: ${coords.x}
            y: ${coords.y}
    `);
    return true;
});

Changelog:

  • Der Parameter batch wurde in v6.0 hinzugefügt
  • Die Callback-Funktion akzeptiert seit v6.0 ein Objekt als Parameter

Verwandte API:

Verwandtes Beispiel:

Need more help?Contact Support