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

selection

Описание​

Необязательный. Включает/отключает выделение ячеек

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

selection?: boolean;

Конфигурация по умолчанию​

selection: true

Пример​

const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
selection: false,
// other config parameters
});

Подробности​

Если для свойства задано значение false:

  • в Spreadsheet нет активной ячейки
  • ячейки нельзя выделить мышью, клавиатурой или через API: методы setSelectedCell() и setFocusedCell() игнорируются, а методы getSelectedCell() и getFocusedCell() возвращают undefined
  • ячейки нельзя редактировать из интерфейса: строка формул заблокирована, маркер заполнения скрыт, а метод startEdit() игнорируется
  • контекстное меню и значок меню столбца недоступны
  • Tab останавливается на сетке один раз и переносит фокус дальше, а Ctrl + F6 пропускает сетку

Размер столбцов и строк по-прежнему можно изменять перетаскиванием их границ, а данные по-прежнему можно изменять через API, например, с помощью метода setValue().

В сочетании со свойством readonly параметр отключает клавиатурную навигацию и выделение, которые доступны в режиме только для чтения:

const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
readonly: true,
selection: false,
// other config parameters
});

Чтобы отключать и включать выделение во время выполнения, используйте методы selection.disable() и selection.enable().

Журнал изменений: Добавлено в v6.0.4

Связанные статьи: