ImageLoadObserver (image/image)



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).



  • readonly inherited

    document : Document

    A reference to the Document object.

  • readonly inherited

    isEnabled : Boolean

    The state of the observer. If it is disabled, no events will be fired.

  • readonly inherited

    view : View

    An instance of the view controller.


  • inherited

    constructor( view )

    Creates an instance of the observer.


    view : View
  • inherited

    checkShouldIgnoreEventFromTarget( domTarget ) → Boolean

    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 by DowncastWriter#createUIElement() to ignore events fired within a UI that should be excluded from CKEditor 5's realms.


    domTarget : Node

    The DOM event target to check (usually an element, sometimes a text node and potentially sometimes a document, too).



    Whether this event should be ignored by the observer.

  • inherited


    Disables and destroys the observer, among others removes event listeners created by the observer.

  • inherited


    Disables the observer. This method is called before rendering to prevent firing events during rendering.


  • inherited


    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.


  • inherited

    observe( domElement, name )

    Starts observing the given root element.


    domElement : HTMLElement
    name : String

    The name of the root element.

  • protected

    _fireEvents( domEvent )

    Fires event-layoutChanged and event-imageLoaded if observer is enabled.


    domEvent : Event

    The DOM event.