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

  • inherited

    constructor() → menu

    See source

    Returns

    menu

  • inherited

    add( item )

    See source

    Adds an item.

    Parameters

    item : Object

  • inherited

    addListener( listenerFn )

    See source

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

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

    See source

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

    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.

  • since 4.9.0 inherited

    findItemByCommandName( commandName ) → Object | null

    See source

    Finds the menu item corresponding to a given command.

    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.

  • inherited

    hide( [ returnFocus ] )

    See source

    Hides the menu.

    Parameters

    [ returnFocus ] : Boolean

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

    See source

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

    Parameters

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

  • inherited

    removeAll()

    See source

    Removes all items.

  • inherited

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

    See source

    Shows the menu in given location.

    Parameters

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