Class

EditingKeystrokeHandler (core)

@ckeditor/ckeditor5-core/src/editingkeystrokehandler

class

A keystroke handler for editor editing. Its instance is available in 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' );

Filtering

Properties

  • readonly

    editor : Editor

    The editor instance.

Methods

  • constructor( editor )

    Creates an instance of the keystroke handler.

    Parameters

    editor : Editor
  • inherited

    destroy() → void

    Destroys the keystroke handler.

    Returns

    void
  • inherited

    listenTo( emitter ) → void

    Starts listening for keydown events from a given emitter.

    Parameters

    emitter : Emitter | HTMLElement | Window

    Returns

    void
  • inherited

    press( keyEvtData ) → boolean

    Triggers a keystroke handler for a specified key combination, if such a keystroke was defined.

    Parameters

    keyEvtData : Readonly<KeystrokeInfo>

    Key event data.

    Returns

    boolean

    Whether the keystroke was handled.

  • set( keystroke, callback, options = { [options.priority] } ) → void

    Registers a handler for the specified keystroke.

    The handler can be specified as a command name or a callback.

    Parameters

    keystroke : string | Array<string | number>

    Keystroke defined in a format accepted by the parseKeystroke function.

    callback : EditingKeystrokeCallback

    If a string is passed, then the keystroke will execute a command. If a function, then it will be called with the key event data object and a cancel() helper to both preventDefault() and stopPropagation() of the event.

    options : object

    Additional options.

    Properties
    [ options.priority ] : PriorityString

    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.

    Defaults to {}

    Returns

    void
  • inherited

    stopListening( [ emitter ] ) → void

    Stops listening to keydown events from the given emitter.

    Parameters

    [ emitter ] : Emitter | HTMLElement | Window

    Returns

    void