Namespace CKEDITOR

Defined in: core/ckeditor_base.js.

Namespace Summary
Constructor Attributes	Constructor Name and Description
	CKEDITOR This is the API entry point.

Constants Summary
Constant Attributes	Constant Name and Description
<static>	CKEDITOR.ALT ALT key (4000).
<static>	CKEDITOR.CTRL CTRL key (1000).
<static>	CKEDITOR.DIALOG_RESIZE_HEIGHT Only allow vertical resizing for this dialog, disable horizontal resizing.
<static>	CKEDITOR.DIALOG_RESIZE_NONE No resize for this dialog.
<static>	CKEDITOR.DIALOG_RESIZE_WIDTH Only allow horizontal resizing for this dialog, disable vertical resizing.
<static>	CKEDITOR.ELEMENT_MODE_APPENDTO The editor is to be created inside the element.
<static>	CKEDITOR.ELEMENT_MODE_NONE No element is linked to the editor instance.
<static>	CKEDITOR.ELEMENT_MODE_REPLACE The element is to be replaced by the editor instance.
<static>	CKEDITOR.NODE_COMMENT Comment node type.
<static>	CKEDITOR.NODE_DOCUMENT Document node type.
<static>	CKEDITOR.NODE_ELEMENT Element node type.
<static>	CKEDITOR.NODE_TEXT Text node type.
<static>	CKEDITOR.SELECTION_ELEMENT Element selection.
<static>	CKEDITOR.SELECTION_NONE No selection.
<static>	CKEDITOR.SELECTION_TEXT Text or collapsed selection.
<static>	CKEDITOR.SHIFT SHIFT key (2000).
<static>	CKEDITOR.TRISTATE_DISABLED Used to indicate DISABLED state.
<static>	CKEDITOR.TRISTATE_OFF Used to indicate the OFF or NON ACTIVE state.
<static>	CKEDITOR.TRISTATE_ON Used to indicate the ON or ACTIVE state.
<static>	CKEDITOR.UI_BUTTON Button UI element.
<static>	CKEDITOR.UI_MENUBUTTON Button UI element.
<static>	CKEDITOR.UI_PANEL Panel UI element.
<static>	CKEDITOR.UI_PANELBUTTON Button UI element.
<static>	CKEDITOR.UI_RICHCOMBO Button UI element.

Field Summary
Field Attributes	Field Name and Description
<static>	CKEDITOR.basePath Contains the full URL for the CKEditor installation directory.
<static>	CKEDITOR.dataProcessor Represents a data processor, which is responsible to translate and transform the editor data on input and output.
<static>	CKEDITOR.document The document of the window holding the CKEDITOR object.
<static>	CKEDITOR.instances Holds references to all editor instances created.
<static>	CKEDITOR.loadFullCoreTimeout The time to wait (in seconds) to load the full editor code after the page load, if the "ckeditor_basic" file is used.
<static>	CKEDITOR.replaceByClassEnabled Enables the replacement of all textareas with class name matching CKEDITOR.replaceClass.
<static>	CKEDITOR.replaceClass The class name used to identify <textarea> elements to be replace by CKEditor instances.
<static>	CKEDITOR.revision Contains the CKEditor revision number.
<static>	CKEDITOR.START Check boundary types.
<static>	CKEDITOR.status Indicates the API loading status.
<static>	CKEDITOR.timestamp A constant string unique for each release of CKEditor.
<static>	CKEDITOR.version Contains the CKEditor version number.

