CompositionObserver (engine/view/observer)
@ckeditor/ckeditor5-engine/src/view/observer/compositionobserver
Compositionstart, compositionupdate and compositionend events observer.
Note that this observer is attached by the View
and is available by default.
Filtering
Properties
-
readonly inherited
document : Document
module:engine/view/observer/compositionobserver~CompositionObserver#document
A reference to the
Document
object. -
readonly
domEventType : readonly tuple
module:engine/view/observer/compositionobserver~CompositionObserver#domEventType
-
readonly inherited
isEnabled : boolean
module:engine/view/observer/compositionobserver~CompositionObserver#isEnabled
The state of the observer. If it is disabled, no events will be fired.
-
inherited
useCapture : boolean
module:engine/view/observer/compositionobserver~CompositionObserver#useCapture
If set to
true
DOM events will be listened on the capturing phase. Default value isfalse
. -
inherited
usePassive : boolean
module:engine/view/observer/compositionobserver~CompositionObserver#usePassive
If set to
true
, indicates that the function specified by listener will never callpreventDefault()
. Default value isfalse
. -
readonly inherited
view : View
module:engine/view/observer/compositionobserver~CompositionObserver#view
An instance of the view controller.
Methods
-
constructor( view )
module:engine/view/observer/compositionobserver~CompositionObserver#constructor
-
inherited
checkShouldIgnoreEventFromTarget( domTarget ) → boolean
module:engine/view/observer/compositionobserver~CompositionObserver#checkShouldIgnoreEventFromTarget
Checks 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-events
attribute. 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 | Node
The DOM event target to check (usually an element, sometimes a text node and potentially sometimes a document, too).
Returns
boolean
Whether this event should be ignored by the observer.
-
inherited
delegate( events ) → EmitterMixinDelegateChain
module:engine/view/observer/compositionobserver~CompositionObserver#delegate
Delegates selected events to another
Emitter
. For instance:emitterA.delegate( 'eventX' ).to( emitterB ); emitterA.delegate( 'eventX', 'eventY' ).to( emitterC );
then
eventX
is delegated (fired by)emitterB
andemitterC
along withdata
:emitterA.fire( 'eventX', data );
and
eventY
is delegated (fired by)emitterC
along withdata
:emitterA.fire( 'eventY', data );
Parameters
events : Array<string>
Event names that will be delegated to another emitter.
Returns
-
inherited
destroy() → void
module:engine/view/observer/compositionobserver~CompositionObserver#destroy
Disables and destroys the observer, among others removes event listeners created by the observer.
Returns
void
-
inherited
disable() → void
module:engine/view/observer/compositionobserver~CompositionObserver#disable
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
View
and 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( eventType, domEvent, [ additionalData ] ) → void
module:engine/view/observer/compositionobserver~CompositionObserver#fire
Calls
Document#fire()
if observer is enabled.Parameters
eventType : string | EventInfo<string, unknown>
The event type (name).
domEvent : Event
The DOM event.
[ additionalData ] : object
The additional data which should extend the event data object.
Returns
void
Related:
-
inherited
listenTo( emitter, event, callback, [ options ] ) → void
module:engine/view/observer/compositionobserver~CompositionObserver#listenTo:DOM_EMITTER
Registers 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
fire
method.Type parameters
Parameters
emitter : Emitter
The object that fires the event.
event : TEvent[ 'name' ]
The name of the event.
callback : GetCallback<TEvent>
The function to be called on event.
[ options ] : CallbackOptions
Additional options.
Returns
void
-
inherited
listenTo( emitter, event, callback, [ options ] ) → void
module:engine/view/observer/compositionobserver~CompositionObserver#listenTo:HTML_EMITTER
Registers 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 | Node
The object that fires the event.
event : K
The name of the event.
callback : ( CompositionObserver, EventInfo<string, unknown>, DomEventMap[ K ] ) => void
The function to be called on event.
[ options ] : object
Additional options.
Returns
void
-
inherited
observe( domElement ) → void
module:engine/view/observer/compositionobserver~CompositionObserver#observe
Starts observing given DOM element.
Parameters
domElement : HTMLElement
DOM element to observe.
Returns
void
-
inherited
off( event, callback ) → void
module:engine/view/observer/compositionobserver~CompositionObserver#off
Stops executing the callback on the given event. Shorthand for
this.stopListening( this, event, callback )
.Parameters
event : string
The name of the event.
callback : Function
The function to stop being called.
Returns
void
-
inherited
on( event, callback, [ options ] ) → void
module:engine/view/observer/compositionobserver~CompositionObserver#on
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
-
onDomEvent( domEvent ) → void
module:engine/view/observer/compositionobserver~CompositionObserver#onDomEvent
Callback which should be called when the DOM event occurred. Note that the callback will not be called if observer is not enabled.
Parameters
domEvent : CompositionEvent
Returns
void
Related:
-
inherited
once( event, callback, [ options ] ) → void
module:engine/view/observer/compositionobserver~CompositionObserver#once
Registers a callback function to be executed on the next time the event is fired only. This is similar to calling
on
followed byoff
in 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 ] ) → void
module:engine/view/observer/compositionobserver~CompositionObserver#stopDelegating
Stops 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 ] : string
The 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 ofevent
to all emitters.
Returns
void
-
inherited
stopListening( [ emitter ], [ event ], [ callback ] ) → void
module:engine/view/observer/compositionobserver~CompositionObserver#stopListening:DOM_STOP
Stops 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 | Emitter
The 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
-
inherited
stopObserving( domElement ) → void
module:engine/view/observer/compositionobserver~CompositionObserver#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.