X-Git-Url: http://source.bookstackapp.com/bookstack/blobdiff_plain/78b645003187d0c709de0accf0e435e064400805..refs/pull/5280/head:/resources/js/components/shortcuts.js diff --git a/resources/js/components/shortcuts.js b/resources/js/components/shortcuts.js index 7feb9bed0..8bf26fbb5 100644 --- a/resources/js/components/shortcuts.js +++ b/resources/js/components/shortcuts.js @@ -1,34 +1,4 @@ -/** - * The default mapping of unique id to shortcut key. - * @type {Object} - */ -const defaultMap = { - // Header actions - "home": "1", - "shelves_view": "2", - "books_view": "3", - "settings_view": "4", - "favorites_view": "5", - "profile_view": "6", - "global_search": "/", - "logout": "0", - - // Generic actions - "edit": "e", - "new": "n", - "copy": "c", - "delete": "d", - "favorite": "f", - "export": "x", - "sort": "s", - "permissions": "p", - "move": "m", - "revisions": "r", - - // Navigation - "next": "ArrowRight", - "prev": "ArrowLeft", -}; +import {Component} from './component'; function reverseMap(map) { const reversed = {}; @@ -38,46 +8,59 @@ function reverseMap(map) { return reversed; } -/** - * @extends {Component} - */ -class Shortcuts { +export class Shortcuts extends Component { setup() { this.container = this.$el; - this.mapById = defaultMap; + this.mapById = JSON.parse(this.$opts.keyMap); this.mapByShortcut = reverseMap(this.mapById); this.hintsShowing = false; this.hideHints = this.hideHints.bind(this); - // TODO - Allow custom key maps - // TODO - Allow turning off shortcuts + this.hintAbortController = null; this.setupListeners(); } setupListeners() { window.addEventListener('keydown', event => { - - if (event.target.closest('input, select, textarea')) { + if (event.target.closest('input, select, textarea, .cm-editor, .editor-container')) { return; } - const shortcutId = this.mapByShortcut[event.key]; - if (shortcutId) { - const wasHandled = this.runShortcut(shortcutId); - if (wasHandled) { - event.preventDefault(); + if (event.key === '?') { + if (this.hintsShowing) { + this.hideHints(); + } else { + this.showHints(); } + return; } + + this.handleShortcutPress(event); }); + } - window.addEventListener('keydown', event => { - if (event.key === '?') { - this.hintsShowing ? this.hideHints() : this.showHints(); + /** + * @param {KeyboardEvent} event + */ + handleShortcutPress(event) { + const keys = [ + event.ctrlKey ? 'Ctrl' : '', + event.metaKey ? 'Cmd' : '', + event.key, + ]; + + const combo = keys.filter(s => Boolean(s)).join(' + '); + + const shortcutId = this.mapByShortcut[combo]; + if (shortcutId) { + const wasHandled = this.runShortcut(shortcutId); + if (wasHandled) { + event.preventDefault(); } - }); + } } /** @@ -88,7 +71,6 @@ class Shortcuts { */ runShortcut(id) { const el = this.container.querySelector(`[data-shortcut="${id}"]`); - console.info('Shortcut run', el); if (!el) { return false; } @@ -109,12 +91,16 @@ class Shortcuts { return true; } - console.error(`Shortcut attempted to be ran for element type that does not have handling setup`, el); + console.error('Shortcut attempted to be ran for element type that does not have handling setup', el); return false; } showHints() { + const wrapper = document.createElement('div'); + wrapper.classList.add('shortcut-container'); + this.container.append(wrapper); + const shortcutEls = this.container.querySelectorAll('[data-shortcut]'); const displayedIds = new Set(); for (const shortcutEl of shortcutEls) { @@ -124,44 +110,52 @@ class Shortcuts { } const key = this.mapById[id]; - this.showHintLabel(shortcutEl, key); + this.showHintLabel(shortcutEl, key, wrapper); displayedIds.add(id); } - window.addEventListener('scroll', this.hideHints); - window.addEventListener('focus', this.hideHints); - window.addEventListener('blur', this.hideHints); - window.addEventListener('click', this.hideHints); + this.hintAbortController = new AbortController(); + const signal = this.hintAbortController.signal; + window.addEventListener('scroll', this.hideHints, {signal}); + window.addEventListener('focus', this.hideHints, {signal}); + window.addEventListener('blur', this.hideHints, {signal}); + window.addEventListener('click', this.hideHints, {signal}); this.hintsShowing = true; } - showHintLabel(targetEl, key) { + /** + * @param {Element} targetEl + * @param {String} key + * @param {Element} wrapper + */ + showHintLabel(targetEl, key, wrapper) { const targetBounds = targetEl.getBoundingClientRect(); + const label = document.createElement('div'); label.classList.add('shortcut-hint'); label.textContent = key; - this.container.append(label); + + const linkage = document.createElement('div'); + linkage.classList.add('shortcut-linkage'); + linkage.style.left = `${targetBounds.x}px`; + linkage.style.top = `${targetBounds.y}px`; + linkage.style.width = `${targetBounds.width}px`; + linkage.style.height = `${targetBounds.height}px`; + + wrapper.append(label, linkage); const labelBounds = label.getBoundingClientRect(); - label.style.insetInlineStart = `${((targetBounds.x + targetBounds.width) - (labelBounds.width + 12))}px`; + label.style.insetInlineStart = `${((targetBounds.x + targetBounds.width) - (labelBounds.width + 6))}px`; label.style.insetBlockStart = `${(targetBounds.y + (targetBounds.height - labelBounds.height) / 2)}px`; } hideHints() { - const hints = this.container.querySelectorAll('.shortcut-hint'); - for (const hint of hints) { - hint.remove(); - } - - window.removeEventListener('scroll', this.hideHints); - window.removeEventListener('focus', this.hideHints); - window.removeEventListener('blur', this.hideHints); - window.removeEventListener('click', this.hideHints); - + const wrapper = this.container.querySelector('.shortcut-container'); + wrapper.remove(); + this.hintAbortController?.abort(); this.hintsShowing = false; } -} -export default Shortcuts; \ No newline at end of file +}