Method Summary
Method Attributes	Method Name and Description
<static>	CKEDITOR.add(editor) Adds an editor instance to the global CKEDITOR object.
<static>	CKEDITOR.addTemplates(name, definition)
<static>	CKEDITOR.appendTo(elementOrId, config, data) Creates a new editor instance inside a specific DOM element.
<static>	CKEDITOR.cleanWord(data, editor)
<static>	CKEDITOR.command(editor, commandDefinition)
<static>	CKEDITOR.getTemplates(name)
<static>	CKEDITOR.getUrl(resource) Gets the full URL for CKEditor resources.
<static>	CKEDITOR.htmlDataProcessor(editor)
<static>	CKEDITOR.loadFullCore() Forces the full CKEditor core code, in the case only the basic code has been loaded (ckeditor_basic.js).
<static>	CKEDITOR.loadStylesSet(name, url, callback)
<static>	CKEDITOR.loadTemplates(templateFiles, callback)
<static>	CKEDITOR.remove(editor) Removes and editor instance from the global CKEDITOR object.
<static>	CKEDITOR.replace(elementOrIdOrName, config) Replaces a <textarea> or a DOM element (DIV) with a CKEditor instance.
<static>	CKEDITOR.replaceAll() Replace all <textarea> elements available in the document with editor instances.
<static>	CKEDITOR.style(styleDefinition, variablesValues)
<static>	CKEDITOR.styleCommand(style)
<static>	CKEDITOR.unlinkCommand()

Event Summary
Event Attributes	Event Name and Description
	currentInstance() Fired when the CKEDITOR.currentInstance object reference changes.
	dialogDefinition(data, editor) Fired when a dialog definition is about to be used to create a dialog into an editor instance.
	instanceCreated(editor) Fired when a CKEDITOR instance is created, but still before initializing it.
	instanceDestroyed(editor) Fired when a CKEDITOR instance is destroyed.
	instanceReady(editor) Fired when a CKEDITOR instance is created, fully initialized and ready for interaction.
	key() Fired when any keyboard key (or combination) is pressed into the editing area.
	loaded() Fired when a CKEDITOR core object is fully loaded and ready for interaction.
	pluginsLoaded() Fired when all plugins are loaded and initialized into the editor instance.

Namespace Detail

CKEDITOR

Since: 3.0

This is the API entry point. The entire CKEditor code runs under this object.

Field Detail

<static> {String} CKEDITOR.basePath

Since: 3.0

Contains the full URL for the CKEditor installation directory. It's possible to manually provide the base path by setting a global variable named CKEDITOR_BASEPATH. This global variable must be set "before" the editor script loading.

alert( CKEDITOR.basePath );  // "http://www.example.com/ckeditor/" (e.g.)

<static> {Undefined} CKEDITOR.dataProcessor

Since: 3.0

Represents a data processor, which is responsible to translate and transform the editor data on input and output. This class is not really part of the API. It's here for documentation purposes, and serves as the base ("interface") for data processors implementation.
Defined in: core/dataprocessor.js.

<static> {Undefined} CKEDITOR.document

Since: 3.0

The document of the window holding the CKEDITOR object.
Defined in: core/ckeditor.js.

alert( CKEDITOR.document.getBody().getName() );  // "body"

<static> {Undefined} CKEDITOR.instances

Since: 3.0

Holds references to all editor instances created. The name of the properties in this object correspond to instance names, and their values contains the CKEDITOR.editor object representing them.
Defined in: core/ckeditor.js.

alert( CKEDITOR.instances.editor1.name );  // "editor1"

<static> {Number} CKEDITOR.loadFullCoreTimeout

Since: 3.0

The time to wait (in seconds) to load the full editor code after the page load, if the "ckeditor_basic" file is used. If set to zero, the editor is loaded on demand, as soon as an instance is created. This value must be set on the page before the page load completion.
Defined in: core/ckeditor_basic.js.

// Loads the full source after five seconds.
CKEDITOR.loadFullCoreTimeout = 5;

Default Value:: 0 (zero)

<static> {Boolean} CKEDITOR.replaceByClassEnabled

Since: 3.0

Enables the replacement of all textareas with class name matching CKEDITOR.replaceClass.
Defined in: core/ckeditor_basic.js.

// Disable the auto-replace feature.
CKEDITOR.replaceByClassEnabled = false;

Default Value:: true

<static> {String} CKEDITOR.replaceClass

