CKEditor Ecosystem Documentation
Search
Home/CKEditor 5/API
Class

EditingKeystrokeHandler (core)

@ckeditor/ckeditor5-core/src/editingkeystrokehandler

class
See source

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

    See source

    The editor instance.

  • protected inherited

    _listener : Emitter

    See source

    Listener used to listen to events for easier keystroke handler destruction.

Methods

  • constructor( editor )

    See source

    Creates an instance of the keystroke handler.

    Parameters

    editor : Editor

  • inherited

    destroy()

    See source

    Destroys the keystroke handler.

  • inherited

    listenTo( emitter )

    See source

    Starts listening for keydown events from a given emitter.

    Parameters

    emitter : Emitter

  • inherited

    press( keyEvtData ) → Boolean

    See source

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

    Parameters

    keyEvtData : KeyEventData

    Key event data.

    Returns

    Boolean

    Whether the keystroke was handled.

  • inherited

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

    See source

    Registers a handler for the specified keystroke.

    Parameters

    keystroke : String | Array.<(String | Number)>

    Keystroke defined in a format accepted by the parseKeystroke function.

    callback : function

    A function called with the key event data object and a helper funcion to call both preventDefault() and stopPropagation() on the underlying event.

    [ options ] : Object

    Additional options.

    Properties
    [ options.priority ] : PriorityString | Number

    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 'normal'

    Defaults to {}