CKEditor Ecosystem Documentation
Search
Report an issue
Home/CKEditor 4/API
Class

CKEDITOR.plugins.contextMenu

class
See source

Class replacing the non-configurable native context menu with a configurable CKEditor's equivalent.

Filtering

Methods

  • constructor( editor ) → contextMenu

    Creates the CKEDITOR.plugins.contextMenu class instance.

    See source

    Parameters

    editor : editor

    Returns

    contextMenu

  • add( item )

    Adds an item.

    See source

    Parameters

    item : Object

  • addListener( listenerFn )

    Adds a callback executed on opening the menu. Items returned by that callback are added to the menu.

    See source

    Parameters

    listenerFn : Function
    Properties
    startElement : element

    The selection start anchor element.

    selection : selection

    The current selection.

    path : elementPath

    The current elements path.

    return

    Object (commandName => state) of items that should be added to the menu.

  • addTarget( element, [ nativeContextMenuOnCtrl ] )

    Starts watching on native context menu triggers (Option key, right click) on the given element.

    See source

    Parameters

    element : element
    [ nativeContextMenuOnCtrl ] : Boolean

    Whether to open native context menu if the Ctrl key is held on opening the context menu. See CKEDITOR.config.browserContextMenuOnCtrl.

  • findItemByCommandName( commandName ) → Object | null

    since 4.9.0

    Finds the menu item corresponding to a given command.

    See source

    Notice: Keep in mind that the menu is re-rendered on each opening, so caching items (especially DOM elements) may not work. Also executing this method when the menu is not visible may give unexpected results as the items may not be rendered.

    Parameters

    commandName : String

    Returns

    Object | null

    return An object containing a given item. If the item was not found, null is returned.

    Properties
    item : menuItem

    The item definition.

    element : element

    The rendered element representing the item in the menu.

  • hide( [ returnFocus ] )

    Hides the menu.

    See source

    Parameters

    [ returnFocus ] : Boolean

  • open( offsetParent, [ corner ], [ offsetX ], [ offsetY ] )

    Opens the context menu in the given location. See the CKEDITOR.menu.show method.

    See source

    Parameters

    offsetParent : element
    [ corner ] : Number
    [ offsetX ] : Number
    [ offsetY ] : Number

  • removeAll()

    Removes all items.

    See source

  • show( offsetParent, [ corner ], [ offsetX ], [ offsetY ] )

    Shows the menu in given location.

    See source

    Parameters

    offsetParent : element
    [ corner ] : Number
    [ offsetX ] : Number
    [ offsetY ] : Number