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

CKEDITOR.dialog.definition

class
See source

The definition of a dialog window.

This class is not really part of the API. It just illustrates the properties that developers can use to define and create dialogs.

// There is no constructor for this class, the user just has to define an
// object with the appropriate properties.

CKEDITOR.dialog.add( 'testOnly', function( editor ) {
    return {
        title:          'Test Dialog',
        resizable:      CKEDITOR.DIALOG_RESIZE_BOTH,
        minWidth:       500,
        minHeight:      400,
        contents: [
            {
                id:         'tab1',
                label:      'First Tab',
                title:      'First Tab Title',
                accessKey:  'Q',
                elements: [
                    {
                        type:           'text',
                        label:          'Test Text 1',
                        id:             'testText1',
                        'default':      'hello world!'
                    }
                ]
            }
        ]
    };
} );

Filtering

Properties

Methods

  • since 4.13.0

    getMode( editor ) → Number

    See source

    Returns the current dialog mode based on the state of the feature used with this dialog.

    See CKEDITOR.dialog.EDITING_MODE and CKEDITOR.dialog.CREATION_MODE.

    Parameters

    editor : editor

    Returns

    Number

    Dialog mode.

  • since 4.13.0

    getModel( editor ) → element | widget | Object | null

    See source

    Returns the subject of the dialog.

    For most plugins, like the table or link plugin, it should return a DOM element instance if there is an element related to the dialog. For widget plugins (image2, placeholder) it should return a CKEDITOR.plugins.widget instance that is the subject of this dialog.

    Parameters

    editor : editor

    Returns

    element | widget | Object | null

    Returns null if the dialog does not use the model.