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

hotkeys

Описание​

Необязательный параметр. Позволяет управлять комбинациями клавиш (горячими клавишами) для различных действий в редакторе

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

Примечание

Обратите внимание, что включение или отключение стандартных горячих клавиш также повлияет на их отображение в виде подсказок или меток на панели инструментов редактора.

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

hotkeys?:
    | boolean
    | {
        [key: string]: false | ((event: KeyboardEvent) => void);
      };

Параметры​

  • hotkeys: boolean - если задано значение false, все стандартные горячие клавиши будут отключены. Если задано значение true, все стандартные горячие клавиши включены
  • hotkeys: object - объект, в котором ключи соответствуют названиям горячих клавиш (например, "ctrl+c", "delete"), а значения определяют их поведение следующим образом:
    • false - отключает указанную горячую клавишу
    • (event: KeyboardEvent) => void - определяет пользовательскую функцию, которая будет выполнена при нажатии этой горячей клавиши. Функция получает объект KeyboardEvent в качестве аргумента

Пример​

  • отключение всех горячих клавиш
const editor = new dhx.DiagramEditor("editor_container", {
    hotkeys: false,
});
  • отключение отдельных горячих клавиш (в примере ниже - Ctrl+C и Ctrl+V)
const editor = new dhx.DiagramEditor("editor_container", {
    hotkeys: {
        "ctrl+c": false,
        "ctrl+v": false
    },
});
  • переопределение поведения горячей клавиши
let editor = null;

editor = new dhx.DiagramEditor("editor_container", {
    hotkeys: {
        // Переопределяет клавишу "delete" для удаления выбранных элементов
        "delete": () => editor.diagram.data.remove(editor.diagram.selection.getIds()),
        // Добавляет пользовательскую горячую клавишу "Ctrl+F"
        "ctrl+f": () => console.log("custom search"),
    },
});

Описание​

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

Таблица горячих клавиш​

Комбинация клавишОписаниеСтроковый параметр
Alt+1Показывает/скрывает Shapebar (только в режиме по умолчанию)"alt+1"
Alt+2Показывает/скрывает Editbar"alt+2"
Alt+3Показывает/скрывает область сетки"alt+3"
Ctrl+Z (Win), CMD+Z (macOS)Отменяет последнее действие"ctrl+z"
Ctrl+Shift+Z (Win), CMD+Shift+Z (macOS)Возвращает отмененное действие"ctrl+shift+z"
Ctrl+D (Win), CMD+D (macOS)Дублирует выбранный элемент (только в режиме по умолчанию)"ctrl+d"
Ctrl+C (Win), CMD+C (macOS)Копирует выбранный элемент (только в режиме по умолчанию)"ctrl+c"
Ctrl+V (Win), CMD+V (macOS)Вставляет выбранный элемент (только в режиме по умолчанию)"ctrl+v"
Ctrl+Alt+C (Win), CMD+Alt+C (macOS)Копирует стиль выбранного элемента (применимо для элементов одного типа)"alt+ctrl+c"
Ctrl+Alt+V (Win), CMD+Alt+V (macOS)Применяет скопированный стиль к выбранному элементу (применимо для элементов одного типа)"alt+ctrl+v"
Ctrl+A (Win), CMD+A (macOS)Выбирает все элементы"ctrl+a"
Ctrl+Shift+A (Win), CMD+Shift+A (macOS)Снимает выделение со всех выбранных элементов"ctrl+shift+a"
Shift+Left ClickДобавляет элемент в список выбранных элементов(Не является параметром hotkeys напрямую)
Alt+Left ClickСнимает выделение с выбранного элемента(Не является параметром hotkeys напрямую)
Delete (Del), BackspaceУдаляет элемент(ы)"delete", "backspace"
Arrow-Left, Arrow-Right, Arrow-Up, Arrow-DownПеремещает выбранные элементы"arrowLeft", "arrowRight", "arrowUp", "arrowDown"
Ctrl+Mousewheel (Win), CMD+Mousewheel (macOS)Увеличивает/уменьшает значение масштаба(Не является параметром hotkeys напрямую)

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

  • Свойство hotkeys добавлено в v6.1

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

Need more help?Contact Support