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

CKEDITOR.menu

class
See source

Filtering

Methods

  • constructor() → menu

    See source

    Returns

    menu

  • 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.

  • 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

  • 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