ImageLoadObserver (image/image)
@ckeditor/ckeditor5-image/src/image/imageloadobserver
Observes all new images added to the Document
,
fires event-imageLoaded and
event-layoutChanged event every time when the new image
has been loaded.
Note: This event is not fired for images that has been added to the document and rendered as complete
(already loaded).
Filtering
Properties
-
readonly inherited
document : Document
module:image/image/imageloadobserver~ImageLoadObserver#document
A reference to the
Document
object. -
readonly inherited
isEnabled : boolean
module:image/image/imageloadobserver~ImageLoadObserver#isEnabled
The state of the observer. If it is disabled, no events will be fired.
-
An instance of the view controller.
Methods
-
-
inherited
checkShouldIgnoreEventFromTarget( domTarget ) → boolean
module:image/image/imageloadobserver~ImageLoadObserver#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:image/image/imageloadobserver~ImageLoadObserver#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
-
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
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( eventOrInfo, args ) → GetEventInfo<TEvent>[ 'return' ]
module:image/image/imageloadobserver~ImageLoadObserver#fire
Fires an event, executing all callbacks registered for it.
The first parameter passed to callbacks is an
EventInfo
object, followed by the optionalargs
provided in thefire()
method call.Type parameters
Parameters
eventOrInfo : GetNameOrEventInfo<TEvent>
The name of the event or
EventInfo
object 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 ] ) → void
module:image/image/imageloadobserver~ImageLoadObserver#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:image/image/imageloadobserver~ImageLoadObserver#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 : ( ImageLoadObserver, EventInfo<string, unknown>, DomEventMap[ K ] ) => void
The function to be called on event.
[ options ] : object
Additional options.
Returns
void
-
observe( domRoot ) → void
module:image/image/imageloadobserver~ImageLoadObserver#observe
Starts observing given DOM element.
Parameters
domRoot : HTMLElement
DOM element to observe.
Returns
void
-
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:image/image/imageloadobserver~ImageLoadObserver#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
-
inherited
once( event, callback, [ options ] ) → void
module:image/image/imageloadobserver~ImageLoadObserver#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:image/image/imageloadobserver~ImageLoadObserver#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:image/image/imageloadobserver~ImageLoadObserver#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
-
stopObserving( domRoot ) → void
module:image/image/imageloadobserver~ImageLoadObserver#stopObserving
-
private
_fireEvents( domEvent ) → void
module:image/image/imageloadobserver~ImageLoadObserver#_fireEvents
Fires event-layoutChanged and event-imageLoaded if observer is enabled.
Parameters
domEvent : Event
The DOM event.
Returns
void
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.