Since: 3.0

The class name used to identify <textarea> elements to be replace by CKEditor instances.
Defined in: core/ckeditor_basic.js.

CKEDITOR.replaceClass = 'rich_editor';

Default Value:: 'ckeditor'

<static> {String} CKEDITOR.revision

Since: 3.0

Contains the CKEditor revision number. Revision number is incremented automatically after each modification of CKEditor source code.

alert( CKEDITOR.revision );  // e.g. '3975'

<static> {Undefined} CKEDITOR.START

Since: 3.0

Check boundary types.
Defined in: core/dom/range.js.

NO EXAMPLE AVAILABLE

See:: CKEDITOR.dom.range::checkBoundaryOfElement

<static> {String} CKEDITOR.status

Since: 3.0

Indicates the API loading status. The following status are available:

unloaded: the API is not yet loaded.
basic_loaded: the basic API features are available.
basic_ready: the basic API is ready to load the full core code.
loading: the full API is being loaded.
ready: the API can be fully used.

if ( CKEDITOR.status == 'ready' )
{
    // The API can now be fully used.
}

<static> {String} CKEDITOR.timestamp

Since: 3.0

A constant string unique for each release of CKEditor. Its value is used, by default, to build the URL for all resources loaded by the editor code, guaranteing clean cache results when upgrading.

alert( CKEDITOR.timestamp );  // e.g. '87dm'

<static> {String} CKEDITOR.version

Since: 3.0

Contains the CKEditor version number.

alert( CKEDITOR.version );  // e.g. 'CKEditor 3.0 Beta'

Method Detail

<static> {Undefined} CKEDITOR.add(editor)

Since: 3.0

Adds an editor instance to the global CKEDITOR object. This function is available for internal use mainly.
Defined in: core/ckeditor.js.

Parameters:
{CKEDITOR.editor} editor: The editor instance to be added.

<static> {Undefined} CKEDITOR.addTemplates(name, definition)

Since: 3.0

Defined in: plugins/templates/plugin.js.

NO EXAMPLE AVAILABLE

Parameters:
{Undefined} name
{Undefined} definition

<static> {CKEDITOR.editor} CKEDITOR.appendTo(elementOrId, config, data)

Since: 3.0

Creates a new editor instance inside a specific DOM element.
Defined in: core/ckeditor_basic.js.

<div id="editorSpace"><:/div>
...
CKEDITOR.appendTo( 'editorSpace' );

Parameters:
{Object|String} elementOrId: The DOM element or its ID.
{Object} config Optional: The specific configurations to apply to this editor instance. Configurations set here will override global CKEditor settings.
{String} data Optional: Since 3.3. Initial value for the instance.

Returns:: {CKEDITOR.editor} The editor instance created.

<static> {Undefined} CKEDITOR.cleanWord(data, editor)

Since: 3.0

Defined in: plugins/pastefromword/filter/default.js.

NO EXAMPLE AVAILABLE

Parameters:
{Undefined} data
{Undefined} editor

<static> {Undefined} CKEDITOR.command(editor, commandDefinition)

Since: 3.0

Defined in: core/command.js.

NO EXAMPLE AVAILABLE

Parameters:
{Undefined} editor
{Undefined} commandDefinition

<static> {Undefined} CKEDITOR.getTemplates(name)

Since: 3.0

Defined in: plugins/templates/plugin.js.

NO EXAMPLE AVAILABLE

Parameters:
{Undefined} name

<static> {String} CKEDITOR.getUrl(resource)

Since: 3.0

Gets the full URL for CKEditor resources. By default, URLs returned by this function contains a querystring parameter ("t") set to the CKEDITOR.timestamp value. It's possible to provide a custom implementation to this function by setting a global variable named CKEDITOR_GETURL. This global variable must be set "before" the editor script loading. If the custom implementation returns nothing, the default implementation is used.

// e.g. http://www.example.com/ckeditor/skins/default/editor.css?t=87dm
alert( CKEDITOR.getUrl( 'skins/default/editor.css' ) );

