Обзор действий

В этом разделе описан новый подход к взаимодействию с событиями Spreadsheet.

Начиная с версии v4.3, DHTMLX Spreadsheet включает пару событий beforeAction/afterAction, которые упрощают и делают код более компактным. Они срабатывают непосредственно перед выполнением действия и точно указывают, какое именно действие было выполнено.

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
});

Полный список доступных действий приведён ниже.

Это означает, что вам больше не нужно добавлять наборы парных событий before- и after- для отслеживания и обработки действий, выполняемых при изменении данных в таблице.

При необходимости вы можете использовать старый подход, поскольку все существующие события продолжают работать по-прежнему:

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;
});

Список действий

Действие	Описание
addColumn	Действие выполняется при добавлении нового столбца
addRow	Действие выполняется при добавлении новой строки
addSheet	Действие выполняется при добавлении нового листа
clear	Действие выполняется при очистке таблицы с помощью метода clear()
clearSheet	Действие выполняется при очистке листа с помощью метода sheets.clear()
deleteColumn	Действие выполняется при удалении столбца
deleteRow	Действие выполняется при удалении строки
deleteSheet	Действие выполняется при удалении листа
filter	Действие выполняется при фильтрации данных на листе
fitColumn	Действие выполняется при автоматической подгонке ширины столбца
groupAction	Действие выполняется при выборе диапазона ячеек и применении к ним операций (например, изменение стиля или формата ячеек, блокировка/разблокировка ячеек или очистка значений и стилей ячеек)
insertLink	Действие выполняется при вставке гиперссылки в ячейку
lockCell	Действие выполняется при блокировке/разблокировке ячейки
merge	Действие выполняется при объединении диапазона ячеек
removeCellStyles	Действие выполняется при очистке стилей ячейки
renameSheet	Действие выполняется при переименовании листа
resizeCol	Действие выполняется при изменении ширины столбца
resizeRow	Действие выполняется при изменении высоты строки
setCellFormat	Действие выполняется при изменении формата ячейки
setCellValue	Действие выполняется при изменении или удалении значения ячейки
setValidation	Действие выполняется при установке правил проверки данных для ячейки
sortCells	Действие выполняется при сортировке данных в таблице
setCellStyle	Действие выполняется при изменении стиля ячейки
toggleVisibility	Действие выполняется при скрытии/отображении столбцов/строк
toggleFreeze	Действие выполняется при закреплении/откреплении столбцов/строк
unmerge	Действие выполняется при разъединении ячеек

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

Действия toggleFreeze и toggleVisibility добавлены в v5.2
Действия merge, unmerge, filter, fitColumn, insertLink добавлены в v5.0

Связанный пример: Spreadsheet. Действия

Список действий​

Список действий