103 lines
3.1 KiB
JavaScript
103 lines
3.1 KiB
JavaScript
/*
|
|
Copyright (c) 2003-2010, CKSource - Frederico Knabben. All rights reserved.
|
|
For licensing, see LICENSE.html or http://ckeditor.com/license
|
|
*/
|
|
|
|
/**
|
|
* @fileOverview Defines the "virtual" {@link CKEDITOR.commandDefinition} class,
|
|
* which contains the defintion of a command. This file is for
|
|
* documentation purposes only.
|
|
*/
|
|
|
|
/**
|
|
* (Virtual Class) Do not call this constructor. This class is not really part
|
|
* of the API. It just illustrates the features of command objects to be
|
|
* passed to the {@link CKEDITOR.editor.prototype.addCommand} function.
|
|
* @name CKEDITOR.commandDefinition
|
|
* @constructor
|
|
* @example
|
|
*/
|
|
|
|
/**
|
|
* Executes the command.
|
|
* @name CKEDITOR.commandDefinition.prototype.exec
|
|
* @function
|
|
* @param {CKEDITOR.editor} editor The editor within which run the command.
|
|
* @param {Object} [data] Additional data to be used to execute the command.
|
|
* @returns {Boolean} Whether the command has been successfully executed.
|
|
* Defaults to "true", if nothing is returned.
|
|
* @example
|
|
* editorInstance.addCommand( 'sample',
|
|
* {
|
|
* exec : function( editor )
|
|
* {
|
|
* alert( 'Executing a command for the editor name "' + editor.name + '"!' );
|
|
* }
|
|
* });
|
|
*/
|
|
|
|
/**
|
|
* Whether the command need to be hooked into the redo/undo system.
|
|
* @name CKEDITOR.commandDefinition.canUndo
|
|
* @type {Boolean} If not defined or 'true' both hook into undo system, set it
|
|
* to 'false' explicitly keep it out.
|
|
* @field
|
|
* @example
|
|
* editorInstance.addCommand( 'alertName',
|
|
* {
|
|
* exec : function( editor )
|
|
* {
|
|
* alert( editor.name );
|
|
* },
|
|
* canUndo : false // No support for undo/redo
|
|
* });
|
|
*/
|
|
|
|
/**
|
|
* Whether the command is asynchronous, which means the 'afterCommandExec' event
|
|
* will be fired by the command itself manually, and the 'exec' function return value
|
|
* of this command is not to be returned.
|
|
* @name CKEDITOR.commandDefinition.async
|
|
* @type {Boolean} If defined as 'true', the command is asynchronous.
|
|
* @example
|
|
* editorInstance.addCommand( 'alertName',
|
|
* {
|
|
* exec : function( editor )
|
|
* {
|
|
* // Asynchronous operation below.
|
|
* CKEDITOR.ajax.loadXml( 'data.xml' );
|
|
* },
|
|
* async : true // The command need some time to complete after exec function returns.
|
|
* });
|
|
*/
|
|
|
|
/**
|
|
* Whether the command should give focus to the editor before execution.
|
|
* @name CKEDITOR.commandDefinition.editorFocus
|
|
* @type {Boolean}
|
|
* @example
|
|
* editorInstance.addCommand( 'maximize',
|
|
* {
|
|
* exec : function( editor )
|
|
* {
|
|
* },
|
|
* editorFocus : false // The command doesn't require focusing the editing document.
|
|
* });
|
|
*/
|
|
|
|
|
|
/**
|
|
* Whether the command state should be set to {@link CKEDITOR.TRISTATE_DISABLED} on startup.
|
|
* @name CKEDITOR.commandDefinition.startDisabled
|
|
* @type {Boolean}
|
|
* @default false
|
|
* @example
|
|
* editorInstance.addCommand( 'unlink',
|
|
* {
|
|
* exec : function( editor )
|
|
* {
|
|
* },
|
|
* startDisabled : true // Command is unavailable until selection is inside a link.
|
|
* });
|
|
*/
|