V3: Editor instances

[Frederico Caldeira Knabben]

In the CKEditor prototype, an editor instance is represented by the CKEDITOR.editor class, which is defined in two files, "core/editor_basic.js" and "core/editor.js".

To create and editor instance, the following information can be passed to the editor class constructor:

• Instance configurations: an object containing configurations specific for this instance.
• The linked element: the element which will be used to create the instance.
• The linked element mode: the way the element is linked to the editor. It indicates if the editor will replace the element, or be appended inside of it.

In any case, the editor class constructor is not to be called directly by end users. They will be using the functions available at CKEDITOR for that, as explained in #2454.

When an instance is create in the page, the following things happen, in this order:

• If the "basic" code has been loaded, the editor is not created immediately. It is placed in a queue, and the full code is loaded. As soon as it is available, all queued editors are initialized (the _init() function definition in editor_basic.js and editor.js).

• The instance configuration is them loaded (initConfig).

• The instance plugins are loaded and initialized (loadPlugins).

• The instance skin and theme are loaded (loadSkinTheme).

• The theme builds the instance interface. At this point, the editor is ready to be used.

All the above points will be explained in detail in other tickets.