Class

BubblingEventInfo (engine/view/observer)

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

class

The event object passed to bubbling event callbacks. It is used to provide information about the event as well as a tool to manipulate it.

Filtering

Properties

  • currentTarget : Document | Node | null

    readonly

    The current bubbling target.

  • eventPhase : 'none' | 'capturing' | 'atTarget' | 'bubbling'

    readonly

    The current event phase.

  • name : String

    readonly inherited

    The event name.

  • path : Array.<Object>

    readonly inherited

    Path this event has followed. See delegate.

  • return

    inherited

    The value which will be returned by fire.

    It's undefined by default and can be changed by an event listener:

    dataController.fire( 'getSelectedContent', ( evt ) => {
    	// This listener will make `dataController.fire( 'getSelectedContent' )`
    	// always return an empty DocumentFragment.
    	evt.return = new DocumentFragment();
    
    	// Make sure no other listeners are executed.
    	evt.stop();
    } );
  • source : Object

    readonly inherited

    The object that fired the event.

  • startRange : Range

    readonly

    The view range that the bubbling should start from.

  • _currentTarget : Document | Node | null

    protected

    The current bubbling target.

  • _eventPhase : 'none' | 'capturing' | 'atTarget' | 'bubbling'

    protected

    The current event phase.

Methods

  • constructor( source, name, startRange )

    Parameters

    source : Object

    The emitter.

    name : String

    The event name.

    startRange : Range

    The view range that the bubbling should start from.

  • off()

    inherited

    Removes the current callback from future interactions of this event.

  • stop()

    inherited

    Stops the event emitter to call further callbacks for this event interaction.