CKEditor 4
Report an issue
Class

CKEDITOR.ui.dialog.button

class

A button with a label inside.

Filtering

Properties

Methods

  • constructor( dialog, elementDefinition, htmlList ) → button

    Creates a button class instance.

    Parameters

    dialog : dialog

    Parent dialog window object.

    elementDefinition : uiElement

    The element definition. Accepted fields:

    • label (Required) The button label.
    • disabled (Optional) Set to true if you want the button to appear in the disabled state.
    htmlList : Array

    List of HTML code to output to.

    Returns

    button
    Overrides: CKEDITOR.ui.dialog.uiElement.constructor

  • accessKeyDown()

    Handler for the element's access key down event. Simulates a mouse down to the button.

    Overrides: CKEDITOR.ui.dialog.uiElement.accessKeyDown

  • accessKeyUp()

    Handler for the element's access key up event. Simulates a click to the button.

    Overrides: CKEDITOR.ui.dialog.uiElement.accessKeyUp

  • click() → Object

    Simulates a click to the button.

    Returns

    Object

    Return value of the click event.

  • disable()

    Disables the button.

    Overrides: CKEDITOR.ui.dialog.uiElement.disable

  • enable()

    Enables the button.

    Overrides: CKEDITOR.ui.dialog.uiElement.enable

  • focus() → uiElement

    chainable

    Puts the focus to the UI object. Switches tabs if the UI object isn't in the active tab page. 

    uiElement.focus();

    Returns

    uiElement

    this

  • getDialog() → dialog

    Gets the parent dialog object containing this UI element. 

    var dialog = uiElement.getDialog();

    Returns

    dialog

    Parent dialog object.

  • getElement() → element

    Gets the root DOM element of this dialog UI object. 

    uiElement.getElement().hide();

    Returns

    element

    Root DOM element of UI object.

  • getInputElement() → element

    Gets the DOM element that the user inputs values.

    This function is used by setValue, getValue and focus. It should be overrided in child classes where the input element isn't the root element.

    var rawValue = textInput.getInputElement().$.value;

    Returns

    element

    The element where the user input values.

  • getValue() → Object

    Gets the current value of this dialog UI object. 

    var myValue = uiElement.getValue();

    Returns

    Object

    The current value.

  • isChanged() → Boolean

    Tells whether the UI object's value has changed. 

    if ( uiElement.isChanged() )
    confirm( 'Value changed! Continue?' );

    Returns

    Boolean

    true if changed, false if not changed.

  • isEnabled() → Boolean

    Checks whether a field is enabled. Fields can be disabled by using the disable method and enabled by using the enable method.

    Returns

    Boolean
    Overrides: CKEDITOR.ui.dialog.uiElement.isEnabled

  • isFocusable() → Boolean

    Determines whether an UI element is focus-able or not. Focus-able is defined as being both visible and enabled.

    Returns

    Boolean

    Whether the UI element can be focused.

  • isVisible() → Boolean

    Checks whether a field is visible.

    Returns

    Boolean
    Overrides: CKEDITOR.ui.dialog.uiElement.isVisible

  • registerEvents( definition ) → uiElement

    chainable

    Registers the on* event handlers defined in the element definition.

    The default behavior of this function is:

    1. If the on* event is defined in the class's eventProcesors list, then the registration is delegated to the corresponding function in the eventProcessors list.
    2. If the on* event is not defined in the eventProcessors list, then register the event handler under the corresponding DOM event of the UI element's input DOM element (as defined by the return value of getInputElement).

    This function is only called at UI element instantiation, but can be overridded in child classes if they require more flexibility.

    Parameters

    definition : uiElement

    The UI element definition.

    Returns

    uiElement

    this

  • selectParentTab() → uiElement

    chainable

    Selects the parent tab of this element. Usually called by focus() or overridden focus() methods. 

    focus : function() {
    this.selectParentTab();
    // do something else.
}

    Returns

    uiElement

    this

  • setValue( value, noChangeEvent ) → uiElement

    chainable

    Sets the value of this dialog UI object. 

    uiElement.setValue( 'Dingo' );

    Parameters

    value : Object

    The new value.

    noChangeEvent : Boolean

    Internal commit, to supress change event on this element.

    Returns

    uiElement

    this

Events

  • change( evt )

    Fired when the value of the uiElement is changed.

    Parameters

    evt : eventInfo