Aktionen-Übersicht

Dieser Abschnitt beschreibt einen neuen Ansatz zur Interaktion mit Spreadsheet-Events.

Ab v4.3 enthält DHTMLX Spreadsheet ein Paar von beforeAction/afterAction-Events, die Ihren Code einfacher und kompakter gestalten. Sie werden unmittelbar vor der Ausführung einer Aktion ausgelöst und zeigen genau an, welche Aktion durchgeführt wurde.

spreadsheet.events.on("beforeAction", (actionName, config) => {
    if (actionName === "addColumn") {
        console.log(actionName, config);
        return false;
    },
    // more actions
});

spreadsheet.events.on("afterAction", (actionName, config) => {
    if (actionName === "addColumn") {
        console.log(actionName, config)
    },
    // more actions
});

Die vollständige Liste der verfügbaren Aktionen ist unten aufgeführt.

Das bedeutet, dass Sie nicht mehr Sätze von gekoppelten before- und after--Events hinzufügen müssen, um die Aktionen zu verfolgen und zu verarbeiten, die Sie beim Ändern von Inhalten in der Tabelle ausführen.

Bei Bedarf können Sie jedoch den alten Ansatz weiterhin verwenden, da alle vorhandenen Events weiterhin wie gewohnt funktionieren:

spreadsheet.events.on("afterColumnAdd", function(cell){
    console.log("A new column is added", cell);
});

spreadsheet.events.on("beforeColumnAdd", function(cell){
    console.log("A new column will be added", cell);
    return true;
});

Liste der Aktionen

Aktion	Beschreibung
addColumn	Die Aktion wird beim Hinzufügen einer neuen Spalte ausgeführt
addRow	Die Aktion wird beim Hinzufügen einer neuen Zeile ausgeführt
addSheet	Die Aktion wird beim Hinzufügen eines neuen Blatts ausgeführt
clear	Die Aktion wird beim Leeren der Tabelle über die clear()-Methode ausgeführt
clearSheet	Die Aktion wird beim Leeren eines Blatts über die sheets.clear()-Methode ausgeführt
deleteColumn	Die Aktion wird beim Entfernen einer Spalte ausgeführt
deleteRow	Die Aktion wird beim Entfernen einer Zeile ausgeführt
deleteSheet	Die Aktion wird beim Entfernen eines Blatts ausgeführt
filter	Die Aktion wird beim Filtern von Daten in einem Blatt ausgeführt
fitColumn	Die Aktion wird beim automatischen Anpassen der Spaltenbreite ausgeführt
groupAction	Die Aktion wird ausgeführt, wenn ein Zellbereich ausgewählt und darauf bestimmte Aktionen angewendet werden (z. B. Stil oder Format von Zellen ändern, Zellen sperren/entsperren oder Zellwerte/Stile löschen)
insertLink	Die Aktion wird beim Einfügen eines Hyperlinks in eine Zelle ausgeführt
lockCell	Die Aktion wird beim Sperren/Entsperren einer Zelle ausgeführt
merge	Die Aktion wird beim Verbinden eines Zellbereichs ausgeführt
removeCellStyles	Die Aktion wird beim Löschen der Stile einer Zelle ausgeführt
renameSheet	Die Aktion wird beim Umbenennen eines Blatts ausgeführt
resizeCol	Die Aktion wird beim Ändern der Spaltenbreite ausgeführt
resizeRow	Die Aktion wird beim Ändern der Zeilenhöhe ausgeführt
setCellFormat	Die Aktion wird beim Ändern des Formats einer Zelle ausgeführt
setCellValue	Die Aktion wird beim Ändern oder Entfernen des Werts einer Zelle ausgeführt
setValidation	Die Aktion wird beim Festlegen der Datenvalidierung für eine Zelle ausgeführt
sortCells	Die Aktion wird beim Sortieren von Daten in der Tabelle ausgeführt
setCellStyle	Die Aktion wird beim Ändern des Stils einer Zelle ausgeführt
toggleVisibility	Die Aktion wird beim Ein-/Ausblenden von Spalten/Zeilen ausgeführt
toggleFreeze	Die Aktion wird beim Einfrieren/Aufheben des Einfrierens von Spalten/Zeilen ausgeführt
unmerge	Die Aktion wird beim Aufheben der Verbindung von Zellen ausgeführt

Changelog:

• Die Aktionen toggleFreeze und toggleVisibility wurden in v5.2 hinzugefügt
• Die Aktionen merge, unmerge, filter, fitColumn, insertLink wurden in v5.0 hinzugefügt

Verwandtes Beispiel: Spreadsheet. Aktionen