Anna: Article contents added

2011-07-06T13:29:38Z

Article contents added

New page

{{#CUSTOMTITLE:How Do I Set a Specific Dialog Window Tab to Open by Default?}}
If you want to change your CKEditor configuration to show a different tab on opening a dialog window, you can hook into the <code>[http://docs.cksource.com/ckeditor_api/symbols/CKEDITOR.dialog.definition.html#onShow onShow]</code> event of the dialog window.

Firstly, you will need to know the names of the dialog window and the tab that you want to set as default, so [[CKEditor_3.x/Howto/Field_Names|use the Developer Tools plugin]] to get these.

Once you have the names you can add the following code either in the <code><script></code> element inserted into the page that contains your CKEditor instance or into the <code>config.js</code> file. The example below sets the '''Image Properties''' dialog window to open the '''Advanced''' tab by default.

<source lang="javascript">
CKEDITOR.on('dialogDefinition', function(ev) {
// Take the dialog window name and its definition from the event data.
var dialogName = ev.data.name;
var dialogDefinition = ev.data.definition;

if (dialogName == 'image') {
dialogDefinition.onShow = function () {
// This code will open the Advanced tab.
this.selectPage('advanced');
};
}
});
</source>

If, for example, you want to open the '''Upload''' tab first to make it more convenient for your users to use the ([[CKEditor_3.x/Howto/File_Uploader|existing and previously integrated]]) file uploader, change the code in the following way:

<source lang="javascript">
// This code will open the Upload tab.
this.selectPage('Upload');
</source>

CKEditor 3.x/Howto/Default Dialog Tab - Revision history

Anna: Article contents added