CKEditor 4
Report an issue
Class

CKEDITOR.ui.dialog.file

class

A file upload input.

Filtering

Properties

Methods

  • constructor( dialog, elementDefinition, htmlList ) → file

    Creates a file class instance.

    Parameters

    dialog : dialog

    Parent dialog window object.

    elementDefinition : uiElement

    The element definition. Accepted fields:

    • validate (Optional) The validation function.
    htmlList : Array

    List of HTML code to output to.

    Returns

    file
    Overrides: CKEDITOR.ui.dialog.labeledElement.constructor

  • accessKeyDown( dialog, key )

    The default handler for a UI element's access key down event, which tries to put focus to the UI element.

    Can be overridded in child classes for more sophisticaed behavior.

    Parameters

    dialog : dialog

    The parent dialog object.

    key : String

    The key combination pressed. Since access keys are defined to always include the CTRL key, its value should always include a 'CTRL+' prefix.

  • accessKeyUp( dialog, key )

    The default handler for a UI element's access key up event, which does nothing.

    Can be overridded in child classes for more sophisticated behavior.

    Parameters

    dialog : dialog

    The parent dialog object.

    key : String

    The key combination pressed. Since access keys are defined to always include the CTRL key, its value should always include a 'CTRL+' prefix.

  • disable()

    Disables a UI element.

  • enable()

    Enables a UI element.

  • 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

  • getAction() → String

    Gets the action assigned to the form.

    Returns

    String

    The value of the action.

  • 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 <input> element of this file input.

    Returns

    element

    The file input element.

    Overrides: CKEDITOR.ui.dialog.uiElement.getInputElement

  • getLabel() → String

    Retrieves the current label text of the elment.

    Returns

    String

    The current label text.

  • 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

    Determines whether an UI element is enabled or not.

    Returns

    Boolean

    Whether the UI element is enabled.

  • 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

    Determines whether an UI element is visible or not.

    Returns

    Boolean

    Whether the UI element is visible.

  • registerEvents( definition ) → file

    chainable

    The events must be applied to the inner input element, and this must be done when the iframe and form have been loaded.

    Parameters

    definition : Object

    Returns

    file

    this

    Overrides: CKEDITOR.ui.dialog.uiElement.registerEvents

  • reset()

    Redraws the file input and resets the file path in the file input. The redrawing logic is necessary because non-IE browsers tend to clear the <iframe> containing the file input after closing the dialog window.

  • 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

  • setInitValue()

    The default value of input type="file" is an empty string, but during the initialization of this UI element, the iframe still is not ready so it cannot be read from that object. Setting it manually prevents later issues with the current value ('') being different than the initial value (undefined as it asked for .value of a div).

  • setLabel( label ) → labeledElement

    chainable

    Sets the label text of the element.

    Parameters

    label : String

    The new label text.

    Returns

    labeledElement

    The current labeled element.

  • 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

  • submit() → file

    chainable

    Uploads the file in the file input.

    Returns

    file

    This object.

Events

  • change( evt )

    Fired when the value of the uiElement is changed.

    Parameters

    evt : eventInfo