setFocusedCell()
Описание
Устанавливает фокус на указанную ячейку
Использование
setFocusedCell(cell: string, scroll?: boolean): void;
Параметры
cell- (обязательный) идентификатор ячейки, на которую нужно установить фокусscroll- (необязательный) определяет, нужно ли прокручивать Spreadsheet к ячейке, по умолчаниюtrue
Пример
const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
// параметры конфигурации
});
spreadsheet.parse(data);
spreadsheet.selection.setFocusedCell("D4");
Подробности
Метод делает указанную ячейку активной и после перерисовки перемещает на неё фокус клавиатуры. Фокус клавиатуры не перемещается, если он находится:
- в элементе за пределами Spreadsheet
- на панели инструментов, в меню или на вкладках листов, на которые он перешёл с помощью клавиатуры
- в открытом редакторе ячейки
Если фокус клавиатуры находится на теле страницы, например, сразу после загрузки страницы, метод перемещает его на ячейку.
Те же правила действуют при любом другом изменении активной ячейки, например, с помощью другого метода API.
Если обработчик события beforeFocusSet возвращает false, активная ячейка не меняется, а фокус клавиатуры не перемещается.
Метод ничего не делает, пока выделение отключено с помощью параметра конфигурации selection: false или метода selection.disable().
Журнал изменений: Перемещение фокуса клавиатуры на ячейку добавлено в v6.0.4
Полезные статьи: