CKEditor Ecosystem Documentation
Search
Home/CKEditor 5/API
Class

Observer (engine/view/observer)

@ckeditor/ckeditor5-engine/src/view/observer/observer

class
See source

Abstract base observer class. Observers are classes which listen to DOM events, do the preliminary processing and fire events on the Document objects. Observers can also add features to the view, for instance by updating its status or marking elements which need refresh on DOM events.

Filtering

Properties

  • document : Document

    readonly

    Reference to the Document object.

    See source

  • isEnabled : Boolean

    readonly

    State of the observer. If it is disabled events will not be fired.

    See source

  • view : View

    readonly

    Instance of the view controller.

    See source

Methods

  • constructor( view )

    Creates an instance of the observer.

    See source

    Parameters

    view : View

  • destroy()

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

    See source

  • disable()

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

    See source

    Related:

  • enable()

    Enables the observer. This method is called when the observer is registered to the View and after rendering (all observers are disabled before rendering).

    See source

    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.

    Related:

  • observe( domElement, name )

    Starts observing the given root element.

    See source

    Parameters

    domElement : HTMLElement
    name : String

    The name of the root element.