readonly

Описание

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

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

readonly?: boolean;

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

readonly: false

Пример

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

Подробности

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

Пользователи по-прежнему могут просматривать и копировать данные:

• ячейка A1 активна после загрузки данных
• по ячейкам можно перемещаться с помощью клавиатуры и выделять их мышью, при этом срабатывают события выделения
• ячейки можно копировать с помощью Ctrl (Cmd) + C и искать с помощью Ctrl (Cmd) + F
• листы можно переключать на вкладках листов и с помощью клавиатуры
• ссылки в ячейках можно открывать, но кнопки редактирования и удаления ссылки в окне ссылки отключены

Изменения данных отклоняются:

• ввод текста, клавиши редактирования, вырезание и вставка, отмена и повтор действий, а также сочетания клавиш, которые форматируют ячейки, вставляют ссылку, добавляют лист или показывают скрытые строки и столбцы, игнорируются, а программы чтения с экрана сообщают "The sheet is read-only"
• методы, которые изменяют данные, например, setValue(), setStyle() и deleteRow(), а также метод startEdit() игнорируются. Методы parse() и load() по-прежнему загружают данные
• маркер заполнения скрыт
• размер столбцов и строк нельзя изменить перетаскиванием их границ, а двойной щелчок по границе столбца не подгоняет ширину столбца под данные

Чтобы отключить также навигацию с помощью клавиатуры и выделение, установите для параметра selection значение false. В этом случае в Spreadsheet нет активной ячейки, а ячейки нельзя выделить мышью, с помощью клавиатуры или API:

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

Журнал изменений: Навигация с помощью клавиатуры, выделение, копирование и поиск в режиме только для чтения добавлены в v6.0.4

Полезные статьи:

• Конфигурация
• Кастомизация
• Специальные возможности: настройка режима только для чтения

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