Конфигурация

Вы можете настроить DHTMLX Spreadsheet под свои нужды. Доступные параметры конфигурации позволяют ограничить количество строк и столбцов, изменить внешний вид панели инструментов, а также управлять видимостью меню и строки редактирования. При необходимости Spreadsheet можно инициализировать в режиме только для чтения.

Панель инструментов

Панель инструментов Spreadsheet состоит из нескольких блоков элементов управления, которые можно изменять по своему усмотрению. По умолчанию панель инструментов содержит следующие блоки: "undo", "colors", "font", "decoration", "align", "cell", "format", "actions". Из списка можно добавить дополнительные блоки: "lock", "clear", "rows", "columns", "file", "help".

Структура панели инструментов настраивается через параметр конфигурации компонента toolbarBlocks — массив строк с названиями элементов управления.

Вы также можете задать собственную структуру панели инструментов, перечислив необходимые элементы в массиве toolbarBlocks в нужном порядке, например: "colors", "align", "cell", "decoration", "lock", "clear".

const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
    toolbarBlocks: ["colors", "align", "cell", "decoration", "lock", "clear"]
});

Панель инструментов легко настраивается. Вы можете добавлять новые элементы управления, менять их иконки и применять нужный набор иконок.

Строка редактирования

Так как структура Spreadsheet гибкая, вы можете включать и отключать строку редактирования для получения нужного внешнего вида компонента. Используйте параметр конфигурации editLine для скрытия/отображения строки редактирования.

Количество строк и столбцов

При инициализации Spreadsheet создаётся сетка из 26 столбцов и 1000 строк. Когда этот лимит исчерпывается, дополнительные строки и столбцы добавляются автоматически, поэтому добавлять их вручную не нужно. Тем не менее вы можете задать точное количество строк и столбцов в сетке, если хотите их ограничить. Для этого используйте параметры colsCount и rowsCount.

Меню

По умолчанию меню Spreadsheet скрыто. Его можно включить или отключить с помощью соответствующего параметра конфигурации menu:

Режим только для чтения

Вы также можете включить режим только для чтения, чтобы запретить редактирование ячеек Spreadsheet, с помощью параметра конфигурации readonly.

Вы также можете настроить поведение Spreadsheet в режиме только для чтения.

Пользовательские числовые форматы ячеек

Вы можете применять 7 форматов по умолчанию к значениям ячеек: "Common", "Number", "Percent", "Currency", "Date", "Time", "Text".

Вы можете переопределить конфигурацию форматов по умолчанию или задать собственный числовой формат с помощью параметра конфигурации formats. Подробности смотрите в статье Форматирование чисел.

Путь к модулям экспорта/импорта

DHTMLX Spreadsheet поддерживает импорт и экспорт данных в формате Excel. Компонент использует библиотеки на основе WebAssembly: Excel2Json и JSON2Excel для импорта/экспорта данных.

После установки необходимой библиотеки нужно задать путь к файлу worker.js (локальному или на CDN) через соответствующий параметр конфигурации: importModulePath или exportModulePath.

Все подробности приведены в статье Загрузка и экспорт данных.