InsertTextObserver (typing)
@ckeditor/ckeditor5-typing/src/inserttextobserver
Text insertion observer introduces the event-insertText event.
Filtering
Properties
-
A reference to the
Documentobject. -
isEnabled : Booleanmodule:typing/inserttextobserver~InsertTextObserver#isEnabledreadonly inherited
The state of the observer. If it is disabled, no events will be fired.
-
An instance of the view controller.
Methods
-
constructor( view )module:typing/inserttextobserver~InsertTextObserver#constructorinherited
Creates an instance of the observer.
Parameters
view : View
-
checkShouldIgnoreEventFromTarget( domTarget ) → Booleanmodule:typing/inserttextobserver~InsertTextObserver#checkShouldIgnoreEventFromTargetinherited
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-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 : 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.
-
destroy()module:typing/inserttextobserver~InsertTextObserver#destroyinherited
Disables and destroys the observer, among others removes event listeners created by the observer.
-
disable()module:typing/inserttextobserver~InsertTextObserver#disableinherited
Disables the observer. This method is called before rendering to prevent firing events during rendering.
Related:
-
enable()module:typing/inserttextobserver~InsertTextObserver#enableinherited
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.
Related:
-
observe( domElement, name )module:typing/inserttextobserver~InsertTextObserver#observeinherited
Starts observing the given root element.
Parameters
domElement : HTMLElementname : StringThe name of the root element.
Every day, we work hard to keep our documentation complete. Have you spotted an outdated information? Is something missing? Please report it via our issue tracker.