This repository has been archived by the owner on Jun 26, 2020. It is now read-only.
/
editingkeystrokehandler.js
72 lines (65 loc) · 2.34 KB
/
editingkeystrokehandler.js
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
/**
* @license Copyright (c) 2003-2019, CKSource - Frederico Knabben. All rights reserved.
* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
*/
/**
* @module core/editingkeystrokehandler
*/
import KeystrokeHandler from '@ckeditor/ckeditor5-utils/src/keystrokehandler';
/**
* A keystroke handler for editor editing. Its instance is available
* in {@link module:core/editor/editor~Editor#keystrokes} so plugins
* can register their keystrokes.
*
* E.g. an undo plugin would do this:
*
* editor.keystrokes.set( 'Ctrl+Z', 'undo' );
* editor.keystrokes.set( 'Ctrl+Shift+Z', 'redo' );
* editor.keystrokes.set( 'Ctrl+Y', 'redo' );
*
* @extends module:utils/keystrokehandler~KeystrokeHandler
*/
export default class EditingKeystrokeHandler extends KeystrokeHandler {
/**
* Creates an instance of the keystroke handler.
*
* @param {module:core/editor/editor~Editor} editor
*/
constructor( editor ) {
super();
/**
* The editor instance.
*
* @readonly
* @member {module:core/editor/editor~Editor}
*/
this.editor = editor;
}
/**
* Registers a handler for the specified keystroke.
*
* The handler can be specified as a command name or a callback.
*
* @param {String|Array.<String|Number>} keystroke Keystroke defined in a format accepted by
* the {@link module:utils/keyboard~parseKeystroke} function.
* @param {Function|String} callback If a string is passed, then the keystroke will
* {@link module:core/editor/editor~Editor#execute execute a command}.
* If a function, then it will be called with the
* {@link module:engine/view/observer/keyobserver~KeyEventData key event data} object and
* a `cancel()` helper to both `preventDefault()` and `stopPropagation()` of the event.
* @param {Object} [options={}] Additional options.
* @param {module:utils/priorities~PriorityString|Number} [options.priority='normal'] The priority of the keystroke
* callback. The higher the priority value the sooner the callback will be executed. Keystrokes having the same priority
* are called in the order they were added.
*/
set( keystroke, callback, options = {} ) {
if ( typeof callback == 'string' ) {
const commandName = callback;
callback = ( evtData, cancel ) => {
this.editor.execute( commandName );
cancel();
};
}
super.set( keystroke, callback, options );
}
}