mailiverse/web/WebContent/ckeditor/_source/plugins/dialog/dialogDefinition.js

1167 lines
31 KiB
JavaScript
Raw Normal View History

2013-07-21 13:40:17 -04:00
/*
Copyright (c) 2003-2012, CKSource - Frederico Knabben. All rights reserved.
For licensing, see LICENSE.html or http://ckeditor.com/license
*/
/**
* @fileOverview Defines the "virtual" dialog, dialog content and dialog button
* definition classes.
*/
/**
* The definition of a dialog window.
* <div class="notapi">
* This class is not really part of the API. It just illustrates the properties
* that developers can use to define and create dialogs.
* </div>
* @name CKEDITOR.dialog.definition
* @constructor
* @example
* // 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!'
* }
* ]
* }
* ]
* };
* });
*/
/**
* The dialog title, displayed in the dialog's header. Required.
* @name CKEDITOR.dialog.definition.prototype.title
* @field
* @type String
* @example
*/
/**
* How the dialog can be resized, must be one of the four contents defined below.
* <br /><br />
* <strong>CKEDITOR.DIALOG_RESIZE_NONE</strong><br />
* <strong>CKEDITOR.DIALOG_RESIZE_WIDTH</strong><br />
* <strong>CKEDITOR.DIALOG_RESIZE_HEIGHT</strong><br />
* <strong>CKEDITOR.DIALOG_RESIZE_BOTH</strong><br />
* @name CKEDITOR.dialog.definition.prototype.resizable
* @field
* @type Number
* @default CKEDITOR.DIALOG_RESIZE_NONE
* @example
*/
/**
* The minimum width of the dialog, in pixels.
* @name CKEDITOR.dialog.definition.prototype.minWidth
* @field
* @type Number
* @default 600
* @example
*/
/**
* The minimum height of the dialog, in pixels.
* @name CKEDITOR.dialog.definition.prototype.minHeight
* @field
* @type Number
* @default 400
* @example
*/
/**
* The initial width of the dialog, in pixels.
* @name CKEDITOR.dialog.definition.prototype.width
* @field
* @type Number
* @default @CKEDITOR.dialog.definition.prototype.minWidth
* @since 3.5.3
* @example
*/
/**
* The initial height of the dialog, in pixels.
* @name CKEDITOR.dialog.definition.prototype.height
* @field
* @type Number
* @default @CKEDITOR.dialog.definition.prototype.minHeight
* @since 3.5.3
* @example
*/
/**
* The buttons in the dialog, defined as an array of
* {@link CKEDITOR.dialog.definition.button} objects.
* @name CKEDITOR.dialog.definition.prototype.buttons
* @field
* @type Array
* @default [ CKEDITOR.dialog.okButton, CKEDITOR.dialog.cancelButton ]
* @example
*/
/**
* The contents in the dialog, defined as an array of
* {@link CKEDITOR.dialog.definition.content} objects. Required.
* @name CKEDITOR.dialog.definition.prototype.contents
* @field
* @type Array
* @example
*/
/**
* The function to execute when OK is pressed.
* @name CKEDITOR.dialog.definition.prototype.onOk
* @field
* @type Function
* @example
*/
/**
* The function to execute when Cancel is pressed.
* @name CKEDITOR.dialog.definition.prototype.onCancel
* @field
* @type Function
* @example
*/
/**
* The function to execute when the dialog is displayed for the first time.
* @name CKEDITOR.dialog.definition.prototype.onLoad
* @field
* @type Function
* @example
*/
/**
* The function to execute when the dialog is loaded (executed every time the dialog is opened).
* @name CKEDITOR.dialog.definition.prototype.onShow
* @field
* @type Function
* @example
*/
/**
* <div class="notapi">This class is not really part of the API. It just illustrates the properties
* that developers can use to define and create dialog content pages.</div>
* @name CKEDITOR.dialog.definition.content
* @constructor
* @example
* // There is no constructor for this class, the user just has to define an
* // object with the appropriate properties.
*/
/**
* The id of the content page.
* @name CKEDITOR.dialog.definition.content.prototype.id
* @field
* @type String
* @example
*/
/**
* The tab label of the content page.
* @name CKEDITOR.dialog.definition.content.prototype.label
* @field
* @type String
* @example
*/
/**
* The popup message of the tab label.
* @name CKEDITOR.dialog.definition.content.prototype.title
* @field
* @type String
* @example
*/
/**
* The CTRL hotkey for switching to the tab.
* @name CKEDITOR.dialog.definition.content.prototype.accessKey
* @field
* @type String
* @example
* contentDefinition.accessKey = 'Q'; // Switch to this page when CTRL-Q is pressed.
*/
/**
* The UI elements contained in this content page, defined as an array of
* {@link CKEDITOR.dialog.definition.uiElement} objects.
* @name CKEDITOR.dialog.definition.content.prototype.elements
* @field
* @type Array
* @example
*/
/**
* The definition of user interface element (textarea, radio etc).
* <div class="notapi">This class is not really part of the API. It just illustrates the properties
* that developers can use to define and create dialog UI elements.</div>
* @name CKEDITOR.dialog.definition.uiElement
* @constructor
* @see CKEDITOR.ui.dialog.uiElement
* @example
* // There is no constructor for this class, the user just has to define an
* // object with the appropriate properties.
*/
/**
* The id of the UI element.
* @name CKEDITOR.dialog.definition.uiElement.prototype.id
* @field
* @type String
* @example
*/
/**
* The type of the UI element. Required.
* @name CKEDITOR.dialog.definition.uiElement.prototype.type
* @field
* @type String
* @example
*/
/**
* The popup label of the UI element.
* @name CKEDITOR.dialog.definition.uiElement.prototype.title
* @field
* @type String
* @example
*/
/**
* CSS class names to append to the UI element.
* @name CKEDITOR.dialog.definition.uiElement.prototype.className
* @field
* @type String
* @example
*/
/**
* Inline CSS classes to append to the UI element.
* @name CKEDITOR.dialog.definition.uiElement.prototype.style
* @field
* @type String
* @example
*/
/**
* Horizontal alignment (in container) of the UI element.
* @name CKEDITOR.dialog.definition.uiElement.prototype.align
* @field
* @type String
* @example
*/
/**
* Function to execute the first time the UI element is displayed.
* @name CKEDITOR.dialog.definition.uiElement.prototype.onLoad
* @field
* @type Function
* @example
*/
/**
* Function to execute whenever the UI element's parent dialog is displayed.
* @name CKEDITOR.dialog.definition.uiElement.prototype.onShow
* @field
* @type Function
* @example
*/
/**
* Function to execute whenever the UI element's parent dialog is closed.
* @name CKEDITOR.dialog.definition.uiElement.prototype.onHide
* @field
* @type Function
* @example
*/
/**
* Function to execute whenever the UI element's parent dialog's {@link CKEDITOR.dialog.definition.setupContent} method is executed.
* It usually takes care of the respective UI element as a standalone element.
* @name CKEDITOR.dialog.definition.uiElement.prototype.setup
* @field
* @type Function
* @example
*/
/**
* Function to execute whenever the UI element's parent dialog's {@link CKEDITOR.dialog.definition.commitContent} method is executed.
* It usually takes care of the respective UI element as a standalone element.
* @name CKEDITOR.dialog.definition.uiElement.prototype.commit
* @field
* @type Function
* @example
*/
// ----- hbox -----
/**
* Horizontal layout box for dialog UI elements, auto-expends to available width of container.
* <div class="notapi">
* This class is not really part of the API. It just illustrates the properties
* that developers can use to define and create horizontal layouts.
* <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.hbox} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
* </div>
* @name CKEDITOR.dialog.definition.hbox
* @extends CKEDITOR.dialog.definition.uiElement
* @constructor
* @example
* // There is no constructor for this class, the user just has to define an
* // object with the appropriate properties.
*
* // Example:
* {
* <b>type : 'hbox',</b>
* widths : [ '25%', '25%', '50%' ],
* children :
* [
* {
* type : 'text',
* id : 'id1',
* width : '40px',
* },
* {
* type : 'text',
* id : 'id2',
* width : '40px',
* },
* {
* type : 'text',
* id : 'id3'
* }
* ]
* }
*/
/**
* Array of {@link CKEDITOR.ui.dialog.uiElement} objects inside this container.
* @name CKEDITOR.dialog.definition.hbox.prototype.children
* @field
* @type Array
* @example
*/
/**
* (Optional) The widths of child cells.
* @name CKEDITOR.dialog.definition.hbox.prototype.widths
* @field
* @type Array
* @example
*/
/**
* (Optional) The height of the layout.
* @name CKEDITOR.dialog.definition.hbox.prototype.height
* @field
* @type Number
* @example
*/
/**
* The CSS styles to apply to this element.
* @name CKEDITOR.dialog.definition.hbox.prototype.styles
* @field
* @type String
* @example
*/
/**
* (Optional) The padding width inside child cells. Example: 0, 1.
* @name CKEDITOR.dialog.definition.hbox.prototype.padding
* @field
* @type Number
* @example
*/
/**
* (Optional) The alignment of the whole layout. Example: center, top.
* @name CKEDITOR.dialog.definition.hbox.prototype.align
* @field
* @type String
* @example
*/
// ----- vbox -----
/**
* Vertical layout box for dialog UI elements.
* <div class="notapi">
* This class is not really part of the API. It just illustrates the properties
* that developers can use to define and create vertical layouts.
* <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.vbox} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
* </div>
* <style type="text/css">.details .detailList {display:none;} </style>
* @name CKEDITOR.dialog.definition.vbox
* @extends CKEDITOR.dialog.definition.uiElement
* @constructor
* @example
* // There is no constructor for this class, the user just has to define an
* // object with the appropriate properties.
*
* // Example:
* {
* <b>type : 'vbox',</b>
* align : 'right',
* width : '200px',
* children :
* [
* {
* type : 'text',
* id : 'age',
* label : 'Age'
* },
* {
* type : 'text',
* id : 'sex',
* label : 'Sex'
* },
* {
* type : 'text',
* id : 'nationality',
* label : 'Nationality'
* }
* ]
* }
*/
/**
* Array of {@link CKEDITOR.ui.dialog.uiElement} objects inside this container.
* @name CKEDITOR.dialog.definition.vbox.prototype.children
* @field
* @type Array
* @example
*/
/**
* (Optional) The width of the layout.
* @name CKEDITOR.dialog.definition.vbox.prototype.width
* @field
* @type Array
* @example
*/
/**
* (Optional) The heights of individual cells.
* @name CKEDITOR.dialog.definition.vbox.prototype.heights
* @field
* @type Number
* @example
*/
/**
* The CSS styles to apply to this element.
* @name CKEDITOR.dialog.definition.vbox.prototype.styles
* @field
* @type String
* @example
*/
/**
* (Optional) The padding width inside child cells. Example: 0, 1.
* @name CKEDITOR.dialog.definition.vbox.prototype.padding
* @field
* @type Number
* @example
*/
/**
* (Optional) The alignment of the whole layout. Example: center, top.
* @name CKEDITOR.dialog.definition.vbox.prototype.align
* @field
* @type String
* @example
*/
/**
* (Optional) Whether the layout should expand vertically to fill its container.
* @name CKEDITOR.dialog.definition.vbox.prototype.expand
* @field
* @type Boolean
* @example
*/
// ----- labeled element ------
/**
* The definition of labeled user interface element (textarea, textInput etc).
* <div class="notapi">This class is not really part of the API. It just illustrates the properties
* that developers can use to define and create dialog UI elements.</div>
* @name CKEDITOR.dialog.definition.labeledElement
* @extends CKEDITOR.dialog.definition.uiElement
* @constructor
* @see CKEDITOR.ui.dialog.labeledElement
* @example
* // There is no constructor for this class, the user just has to define an
* // object with the appropriate properties.
*/
/**
* The label of the UI element.
* @name CKEDITOR.dialog.definition.labeledElement.prototype.label
* @type String
* @field
* @example
* {
* type : 'text',
* label : 'My Label '
* }
*/
/**
* (Optional) Specify the layout of the label. Set to 'horizontal' for horizontal layout.
* The default layout is vertical.
* @name CKEDITOR.dialog.definition.labeledElement.prototype.labelLayout
* @type String
* @field
* @example
* {
* type : 'text',
* label : 'My Label ',
* <strong> labelLayout : 'horizontal',</strong>
* }
*/
/**
* (Optional) Applies only to horizontal layouts: a two elements array of lengths to specify the widths of the
* label and the content element. See also {@link CKEDITOR.dialog.definition.labeledElement#labelLayout}.
* @name CKEDITOR.dialog.definition.labeledElement.prototype.widths
* @type Array
* @field
* @example
* {
* type : 'text',
* label : 'My Label ',
* labelLayout : 'horizontal',
* <strong> widths : [100, 200],</strong>
* }
*/
/**
* Specify the inline style of the uiElement label.
* @name CKEDITOR.dialog.definition.labeledElement.prototype.labelStyle
* @type String
* @field
* @example
* {
* type : 'text',
* label : 'My Label ',
* <strong> labelStyle : 'color: red',</strong>
* }
*/
/**
* Specify the inline style of the input element.
* @name CKEDITOR.dialog.definition.labeledElement.prototype.inputStyle
* @type String
* @since 3.6.1
* @field
* @example
* {
* type : 'text',
* label : 'My Label ',
* <strong> inputStyle : 'text-align:center',</strong>
* }
*/
/**
* Specify the inline style of the input element container .
* @name CKEDITOR.dialog.definition.labeledElement.prototype.controlStyle
* @type String
* @since 3.6.1
* @field
* @example
* {
* type : 'text',
* label : 'My Label ',
* <strong> controlStyle : 'width:3em',</strong>
* }
*/
// ----- button ------
/**
* The definition of a button.
* <div class="notapi">
* This class is not really part of the API. It just illustrates the properties
* that developers can use to define and create buttons.
* <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.button} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
* </div>
* For a complete example of dialog definition, please check {@link CKEDITOR.dialog.add}.
* @name CKEDITOR.dialog.definition.button
* @extends CKEDITOR.dialog.definition.uiElement
* @constructor
* @example
* // There is no constructor for this class, the user just has to define an
* // object with the appropriate properties.
*
* // Example:
* {
* <b>type : 'button',</b>
* id : 'buttonId',
* label : 'Click me',
* title : 'My title',
* onClick : function() {
* // this = CKEDITOR.ui.dialog.button
* alert( 'Clicked: ' + this.id );
* }
* }
*/
/**
* Whether the button is disabled.
* @name CKEDITOR.dialog.definition.button.prototype.disabled
* @type Boolean
* @field
* @example
*/
/**
* The label of the UI element.
* @name CKEDITOR.dialog.definition.button.prototype.label
* @type String
* @field
* @example
*/
// ----- checkbox ------
/**
* The definition of a checkbox element.
* <div class="notapi">
* This class is not really part of the API. It just illustrates the properties
* that developers can use to define and create groups of checkbox buttons.
* <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.checkbox} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
* </div>
* For a complete example of dialog definition, please check {@link CKEDITOR.dialog.add}.
* @name CKEDITOR.dialog.definition.checkbox
* @extends CKEDITOR.dialog.definition.uiElement
* @constructor
* @example
* // There is no constructor for this class, the user just has to define an
* // object with the appropriate properties.
*
* // Example:
* {
* <b>type : 'checkbox',</b>
* id : 'agree',
* label : 'I agree',
* 'default' : 'checked',
* onClick : function() {
* // this = CKEDITOR.ui.dialog.checkbox
* alert( 'Checked: ' + this.getValue() );
* }
* }
*/
/**
* (Optional) The validation function.
* @name CKEDITOR.dialog.definition.checkbox.prototype.validate
* @field
* @type Function
* @example
*/
/**
* The label of the UI element.
* @name CKEDITOR.dialog.definition.checkbox.prototype.label
* @type String
* @field
* @example
*/
/**
* The default state.
* @name CKEDITOR.dialog.definition.checkbox.prototype.default
* @type String
* @field
* @default
* '' (unchecked)
* @example
*/
// ----- file -----
/**
* The definition of a file upload input.
* <div class="notapi">
* This class is not really part of the API. It just illustrates the properties
* that developers can use to define and create file upload elements.
* <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.file} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
* </div>
* For a complete example of dialog definition, please check {@link CKEDITOR.dialog.add}.
* @name CKEDITOR.dialog.definition.file
* @extends CKEDITOR.dialog.definition.labeledElement
* @constructor
* @example
* // There is no constructor for this class, the user just has to define an
* // object with the appropriate properties.
*
* // Example:
* {
* <b>type : 'file'</b>,
* id : 'upload',
* label : 'Select file from your computer',
* size : 38
* },
* {
* type : 'fileButton',
* id : 'fileId',
* label : 'Upload file',
* 'for' : [ 'tab1', 'upload' ]
* filebrowser : {
* onSelect : function( fileUrl, data ) {
* alert( 'Successfully uploaded: ' + fileUrl );
* }
* }
* }
*/
/**
* (Optional) The validation function.
* @name CKEDITOR.dialog.definition.file.prototype.validate
* @field
* @type Function
* @example
*/
/**
* (Optional) The action attribute of the form element associated with this file upload input.
* If empty, CKEditor will use path to server connector for currently opened folder.
* @name CKEDITOR.dialog.definition.file.prototype.action
* @type String
* @field
* @example
*/
/**
* The size of the UI element.
* @name CKEDITOR.dialog.definition.file.prototype.size
* @type Number
* @field
* @example
*/
// ----- fileButton -----
/**
* The definition of a button for submitting the file in a file upload input.
* <div class="notapi">
* This class is not really part of the API. It just illustrates the properties
* that developers can use to define and create a button for submitting the file in a file upload input.
* <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.fileButton} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
* </div>
* For a complete example of dialog definition, please check {@link CKEDITOR.dialog.add}.
* @name CKEDITOR.dialog.definition.fileButton
* @extends CKEDITOR.dialog.definition.uiElement
* @constructor
* @example
* // There is no constructor for this class, the user just has to define an
* // object with the appropriate properties.
*
* // Example:
* {
* type : 'file',
* id : 'upload',
* label : 'Select file from your computer',
* size : 38
* },
* {
* <b>type : 'fileButton'</b>,
* id : 'fileId',
* label : 'Upload file',
* 'for' : [ 'tab1', 'upload' ]
* filebrowser : {
* onSelect : function( fileUrl, data ) {
* alert( 'Successfully uploaded: ' + fileUrl );
* }
* }
* }
*/
/**
* (Optional) The validation function.
* @name CKEDITOR.dialog.definition.fileButton.prototype.validate
* @field
* @type Function
* @example
*/
/**
* The label of the UI element.
* @name CKEDITOR.dialog.definition.fileButton.prototype.label
* @type String
* @field
* @example
*/
/**
* The instruction for CKEditor how to deal with file upload.
* By default, the file and fileButton elements will not work "as expected" if this attribute is not set.
* @name CKEDITOR.dialog.definition.fileButton.prototype.filebrowser
* @type String|Object
* @field
* @example
* // Update field with id 'txtUrl' in the 'tab1' tab when file is uploaded.
* filebrowser : 'tab1:txtUrl'
*
* // Call custom onSelect function when file is successfully uploaded.
* filebrowser : {
* onSelect : function( fileUrl, data ) {
* alert( 'Successfully uploaded: ' + fileUrl );
* }
* }
*/
/**
* An array that contains pageId and elementId of the file upload input element for which this button is created.
* @name CKEDITOR.dialog.definition.fileButton.prototype.for
* @type String
* @field
* @example
* [ pageId, elementId ]
*/
// ----- html -----
/**
* The definition of a raw HTML element.
* <div class="notapi">
* This class is not really part of the API. It just illustrates the properties
* that developers can use to define and create elements made from raw HTML code.
* <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.html} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
* </div>
* For a complete example of dialog definition, please check {@link CKEDITOR.dialog.add}.<br />
* To access HTML elements use {@link CKEDITOR.dom.document#getById}
* @name CKEDITOR.dialog.definition.html
* @extends CKEDITOR.dialog.definition.uiElement
* @constructor
* @example
* // There is no constructor for this class, the user just has to define an
* // object with the appropriate properties.
*
* // Example 1:
* {
* <b>type : 'html',</b>
* html : '&lt;h3>This is some sample HTML content.&lt;/h3>'
* }
* @example
* // Example 2:
* // Complete sample with document.getById() call when the "Ok" button is clicked.
* var dialogDefinition =
* {
* title : 'Sample dialog',
* minWidth : 300,
* minHeight : 200,
* onOk : function() {
* // "this" is now a CKEDITOR.dialog object.
* var document = this.getElement().getDocument();
* // document = CKEDITOR.dom.document
* var element = <b>document.getById( 'myDiv' );</b>
* if ( element )
* alert( element.getHtml() );
* },
* contents : [
* {
* id : 'tab1',
* label : '',
* title : '',
* elements :
* [
* {
* <b>type : 'html',</b>
* html : '<b>&lt;div id="myDiv">Sample &lt;b>text&lt;/b>.&lt;/div></b>&lt;div id="otherId">Another div.&lt;/div>'
* },
* ]
* }
* ],
* buttons : [ CKEDITOR.dialog.cancelButton, CKEDITOR.dialog.okButton ]
* };
*/
/**
* (Required) HTML code of this element.
* @name CKEDITOR.dialog.definition.html.prototype.html
* @type String
* @field
* @example
*/
// ----- radio ------
/**
* The definition of a radio group.
* <div class="notapi">
* This class is not really part of the API. It just illustrates the properties
* that developers can use to define and create groups of radio buttons.
* <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.radio} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
* </div>
* For a complete example of dialog definition, please check {@link CKEDITOR.dialog.add}.
* @name CKEDITOR.dialog.definition.radio
* @extends CKEDITOR.dialog.definition.labeledElement
* @constructor
* @example
* // There is no constructor for this class, the user just has to define an
* // object with the appropriate properties.
*
* // Example:
* {
* <b>type : 'radio',</b>
* id : 'country',
* label : 'Which country is bigger',
* items : [ [ 'France', 'FR' ], [ 'Germany', 'DE' ] ] ,
* style : 'color:green',
* 'default' : 'DE',
* onClick : function() {
* // this = CKEDITOR.ui.dialog.radio
* alert( 'Current value: ' + this.getValue() );
* }
* }
*/
/**
* The default value.
* @name CKEDITOR.dialog.definition.radio.prototype.default
* @type String
* @field
* @example
*/
/**
* (Optional) The validation function.
* @name CKEDITOR.dialog.definition.radio.prototype.validate
* @field
* @type Function
* @example
*/
/**
* An array of options. Each option is a 1- or 2-item array of format [ 'Description', 'Value' ]. If 'Value' is missing, then the value would be assumed to be the same as the description.
* @name CKEDITOR.dialog.definition.radio.prototype.items
* @field
* @type Array
* @example
*/
// ----- selectElement ------
/**
* The definition of a select element.
* <div class="notapi">
* This class is not really part of the API. It just illustrates the properties
* that developers can use to define and create select elements.
* <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.select} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
* </div>
* For a complete example of dialog definition, please check {@link CKEDITOR.dialog.add}.
* @name CKEDITOR.dialog.definition.select
* @extends CKEDITOR.dialog.definition.labeledElement
* @constructor
* @example
* // There is no constructor for this class, the user just has to define an
* // object with the appropriate properties.
*
* // Example:
* {
* <b>type : 'select',</b>
* id : 'sport',
* label : 'Select your favourite sport',
* items : [ [ 'Basketball' ], [ 'Baseball' ], [ 'Hockey' ], [ 'Football' ] ],
* 'default' : 'Football',
* onChange : function( api ) {
* // this = CKEDITOR.ui.dialog.select
* alert( 'Current value: ' + this.getValue() );
* }
* }
*/
/**
* The default value.
* @name CKEDITOR.dialog.definition.select.prototype.default
* @type String
* @field
* @example
*/
/**
* (Optional) The validation function.
* @name CKEDITOR.dialog.definition.select.prototype.validate
* @field
* @type Function
* @example
*/
/**
* An array of options. Each option is a 1- or 2-item array of format [ 'Description', 'Value' ]. If 'Value' is missing, then the value would be assumed to be the same as the description.
* @name CKEDITOR.dialog.definition.select.prototype.items
* @field
* @type Array
* @example
*/
/**
* (Optional) Set this to true if you'd like to have a multiple-choice select box.
* @name CKEDITOR.dialog.definition.select.prototype.multiple
* @type Boolean
* @field
* @example
* @default false
*/
/**
* (Optional) The number of items to display in the select box.
* @name CKEDITOR.dialog.definition.select.prototype.size
* @type Number
* @field
* @example
*/
// ----- textInput -----
/**
* The definition of a text field (single line).
* <div class="notapi">
* This class is not really part of the API. It just illustrates the properties
* that developers can use to define and create text fields.
* <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.textInput} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
* </div>
* For a complete example of dialog definition, please check {@link CKEDITOR.dialog.add}.
* @name CKEDITOR.dialog.definition.textInput
* @extends CKEDITOR.dialog.definition.labeledElement
* @constructor
* @example
* // There is no constructor for this class, the user just has to define an
* // object with the appropriate properties.
*
* {
* <b>type : 'text',</b>
* id : 'name',
* label : 'Your name',
* 'default' : '',
* validate : function() {
* if ( !this.getValue() )
* {
* api.openMsgDialog( '', 'Name cannot be empty.' );
* return false;
* }
* }
* }
*/
/**
* The default value.
* @name CKEDITOR.dialog.definition.textInput.prototype.default
* @type String
* @field
* @example
*/
/**
* (Optional) The maximum length.
* @name CKEDITOR.dialog.definition.textInput.prototype.maxLength
* @type Number
* @field
* @example
*/
/**
* (Optional) The size of the input field.
* @name CKEDITOR.dialog.definition.textInput.prototype.size
* @type Number
* @field
* @example
*/
/**
* (Optional) The validation function.
* @name CKEDITOR.dialog.definition.textInput.prototype.validate
* @field
* @type Function
* @example
*/
// ----- textarea ------
/**
* The definition of a text field (multiple lines).
* <div class="notapi">
* This class is not really part of the API. It just illustrates the properties
* that developers can use to define and create textarea.
* <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.textarea} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
* </div>
* For a complete example of dialog definition, please check {@link CKEDITOR.dialog.add}.
* @name CKEDITOR.dialog.definition.textarea
* @extends CKEDITOR.dialog.definition.labeledElement
* @constructor
* @example
* // There is no constructor for this class, the user just has to define an
* // object with the appropriate properties.
*
* // Example:
* {
* <b>type : 'textarea',</b>
* id : 'message',
* label : 'Your comment',
* 'default' : '',
* validate : function() {
* if ( this.getValue().length < 5 )
* {
* api.openMsgDialog( 'The comment is too short.' );
* return false;
* }
* }
* }
*/
/**
* The number of rows.
* @name CKEDITOR.dialog.definition.textarea.prototype.rows
* @type Number
* @field
* @example
*/
/**
* The number of columns.
* @name CKEDITOR.dialog.definition.textarea.prototype.cols
* @type Number
* @field
* @example
*/
/**
* (Optional) The validation function.
* @name CKEDITOR.dialog.definition.textarea.prototype.validate
* @field
* @type Function
* @example
*/
/**
* The default value.
* @name CKEDITOR.dialog.definition.textarea.prototype.default
* @type String
* @field
* @example
*/