EnterObserver (enter)
@ckeditor/ckeditor5-enter/src/enterobserver
Enter observer introduces the Document#enter event.
Filtering
Properties
-
A reference to the
Documentobject. -
The state of the observer. If it is disabled, no events will be fired.
-
An instance of the view controller.
Methods
-
constructor( view )module:enter/enterobserver~EnterObserver#constructor -
inherited
checkShouldIgnoreEventFromTarget( domTarget ) → booleanmodule:enter/enterobserver~EnterObserver#checkShouldIgnoreEventFromTargetChecks whether a given DOM event should be ignored (should not be turned into a synthetic view document event).
Currently, an event will be ignored only if its target or any of its ancestors has the
data-cke-ignore-eventsattribute. This attribute can be used inside the structures generated byDowncastWriter#createUIElement()to ignore events fired within a UI that should be excluded from CKEditor 5's realms.Parameters
domTarget : null | NodeThe DOM event target to check (usually an element, sometimes a text node and potentially sometimes a document, too).
Returns
booleanWhether this event should be ignored by the observer.
-
inherited
delegate( events ) → EmitterMixinDelegateChainmodule:enter/enterobserver~EnterObserver#delegateDelegates selected events to another
Emitter. For instance:emitterA.delegate( 'eventX' ).to( emitterB ); emitterA.delegate( 'eventX', 'eventY' ).to( emitterC );then
eventXis delegated (fired by)emitterBandemitterCalong withdata:emitterA.fire( 'eventX', data );and
eventYis delegated (fired by)emitterCalong withdata:emitterA.fire( 'eventY', data );Parameters
events : Array<string>Event names that will be delegated to another emitter.
Returns
-
Disables and destroys the observer, among others removes event listeners created by the observer.
Returns
void
-
Disables the observer. This method is called before rendering to prevent firing events during rendering.
Returns
void
Related:
-
Enables the observer. This method is called when the observer is registered to the
Viewand after rendering (all observers are disabled before rendering).A typical use case for disabling observers is that mutation observers need to be disabled for the rendering. However, a child class may not need to be disabled, so it can implement an empty method.
Returns
void
Related:
-
inherited
fire( eventOrInfo, args ) → GetEventInfo<TEvent>[ 'return' ]module:enter/enterobserver~EnterObserver#fireFires an event, executing all callbacks registered for it.
The first parameter passed to callbacks is an
EventInfoobject, followed by the optionalargsprovided in thefire()method call.Type parameters
Parameters
eventOrInfo : GetNameOrEventInfo<TEvent>The name of the event or
EventInfoobject if event is delegated.args : TEvent[ 'args' ]Additional arguments to be passed to the callbacks.
Returns
GetEventInfo<TEvent>[ 'return' ]By default the method returns
undefined. However, the return value can be changed by listeners through modification of theevt.return's property (the event info is the first param of every callback).
-
inherited
listenTo( emitter, event, callback, [ options ] ) → voidmodule:enter/enterobserver~EnterObserver#listenTo:DOM_EMITTERRegisters a callback function to be executed when an event is fired in a specific (emitter) object.
Events can be grouped in namespaces using
:. When namespaced event is fired, it additionally fires all callbacks for that namespace.// myEmitter.on( ... ) is a shorthand for myEmitter.listenTo( myEmitter, ... ). myEmitter.on( 'myGroup', genericCallback ); myEmitter.on( 'myGroup:myEvent', specificCallback ); // genericCallback is fired. myEmitter.fire( 'myGroup' ); // both genericCallback and specificCallback are fired. myEmitter.fire( 'myGroup:myEvent' ); // genericCallback is fired even though there are no callbacks for "foo". myEmitter.fire( 'myGroup:foo' );An event callback can stop the event and set the return value of the
firemethod.Type parameters
Parameters
emitter : EmitterThe object that fires the event.
event : TEvent[ 'name' ]The name of the event.
callback : GetCallback<TEvent>The function to be called on event.
[ options ] : CallbackOptionsAdditional options.
Returns
void
-
inherited
listenTo( emitter, event, callback, [ options ] ) → voidmodule:enter/enterobserver~EnterObserver#listenTo:HTML_EMITTERRegisters a callback function to be executed when an event is fired in a specific Emitter or DOM Node. It is backwards compatible with
listenTo.Type parameters
K : extends keyof DomEventMap
Parameters
emitter : Window | NodeThe object that fires the event.
event : KThe name of the event.
callback : ( EnterObserver, EventInfo<string, unknown>, DomEventMap[ K ] ) => voidThe function to be called on event.
[ options ] : objectAdditional options.
Returns
void
-
observe() → voidmodule:enter/enterobserver~EnterObserver#observe -
Stops executing the callback on the given event. Shorthand for
this.stopListening( this, event, callback ).Parameters
event : stringThe name of the event.
callback : FunctionThe function to stop being called.
Returns
void
-
Registers a callback function to be executed when an event is fired.
Shorthand for
this.listenTo( this, event, callback, options )(it makes the emitter listen on itself).Type parameters
Parameters
event : TEvent[ 'name' ]The name of the event.
callback : GetCallback<TEvent>The function to be called on event.
[ options ] : GetCallbackOptions<TEvent>Additional options.
Returns
void
-
Registers a callback function to be executed on the next time the event is fired only. This is similar to calling
onfollowed byoffin the callback.Type parameters
Parameters
event : TEvent[ 'name' ]The name of the event.
callback : GetCallback<TEvent>The function to be called on event.
[ options ] : GetCallbackOptions<TEvent>Additional options.
Returns
void
-
inherited
stopDelegating( [ event ], [ emitter ] ) → voidmodule:enter/enterobserver~EnterObserver#stopDelegatingStops delegating events. It can be used at different levels:
- To stop delegating all events.
- To stop delegating a specific event to all emitters.
- To stop delegating a specific event to a specific emitter.
Parameters
[ event ] : stringThe name of the event to stop delegating. If omitted, stops it all delegations.
[ emitter ] : Emitter(requires
event) The object to stop delegating a particular event to. If omitted, stops delegation ofeventto all emitters.
Returns
void
-
inherited
stopListening( [ emitter ], [ event ], [ callback ] ) → voidmodule:enter/enterobserver~EnterObserver#stopListening:DOM_STOPStops listening for events. It can be used at different levels: It is backwards compatible with
listenTo.- To stop listening to a specific callback.
- To stop listening to a specific event.
- To stop listening to all events fired by a specific object.
- To stop listening to all events fired by all objects.
Parameters
[ emitter ] : Window | Node | EmitterThe object to stop listening to. If omitted, stops it for all objects.
[ event ] : string(Requires the
emitter) The name of the event to stop listening to. If omitted, stops it for all events fromemitter.[ callback ] : Function(Requires the
event) The function to be removed from the call list for the givenevent.
Returns
void
-
stopObserving() → voidmodule:enter/enterobserver~EnterObserver#stopObserving
Every day, we work hard to keep our documentation complete. Have you spotted outdated information? Is something missing? Please report it via our issue tracker.
With the release of version 42.0.0, we have rewritten much of our documentation to reflect the new import paths and features. We appreciate your feedback to help us ensure its accuracy and completeness.