// e.g. http://www.example.com/skins/default/editor.css?t=87dm
alert( CKEDITOR.getUrl( '/skins/default/editor.css' ) );

// e.g. http://www.somesite.com/skins/default/editor.css?t=87dm
alert( CKEDITOR.getUrl( 'http://www.somesite.com/skins/default/editor.css' ) );

Parameters:
{Undefined} resource

Returns:: {String} The full URL.

<static> {Undefined} CKEDITOR.htmlDataProcessor(editor)

Since: 3.0

Defined in: plugins/htmldataprocessor/plugin.js.

NO EXAMPLE AVAILABLE

Parameters:
{Undefined} editor

<static> {Undefined} CKEDITOR.loadFullCore()

Since: 3.0

Forces the full CKEditor core code, in the case only the basic code has been loaded (ckeditor_basic.js). This method self-destroys (becomes undefined) in the first call or as soon as the full code is available.
Defined in: core/ckeditor_basic.js.

// Check if the full core code has been loaded and load it.
if ( CKEDITOR.loadFullCore )
    CKEDITOR.loadFullCore();

<static> {Undefined} CKEDITOR.loadStylesSet(name, url, callback)

Since: 3.0

Defined in: plugins/styles/plugin.js.

NO EXAMPLE AVAILABLE

Parameters:
{Undefined} name
{Undefined} url
{Undefined} callback

<static> {Undefined} CKEDITOR.loadTemplates(templateFiles, callback)

Since: 3.0

Defined in: plugins/templates/plugin.js.

NO EXAMPLE AVAILABLE

Parameters:
{Undefined} templateFiles
{Undefined} callback

<static> {Undefined} CKEDITOR.remove(editor)

Since: 3.0

Removes and editor instance from the global CKEDITOR object. his function is available for internal use mainly.
Defined in: core/ckeditor.js.

Parameters:
{CKEDITOR.editor} editor: The editor instance to be added.

<static> {CKEDITOR.editor} CKEDITOR.replace(elementOrIdOrName, config)

Since: 3.0

Replaces a <textarea> or a DOM element (DIV) with a CKEditor instance. For textareas, the initial value in the editor will be the textarea value. For DOM elements, their innerHTML will be used instead. We recommend using TEXTAREA and DIV elements only.
Defined in: core/ckeditor_basic.js.

<textarea id="myfield" name="myfield"><:/textarea>
...
CKEDITOR.replace( 'myfield' );

var textarea = document.body.appendChild( document.createElement( 'textarea' ) );
CKEDITOR.replace( textarea );

Parameters:
{Object|String} elementOrIdOrName: The DOM element (textarea), its ID or name.
{Object} config Optional: The specific configurations to apply to this editor instance. Configurations set here will override global CKEditor settings.

Returns:: {CKEDITOR.editor} The editor instance created.

<static> {Undefined} CKEDITOR.replaceAll()

Since: 3.0

Replace all <textarea> elements available in the document with editor instances.
Defined in: core/ckeditor_basic.js.

// Replace all <textarea> elements in the page.
CKEDITOR.replaceAll();

// Replace all <textarea class="myClassName"> elements in the page.
CKEDITOR.replaceAll( 'myClassName' );

// Selectively replace <textarea> elements, based on custom assertions.
CKEDITOR.replaceAll( function( textarea, config )
    {
        // Custom code to evaluate the replace, returning false
        // if it must not be done.
        // It also passes the "config" parameter, so the
        // developer can customize the instance.
    } );

<static> {Undefined} CKEDITOR.style(styleDefinition, variablesValues)

Since: 3.0

Defined in: plugins/styles/plugin.js.

NO EXAMPLE AVAILABLE

Parameters:
{Undefined} styleDefinition
{Undefined} variablesValues

<static> {Undefined} CKEDITOR.styleCommand(style)

Since: 3.0

Defined in: plugins/styles/plugin.js.

NO EXAMPLE AVAILABLE

Parameters:
{Undefined} style

<static> {Undefined} CKEDITOR.unlinkCommand()

Since: 3.0

Defined in: plugins/link/plugin.js.

NO EXAMPLE AVAILABLE

Event Detail

currentInstance : <object>.on( 'currentInstance', function( e ){ ... } )

Since: 3.0

Fired when the CKEDITOR.currentInstance object reference changes. This may happen when setting the focus on different editor instances in the page.
Defined in: ckeditor.js.

NO EXAMPLE AVAILABLE

Parameters:
{CKEDITOR.eventInfo} e: The standard event object passed to event listeners.

dialogDefinition : <object>.on( 'dialogDefinition', function( e ){ ... } )

Since: 3.0

Fired when a dialog definition is about to be used to create a dialog into an editor instance. This event makes it possible to customize the definition before creating it.

Note that this event is called only the first time a specific dialog is opened. Successive openings will use the cached dialog, and this event will not get fired.

Defined in: plugin.js.

NO EXAMPLE AVAILABLE

Parameters:
{CKEDITOR.eventInfo} e: The standard event object passed to event listeners.
{CKEDITOR.dialog.dialogDefinition} e.data: The dialog defination that is being loaded.
{CKEDITOR.editor} e.editor: The editor instance that will use the dialog.

instanceCreated : <object>.on( 'instanceCreated', function( e ){ ... } )

Since: 3.0

Fired when a CKEDITOR instance is created, but still before initializing it. To interact with a fully initialized instance, use the CKEDITOR#instanceReady event instead.
Defined in: editor.js.

NO EXAMPLE AVAILABLE

Parameters:
{CKEDITOR.eventInfo} e: The standard event object passed to event listeners.
{CKEDITOR.editor} e.editor: The editor instance that has been created.

instanceDestroyed : <object>.on( 'instanceDestroyed', function( e ){ ... } )

Since: 3.0

Fired when a CKEDITOR instance is destroyed.
Defined in: editor.js.

NO EXAMPLE AVAILABLE

Parameters:
{CKEDITOR.eventInfo} e: The standard event object passed to event listeners.
{CKEDITOR.editor} e.editor: The editor instance that has been destroyed.

instanceReady : <object>.on( 'instanceReady', function( e ){ ... } )

Since: 3.0

Fired when a CKEDITOR instance is created, fully initialized and ready for interaction.
Defined in: plugin.js.

NO EXAMPLE AVAILABLE

Parameters:
{CKEDITOR.eventInfo} e: The standard event object passed to event listeners.
{CKEDITOR.editor} e.editor: The editor instance that has been created.

key : <object>.on( 'key', function( e ){ ... } )

Since: 3.0

Fired when any keyboard key (or combination) is pressed into the editing area.
Defined in: plugin.js.

NO EXAMPLE AVAILABLE

Parameters:
{CKEDITOR.eventInfo} e: The standard event object passed to event listeners.
{Number} e.data.keyCode: A number representing the key code (or combination). It is the sum of the current key code and the CKEDITOR.CTRL, CKEDITOR.SHIFT and CKEDITOR.ALT constants, if those are pressed.

loaded : <object>.on( 'loaded', function( e ){ ... } )

Since: 3.0

Fired when a CKEDITOR core object is fully loaded and ready for interaction.
Defined in: _bootstrap.js.

NO EXAMPLE AVAILABLE

Parameters:
{CKEDITOR.eventInfo} e: The standard event object passed to event listeners.

pluginsLoaded : <object>.on( 'pluginsLoaded', function( e ){ ... } )

Since: 3.0

Fired when all plugins are loaded and initialized into the editor instance.
Defined in: editor.js.

NO EXAMPLE AVAILABLE

Parameters:
{CKEDITOR.eventInfo} e: The standard event object passed to event listeners.

CKEditor 3 JavaScript API Documentation

Namespaces

Classes

Namespace CKEDITOR