[ckeditor.git] / _source / plugins / dialog / plugin.js

/*
Copyright (c) 2003-2011, CKSource - Frederico Knabben. All rights reserved.
For licensing, see LICENSE.html or http://ckeditor.com/license
*/

/**
 * @fileOverview The floating dialog plugin.
 */

/**
 * No resize for this dialog.
 * @constant
 */
CKEDITOR.DIALOG_RESIZE_NONE = 0;

/**
 * Only allow horizontal resizing for this dialog, disable vertical resizing.
 * @constant
 */
CKEDITOR.DIALOG_RESIZE_WIDTH = 1;

/**
 * Only allow vertical resizing for this dialog, disable horizontal resizing.
 * @constant
 */
CKEDITOR.DIALOG_RESIZE_HEIGHT = 2;

/*
 * Allow the dialog to be resized in both directions.
 * @constant
 */
CKEDITOR.DIALOG_RESIZE_BOTH = 3;

(function()
{
        var cssLength = CKEDITOR.tools.cssLength;
        function isTabVisible( tabId )
        {
                return !!this._.tabs[ tabId ][ 0 ].$.offsetHeight;
        }

        function getPreviousVisibleTab()
        {
                var tabId = this._.currentTabId,
                        length = this._.tabIdList.length,
                        tabIndex = CKEDITOR.tools.indexOf( this._.tabIdList, tabId ) + length;

                for ( var i = tabIndex - 1 ; i > tabIndex - length ; i-- )
                {
                        if ( isTabVisible.call( this, this._.tabIdList[ i % length ] ) )
                                return this._.tabIdList[ i % length ];
                }

                return null;
        }

        function getNextVisibleTab()
        {
                var tabId = this._.currentTabId,
                        length = this._.tabIdList.length,
                        tabIndex = CKEDITOR.tools.indexOf( this._.tabIdList, tabId );

                for ( var i = tabIndex + 1 ; i < tabIndex + length ; i++ )
                {
                        if ( isTabVisible.call( this, this._.tabIdList[ i % length ] ) )
                                return this._.tabIdList[ i % length ];
                }

                return null;
        }


        function clearOrRecoverTextInputValue( container, isRecover )
        {
                var inputs = container.$.getElementsByTagName( 'input' );
                for ( var i = 0, length = inputs.length; i < length ; i++ )
                {
                        var item = new CKEDITOR.dom.element( inputs[ i ] );

                        if ( item.getAttribute( 'type' ).toLowerCase() == 'text' )
                        {
                                if ( isRecover )
                                {
                                        item.setAttribute( 'value', item.getCustomData( 'fake_value' ) || '' );
                                        item.removeCustomData( 'fake_value' );
                                }
                                else
                                {
                                        item.setCustomData( 'fake_value', item.getAttribute( 'value' ) );
                                        item.setAttribute( 'value', '' );
                                }
                        }
                }
        }

        // Handle dialog element validation state UI changes.
        function handleFieldValidated( isValid, msg )
        {
                var input = this.getInputElement();
                if ( input )
                {
                        isValid ? input.removeAttribute( 'aria-invalid' )
                                : input.setAttribute( 'aria-invalid', true );
                }

                if ( !isValid )
                {
                        if ( this.select )
                                this.select();
                        else
                                this.focus();
                }

                msg && alert( msg );

                this.fire( 'validated', { valid : isValid, msg : msg } );
        }

        function resetField()
        {
                var input = this.getInputElement();
                input && input.removeAttribute( 'aria-invalid' );
        }


        /**
         * This is the base class for runtime dialog objects. An instance of this
         * class represents a single named dialog for a single editor instance.
         * @param {Object} editor The editor which created the dialog.
         * @param {String} dialogName The dialog's registered name.
         * @constructor
         * @example
         * var dialogObj = new CKEDITOR.dialog( editor, 'smiley' );
         */
        CKEDITOR.dialog = function( editor, dialogName )
        {
                // Load the dialog definition.
                var definition = CKEDITOR.dialog._.dialogDefinitions[ dialogName ],
                        defaultDefinition = CKEDITOR.tools.clone( defaultDialogDefinition ),
                        buttonsOrder = editor.config.dialog_buttonsOrder || 'OS',
                        dir = editor.lang.dir;

                        if ( ( buttonsOrder == 'OS' && CKEDITOR.env.mac ) ||    // The buttons in MacOS Apps are in reverse order (#4750)
                                ( buttonsOrder == 'rtl' && dir == 'ltr' ) ||
                                ( buttonsOrder == 'ltr' && dir == 'rtl' ) )
                                        defaultDefinition.buttons.reverse();


                // Completes the definition with the default values.
                definition = CKEDITOR.tools.extend( definition( editor ), defaultDefinition );

                // Clone a functionally independent copy for this dialog.
                definition = CKEDITOR.tools.clone( definition );

                // Create a complex definition object, extending it with the API
                // functions.
                definition = new definitionObject( this, definition );

                var doc = CKEDITOR.document;

                var themeBuilt = editor.theme.buildDialog( editor );

                // Initialize some basic parameters.
                this._ =
                {
                        editor : editor,
                        element : themeBuilt.element,
                        name : dialogName,
                        contentSize : { width : 0, height : 0 },
                        size : { width : 0, height : 0 },
                        contents : {},
                        buttons : {},
                        accessKeyMap : {},

                        // Initialize the tab and page map.
                        tabs : {},
                        tabIdList : [],
                        currentTabId : null,
                        currentTabIndex : null,
                        pageCount : 0,
                        lastTab : null,
                        tabBarMode : false,

                        // Initialize the tab order array for input widgets.
                        focusList : [],
                        currentFocusIndex : 0,
                        hasFocus : false
                };

                this.parts = themeBuilt.parts;

                CKEDITOR.tools.setTimeout( function()
                        {
                                editor.fire( 'ariaWidget', this.parts.contents );
                        },
                        0, this );

                // Set the startup styles for the dialog, avoiding it enlarging the
                // page size on the dialog creation.
                var startStyles = {
                                position : CKEDITOR.env.ie6Compat ? 'absolute' : 'fixed',
                                top : 0,
                                visibility : 'hidden'
                };

                startStyles[ dir == 'rtl' ? 'right' : 'left' ] = 0;
                this.parts.dialog.setStyles( startStyles );


                // Call the CKEDITOR.event constructor to initialize this instance.
                CKEDITOR.event.call( this );

                // Fire the "dialogDefinition" event, making it possible to customize
                // the dialog definition.
                this.definition = definition = CKEDITOR.fire( 'dialogDefinition',
                        {
                                name : dialogName,
                                definition : definition
                        }
                        , editor ).definition;

                var tabsToRemove = {};
                // Cache tabs that should be removed.
                if ( !( 'removeDialogTabs' in editor._ ) && editor.config.removeDialogTabs )
                {
                        var removeContents = editor.config.removeDialogTabs.split( ';' );

                        for ( i = 0; i < removeContents.length; i++ )
                        {
                                var parts = removeContents[ i ].split( ':' );
                                if ( parts.length == 2 )
                                {
                                        var removeDialogName = parts[ 0 ];
                                        if ( !tabsToRemove[ removeDialogName ] )
                                                tabsToRemove[ removeDialogName ] = [];
                                        tabsToRemove[ removeDialogName ].push( parts[ 1 ] );
                                }
                        }
                        editor._.removeDialogTabs = tabsToRemove;
                }

                // Remove tabs of this dialog.
                if ( editor._.removeDialogTabs && ( tabsToRemove = editor._.removeDialogTabs[ dialogName ] ) )
                {
                        for ( i = 0; i < tabsToRemove.length; i++ )
                                definition.removeContents( tabsToRemove[ i ] );
                }

                // Initialize load, show, hide, ok and cancel events.
                if ( definition.onLoad )
                        this.on( 'load', definition.onLoad );

                if ( definition.onShow )
                        this.on( 'show', definition.onShow );

                if ( definition.onHide )
                        this.on( 'hide', definition.onHide );

                if ( definition.onOk )
                {
                        this.on( 'ok', function( evt )
                                {
                                        // Dialog confirm might probably introduce content changes (#5415).
                                        editor.fire( 'saveSnapshot' );
                                        setTimeout( function () { editor.fire( 'saveSnapshot' ); }, 0 );
                                        if ( definition.onOk.call( this, evt ) === false )
                                                evt.data.hide = false;
                                });
                }

                if ( definition.onCancel )
                {
                        this.on( 'cancel', function( evt )
                                {
                                        if ( definition.onCancel.call( this, evt ) === false )
                                                evt.data.hide = false;
                                });
                }

                var me = this;

                // Iterates over all items inside all content in the dialog, calling a
                // function for each of them.
                var iterContents = function( func )
                {
                        var contents = me._.contents,
                                stop = false;

                        for ( var i in contents )
                        {
                                for ( var j in contents[i] )
                                {
                                        stop = func.call( this, contents[i][j] );
                                        if ( stop )
                                                return;
                                }
                        }
                };

                this.on( 'ok', function( evt )
                        {
                                iterContents( function( item )
                                        {
                                                if ( item.validate )
                                                {
                                                        var retval = item.validate( this ),
                                                                invalid = typeof ( retval ) == 'string' || retval === false;

                                                        if ( invalid )
                                                        {
                                                                evt.data.hide = false;
                                                                evt.stop();
                                                        }

                                                        handleFieldValidated.call( item, !invalid, typeof retval == 'string' ? retval : undefined );
                                                        return invalid;
                                                }
                                        });
                        }, this, null, 0 );

                this.on( 'cancel', function( evt )
                        {
                                iterContents( function( item )
                                        {
                                                if ( item.isChanged() )
                                                {
                                                        if ( !confirm( editor.lang.common.confirmCancel ) )
                                                                evt.data.hide = false;
                                                        return true;
                                                }
                                        });
                        }, this, null, 0 );

                this.parts.close.on( 'click', function( evt )
                                {
                                        if ( this.fire( 'cancel', { hide : true } ).hide !== false )
                                                this.hide();
                                        evt.data.preventDefault();
                                }, this );

                // Sort focus list according to tab order definitions.
                function setupFocus()
                {
                        var focusList = me._.focusList;
                        focusList.sort( function( a, b )
                                {
                                        // Mimics browser tab order logics;
                                        if ( a.tabIndex != b.tabIndex )
                                                return b.tabIndex - a.tabIndex;
                                        //  Sort is not stable in some browsers,
                                        // fall-back the comparator to 'focusIndex';
                                        else
                                                return a.focusIndex - b.focusIndex;
                                });

                        var size = focusList.length;
                        for ( var i = 0; i < size; i++ )
                                focusList[ i ].focusIndex = i;
                }

                function changeFocus( forward )
                {
                        var focusList = me._.focusList,
                                offset = forward ? 1 : -1;
                        if ( focusList.length < 1 )
                                return;

                        var current = me._.currentFocusIndex;

                        // Trigger the 'blur' event of  any input element before anything,
                        // since certain UI updates may depend on it.
                        try
                        {
                                focusList[ current ].getInputElement().$.blur();
                        }
                        catch( e ){}

                        var startIndex = ( current + offset + focusList.length ) % focusList.length,
                                currentIndex = startIndex;
                        while ( !focusList[ currentIndex ].isFocusable() )
                        {
                                currentIndex = ( currentIndex + offset + focusList.length ) % focusList.length;
                                if ( currentIndex == startIndex )
                                        break;
                        }
                        focusList[ currentIndex ].focus();

                        // Select whole field content.
                        if ( focusList[ currentIndex ].type == 'text' )
                                focusList[ currentIndex ].select();
                }

                this.changeFocus = changeFocus;

                var processed;

                function focusKeydownHandler( evt )
                {
                        // If I'm not the top dialog, ignore.
                        if ( me != CKEDITOR.dialog._.currentTop )
                                return;

                        var keystroke = evt.data.getKeystroke(),
                                rtl = editor.lang.dir == 'rtl';

                        processed = 0;
                        if ( keystroke == 9 || keystroke == CKEDITOR.SHIFT + 9 )
                        {
                                var shiftPressed = ( keystroke == CKEDITOR.SHIFT + 9 );

                                // Handling Tab and Shift-Tab.
                                if ( me._.tabBarMode )
                                {
                                        // Change tabs.
                                        var nextId = shiftPressed ? getPreviousVisibleTab.call( me ) : getNextVisibleTab.call( me );
                                        me.selectPage( nextId );
                                        me._.tabs[ nextId ][ 0 ].focus();
                                }
                                else
                                {
                                        // Change the focus of inputs.
                                        changeFocus( !shiftPressed );
                                }

                                processed = 1;
                        }
                        else if ( keystroke == CKEDITOR.ALT + 121 && !me._.tabBarMode && me.getPageCount() > 1 )
                        {
                                // Alt-F10 puts focus into the current tab item in the tab bar.
                                me._.tabBarMode = true;
                                me._.tabs[ me._.currentTabId ][ 0 ].focus();
                                processed = 1;
                        }
                        else if ( ( keystroke == 37 || keystroke == 39 ) && me._.tabBarMode )
                        {
                                // Arrow keys - used for changing tabs.
                                nextId = ( keystroke == ( rtl ? 39 : 37 ) ? getPreviousVisibleTab.call( me ) : getNextVisibleTab.call( me ) );
                                me.selectPage( nextId );
                                me._.tabs[ nextId ][ 0 ].focus();
                                processed = 1;
                        }
                        else if ( ( keystroke == 13 || keystroke == 32 ) && me._.tabBarMode )
                        {
                                this.selectPage( this._.currentTabId );
                                this._.tabBarMode = false;
                                this._.currentFocusIndex = -1;
                                changeFocus( true );
                                processed = 1;
                        }

                        if ( processed )
                        {
                                evt.stop();
                                evt.data.preventDefault();
                        }
                }

                function focusKeyPressHandler( evt )
                {
                        processed && evt.data.preventDefault();
                }

                var dialogElement = this._.element;
                // Add the dialog keyboard handlers.
                this.on( 'show', function()
                        {
                                dialogElement.on( 'keydown', focusKeydownHandler, this, null, 0 );
                                // Some browsers instead, don't cancel key events in the keydown, but in the
                                // keypress. So we must do a longer trip in those cases. (#4531)
                                if ( CKEDITOR.env.opera || ( CKEDITOR.env.gecko && CKEDITOR.env.mac ) )
                                        dialogElement.on( 'keypress', focusKeyPressHandler, this );

                        } );
                this.on( 'hide', function()
                        {
                                dialogElement.removeListener( 'keydown', focusKeydownHandler );
                                if ( CKEDITOR.env.opera || ( CKEDITOR.env.gecko && CKEDITOR.env.mac ) )
                                        dialogElement.removeListener( 'keypress', focusKeyPressHandler );

                                // Reset fields state when closing dialog.
                                iterContents( function( item ) { resetField.apply( item ); } );
                        } );
                this.on( 'iframeAdded', function( evt )
                        {
                                var doc = new CKEDITOR.dom.document( evt.data.iframe.$.contentWindow.document );
                                doc.on( 'keydown', focusKeydownHandler, this, null, 0 );
                        } );

                // Auto-focus logic in dialog.
                this.on( 'show', function()
                        {
                                // Setup tabIndex on showing the dialog instead of on loading
                                // to allow dynamic tab order happen in dialog definition.
                                setupFocus();

                                if ( editor.config.dialog_startupFocusTab
                                        && me._.pageCount > 1 )
                                {
                                        me._.tabBarMode = true;
                                        me._.tabs[ me._.currentTabId ][ 0 ].focus();
                                }
                                else if ( !this._.hasFocus )
                                {
                                        this._.currentFocusIndex = -1;

                                        // Decide where to put the initial focus.
                                        if ( definition.onFocus )
                                        {
                                                var initialFocus = definition.onFocus.call( this );
                                                // Focus the field that the user specified.
                                                initialFocus && initialFocus.focus();
                                        }
                                        // Focus the first field in layout order.
                                        else
                                                changeFocus( true );

                                        /*
                                         * IE BUG: If the initial focus went into a non-text element (e.g. button),
                                         * then IE would still leave the caret inside the editing area.
                                         */
                                        if ( this._.editor.mode == 'wysiwyg' && CKEDITOR.env.ie )
                                        {
                                                var $selection = editor.document.$.selection,
                                                        $range = $selection.createRange();

                                                if ( $range )
                                                {
                                                        if ( $range.parentElement && $range.parentElement().ownerDocument == editor.document.$
                                                          || $range.item && $range.item( 0 ).ownerDocument == editor.document.$ )
                                                        {
                                                                var $myRange = document.body.createTextRange();
                                                                $myRange.moveToElementText( this.getElement().getFirst().$ );
                                                                $myRange.collapse( true );
                                                                $myRange.select();
                                                        }
                                                }
                                        }
                                }
                        }, this, null, 0xffffffff );

                // IE6 BUG: Text fields and text areas are only half-rendered the first time the dialog appears in IE6 (#2661).
                // This is still needed after [2708] and [2709] because text fields in hidden TR tags are still broken.
                if ( CKEDITOR.env.ie6Compat )
                {
                        this.on( 'load', function( evt )
                                        {
                                                var outer = this.getElement(),
                                                        inner = outer.getFirst();
                                                inner.remove();
                                                inner.appendTo( outer );
                                        }, this );
                }

                initDragAndDrop( this );
                initResizeHandles( this );

                // Insert the title.
                ( new CKEDITOR.dom.text( definition.title, CKEDITOR.document ) ).appendTo( this.parts.title );

                // Insert the tabs and contents.
                for ( var i = 0 ; i < definition.contents.length ; i++ )
                {
                        var page = definition.contents[i];
                        page && this.addPage( page );
                }

                this.parts[ 'tabs' ].on( 'click', function( evt )
                                {
                                        var target = evt.data.getTarget();
                                        // If we aren't inside a tab, bail out.
                                        if ( target.hasClass( 'cke_dialog_tab' ) )
                                        {
                                                // Get the ID of the tab, without the 'cke_' prefix and the unique number suffix.
                                                var id = target.$.id;
                                                this.selectPage( id.substring( 4, id.lastIndexOf( '_' ) ) );

                                                if ( this._.tabBarMode )
                                                {
                                                        this._.tabBarMode = false;
                                                        this._.currentFocusIndex = -1;
                                                        changeFocus( true );
                                                }
                                                evt.data.preventDefault();
                                        }
                                }, this );

                // Insert buttons.
                var buttonsHtml = [],
                        buttons = CKEDITOR.dialog._.uiElementBuilders.hbox.build( this,
                                {
                                        type : 'hbox',
                                        className : 'cke_dialog_footer_buttons',
                                        widths : [],
                                        children : definition.buttons
                                }, buttonsHtml ).getChild();
                this.parts.footer.setHtml( buttonsHtml.join( '' ) );

                for ( i = 0 ; i < buttons.length ; i++ )
                        this._.buttons[ buttons[i].id ] = buttons[i];
        };

        // Focusable interface. Use it via dialog.addFocusable.
        function Focusable( dialog, element, index )
        {
                this.element = element;
                this.focusIndex = index;
                // TODO: support tabIndex for focusables.
                this.tabIndex = 0;
                this.isFocusable = function()
                {
                        return !element.getAttribute( 'disabled' ) && element.isVisible();
                };
                this.focus = function()
                {
                        dialog._.currentFocusIndex = this.focusIndex;
                        this.element.focus();
                };
                // Bind events
                element.on( 'keydown', function( e )
                        {
                                if ( e.data.getKeystroke() in { 32:1, 13:1 }  )
                                        this.fire( 'click' );
                        } );
                element.on( 'focus', function()
                        {
                                this.fire( 'mouseover' );
                        } );
                element.on( 'blur', function()
                        {
                                this.fire( 'mouseout' );
                        } );
        }

        CKEDITOR.dialog.prototype =
        {
                destroy : function()
                {
                        this.hide();
                        this._.element.remove();
                },

                /**
                 * Resizes the dialog.
                 * @param {Number} width The width of the dialog in pixels.
                 * @param {Number} height The height of the dialog in pixels.
                 * @function
                 * @example
                 * dialogObj.resize( 800, 640 );
                 */
                resize : (function()
                {
                        return function( width, height )
                        {
                                if ( this._.contentSize && this._.contentSize.width == width && this._.contentSize.height == height )
                                        return;

                                CKEDITOR.dialog.fire( 'resize',
                                        {
                                                dialog : this,
                                                skin : this._.editor.skinName,
                                                width : width,
                                                height : height
                                        }, this._.editor );

                                this.fire( 'resize',
                                        {
                                                skin : this._.editor.skinName,
                                                width : width,
                                                height : height
                                        }, this._.editor );

                                // Update dialog position when dimension get changed in RTL.
                                if ( this._.editor.lang.dir == 'rtl' && this._.position )
                                        this._.position.x = CKEDITOR.document.getWindow().getViewPaneSize().width -
                                                this._.contentSize.width - parseInt( this._.element.getFirst().getStyle( 'right' ), 10 );

                                this._.contentSize = { width : width, height : height };
                        };
                })(),

                /**
                 * Gets the current size of the dialog in pixels.
                 * @returns {Object} An object with "width" and "height" properties.
                 * @example
                 * var width = dialogObj.getSize().width;
                 */
                getSize : function()
                {
                        var element = this._.element.getFirst();
                        return { width : element.$.offsetWidth || 0, height : element.$.offsetHeight || 0};
                },

                /**
                 * Moves the dialog to an (x, y) coordinate relative to the window.
                 * @function
                 * @param {Number} x The target x-coordinate.
                 * @param {Number} y The target y-coordinate.
                 * @param {Boolean} save Flag indicate whether the dialog position should be remembered on next open up.
                 * @example
                 * dialogObj.move( 10, 40 );
                 */
                move : (function()
                {
                        var isFixed;
                        return function( x, y, save )
                        {
                                // The dialog may be fixed positioned or absolute positioned. Ask the
                                // browser what is the current situation first.
                                var element = this._.element.getFirst(),
                                        rtl = this._.editor.lang.dir == 'rtl';

                                if ( isFixed === undefined )
                                        isFixed = element.getComputedStyle( 'position' ) == 'fixed';

                                if ( isFixed && this._.position && this._.position.x == x && this._.position.y == y )
                                        return;

                                // Save the current position.
                                this._.position = { x : x, y : y };

                                // If not fixed positioned, add scroll position to the coordinates.
                                if ( !isFixed )
                                {
                                        var scrollPosition = CKEDITOR.document.getWindow().getScrollPosition();
                                        x += scrollPosition.x;
                                        y += scrollPosition.y;
                                }

                                // Translate coordinate for RTL.
                                if ( rtl )
                                {
                                        var dialogSize = this.getSize(),
                                                viewPaneSize = CKEDITOR.document.getWindow().getViewPaneSize();
                                        x = viewPaneSize.width - dialogSize.width - x;
                                }

                                var styles = { 'top'    : ( y > 0 ? y : 0 ) + 'px' };
                                styles[ rtl ? 'right' : 'left' ] = ( x > 0 ? x : 0 ) + 'px';

                                element.setStyles( styles );

                                save && ( this._.moved = 1 );
                        };
                })(),

                /**
                 * Gets the dialog's position in the window.
                 * @returns {Object} An object with "x" and "y" properties.
                 * @example
                 * var dialogX = dialogObj.getPosition().x;
                 */
                getPosition : function(){ return CKEDITOR.tools.extend( {}, this._.position ); },

                /**
                 * Shows the dialog box.
                 * @example
                 * dialogObj.show();
                 */
                show : function()
                {
                        // Insert the dialog's element to the root document.
                        var element = this._.element;
                        var definition = this.definition;
                        if ( !( element.getParent() && element.getParent().equals( CKEDITOR.document.getBody() ) ) )
                                element.appendTo( CKEDITOR.document.getBody() );
                        else
                                element.setStyle( 'display', 'block' );

                        // FIREFOX BUG: Fix vanishing caret for Firefox 2 or Gecko 1.8.
                        if ( CKEDITOR.env.gecko && CKEDITOR.env.version < 10900 )
                        {
                                var dialogElement = this.parts.dialog;
                                dialogElement.setStyle( 'position', 'absolute' );
                                setTimeout( function()
                                        {
                                                dialogElement.setStyle( 'position', 'fixed' );
                                        }, 0 );
                        }


                        // First, set the dialog to an appropriate size.
                        this.resize( this._.contentSize && this._.contentSize.width || definition.width || definition.minWidth,
                                        this._.contentSize && this._.contentSize.height || definition.height || definition.minHeight );

                        // Reset all inputs back to their default value.
                        this.reset();

                        // Select the first tab by default.
                        this.selectPage( this.definition.contents[0].id );

                        // Set z-index.
                        if ( CKEDITOR.dialog._.currentZIndex === null )
                                CKEDITOR.dialog._.currentZIndex = this._.editor.config.baseFloatZIndex;
                        this._.element.getFirst().setStyle( 'z-index', CKEDITOR.dialog._.currentZIndex += 10 );

                        // Maintain the dialog ordering and dialog cover.
                        // Also register key handlers if first dialog.
                        if ( CKEDITOR.dialog._.currentTop === null )
                        {
                                CKEDITOR.dialog._.currentTop = this;
                                this._.parentDialog = null;
                                showCover( this._.editor );

                                element.on( 'keydown', accessKeyDownHandler );
                                element.on( CKEDITOR.env.opera ? 'keypress' : 'keyup', accessKeyUpHandler );

                                // Prevent some keys from bubbling up. (#4269)
                                for ( var event in { keyup :1, keydown :1, keypress :1 } )
                                        element.on( event, preventKeyBubbling );
                        }
                        else
                        {
                                this._.parentDialog = CKEDITOR.dialog._.currentTop;
                                var parentElement = this._.parentDialog.getElement().getFirst();
                                parentElement.$.style.zIndex  -= Math.floor( this._.editor.config.baseFloatZIndex / 2 );
                                CKEDITOR.dialog._.currentTop = this;
                        }

                        // Register the Esc hotkeys.
                        registerAccessKey( this, this, '\x1b', null, function()
                                        {
                                                this.getButton( 'cancel' ) && this.getButton( 'cancel' ).click();
                                        } );

                        // Reset the hasFocus state.
                        this._.hasFocus = false;

                        CKEDITOR.tools.setTimeout( function()
                                {
                                        this.layout();
                                        this.parts.dialog.setStyle( 'visibility', '' );

                                        // Execute onLoad for the first show.
                                        this.fireOnce( 'load', {} );
                                        CKEDITOR.ui.fire( 'ready', this );

                                        this.fire( 'show', {} );
                                        this._.editor.fire( 'dialogShow', this );

                                        // Save the initial values of the dialog.
                                        this.foreach( function( contentObj ) { contentObj.setInitValue && contentObj.setInitValue(); } );

                                },
                                100, this );
                },

                /**
                 * Rearrange the dialog to its previous position or the middle of the window.
                 * @since 3.5
                 */
                layout : function()
                {
                        var viewSize = CKEDITOR.document.getWindow().getViewPaneSize(),
                                        dialogSize = this.getSize();

                        this.move( this._.moved ? this._.position.x : ( viewSize.width - dialogSize.width ) / 2,
                                        this._.moved ? this._.position.y : ( viewSize.height - dialogSize.height ) / 2 );
                },

                /**
                 * Executes a function for each UI element.
                 * @param {Function} fn Function to execute for each UI element.
                 * @returns {CKEDITOR.dialog} The current dialog object.
                 */
                foreach : function( fn )
                {
                        for ( var i in this._.contents )
                        {
                                for ( var j in this._.contents[i] )
                                        fn.call( this, this._.contents[i][j] );
                        }
                        return this;
                },

                /**
                 * Resets all input values in the dialog.
                 * @example
                 * dialogObj.reset();
                 * @returns {CKEDITOR.dialog} The current dialog object.
                 */
                reset : (function()
                {
                        var fn = function( widget ){ if ( widget.reset ) widget.reset( 1 ); };
                        return function(){ this.foreach( fn ); return this; };
                })(),


                /**
                 * Calls the {@link CKEDITOR.dialog.definition.uiElement#setup} method of each of the UI elements, with the arguments passed through it.
                 * It is usually being called when the dialog is opened, to put the initial value inside the field.
                 * @example
                 * dialogObj.setupContent();
                 * @example
                 * var timestamp = ( new Date() ).valueOf();
                 * dialogObj.setupContent( timestamp );
                 */
                setupContent : function()
                {
                        var args = arguments;
                        this.foreach( function( widget )
                                {
                                        if ( widget.setup )
                                                widget.setup.apply( widget, args );
                                });
                },

                /**
                 * Calls the {@link CKEDITOR.dialog.definition.uiElement#commit} method of each of the UI elements, with the arguments passed through it.
                 * It is usually being called when the user confirms the dialog, to process the values.
                 * @example
                 * dialogObj.commitContent();
                 * @example
                 * var timestamp = ( new Date() ).valueOf();
                 * dialogObj.commitContent( timestamp );
                 */
                commitContent : function()
                {
                        var args = arguments;
                        this.foreach( function( widget )
                                {
                                        // Make sure IE triggers "change" event on last focused input before closing the dialog. (#7915)
                                        if ( CKEDITOR.env.ie && this._.currentFocusIndex == widget.focusIndex )
                                                widget.getInputElement().$.blur();

                                        if ( widget.commit )
                                                widget.commit.apply( widget, args );
                                });
                },

                /**
                 * Hides the dialog box.
                 * @example
                 * dialogObj.hide();
                 */
                hide : function()
                {
                        if ( !this.parts.dialog.isVisible() )
                                return;

                        this.fire( 'hide', {} );
                        this._.editor.fire( 'dialogHide', this );
                        var element = this._.element;
                        element.setStyle( 'display', 'none' );
                        this.parts.dialog.setStyle( 'visibility', 'hidden' );
                        // Unregister all access keys associated with this dialog.
                        unregisterAccessKey( this );

                        // Close any child(top) dialogs first.
                        while( CKEDITOR.dialog._.currentTop != this )
                                CKEDITOR.dialog._.currentTop.hide();

                        // Maintain dialog ordering and remove cover if needed.
                        if ( !this._.parentDialog )
                                hideCover();
                        else
                        {
                                var parentElement = this._.parentDialog.getElement().getFirst();
                                parentElement.setStyle( 'z-index', parseInt( parentElement.$.style.zIndex, 10 ) + Math.floor( this._.editor.config.baseFloatZIndex / 2 ) );
                        }
                        CKEDITOR.dialog._.currentTop = this._.parentDialog;

                        // Deduct or clear the z-index.
                        if ( !this._.parentDialog )
                        {
                                CKEDITOR.dialog._.currentZIndex = null;

                                // Remove access key handlers.
                                element.removeListener( 'keydown', accessKeyDownHandler );
                                element.removeListener( CKEDITOR.env.opera ? 'keypress' : 'keyup', accessKeyUpHandler );

                                // Remove bubbling-prevention handler. (#4269)
                                for ( var event in { keyup :1, keydown :1, keypress :1 } )
                                        element.removeListener( event, preventKeyBubbling );

                                var editor = this._.editor;
                                editor.focus();

                                if ( editor.mode == 'wysiwyg' && CKEDITOR.env.ie )
                                {
                                        var selection = editor.getSelection();
                                        selection && selection.unlock( true );
                                }
                        }
                        else
                                CKEDITOR.dialog._.currentZIndex -= 10;

                        delete this._.parentDialog;
                        // Reset the initial values of the dialog.
                        this.foreach( function( contentObj ) { contentObj.resetInitValue && contentObj.resetInitValue(); } );
                },

                /**
                 * Adds a tabbed page into the dialog.
                 * @param {Object} contents Content definition.
                 * @example
                 */
                addPage : function( contents )
                {
                        var pageHtml = [],
                                titleHtml = contents.label ? ' title="' + CKEDITOR.tools.htmlEncode( contents.label ) + '"' : '',
                                elements = contents.elements,
                                vbox = CKEDITOR.dialog._.uiElementBuilders.vbox.build( this,
                                                {
                                                        type : 'vbox',
                                                        className : 'cke_dialog_page_contents',
                                                        children : contents.elements,
                                                        expand : !!contents.expand,
                                                        padding : contents.padding,
                                                        style : contents.style || 'width: 100%;height:100%'
                                                }, pageHtml );

                        // Create the HTML for the tab and the content block.
                        var page = CKEDITOR.dom.element.createFromHtml( pageHtml.join( '' ) );
                        page.setAttribute( 'role', 'tabpanel' );

                        var env = CKEDITOR.env;
                        var tabId = 'cke_' + contents.id + '_' + CKEDITOR.tools.getNextNumber(),
                                 tab = CKEDITOR.dom.element.createFromHtml( [
                                        '<a class="cke_dialog_tab"',
                                                ( this._.pageCount > 0 ? ' cke_last' : 'cke_first' ),
                                                titleHtml,
                                                ( !!contents.hidden ? ' style="display:none"' : '' ),
                                                ' id="', tabId, '"',
                                                env.gecko && env.version >= 10900 && !env.hc ? '' : ' href="javascript:void(0)"',
                                                ' tabIndex="-1"',
                                                ' hidefocus="true"',
                                                ' role="tab">',
                                                        contents.label,
                                        '</a>'
                                ].join( '' ) );

                        page.setAttribute( 'aria-labelledby', tabId );

                        // Take records for the tabs and elements created.
                        this._.tabs[ contents.id ] = [ tab, page ];
                        this._.tabIdList.push( contents.id );
                        !contents.hidden && this._.pageCount++;
                        this._.lastTab = tab;
                        this.updateStyle();

                        var contentMap = this._.contents[ contents.id ] = {},
                                cursor,
                                children = vbox.getChild();

                        while ( ( cursor = children.shift() ) )
                        {
                                contentMap[ cursor.id ] = cursor;
                                if ( typeof( cursor.getChild ) == 'function' )
                                        children.push.apply( children, cursor.getChild() );
                        }

                        // Attach the DOM nodes.

                        page.setAttribute( 'name', contents.id );
                        page.appendTo( this.parts.contents );

                        tab.unselectable();
                        this.parts.tabs.append( tab );

                        // Add access key handlers if access key is defined.
                        if ( contents.accessKey )
                        {
                                registerAccessKey( this, this, 'CTRL+' + contents.accessKey,
                                        tabAccessKeyDown, tabAccessKeyUp );
                                this._.accessKeyMap[ 'CTRL+' + contents.accessKey ] = contents.id;
                        }
                },

                /**
                 * Activates a tab page in the dialog by its id.
                 * @param {String} id The id of the dialog tab to be activated.
                 * @example
                 * dialogObj.selectPage( 'tab_1' );
                 */
                selectPage : function( id )
                {
                        if ( this._.currentTabId == id )
                                return;

                        // Returning true means that the event has been canceled
                        if ( this.fire( 'selectPage', { page : id, currentPage : this._.currentTabId } ) === true )
                                return;

                        // Hide the non-selected tabs and pages.
                        for ( var i in this._.tabs )
                        {
                                var tab = this._.tabs[i][0],
                                        page = this._.tabs[i][1];
                                if ( i != id )
                                {
                                        tab.removeClass( 'cke_dialog_tab_selected' );
                                        page.hide();
                                }
                                page.setAttribute( 'aria-hidden', i != id );
                        }

                        var selected = this._.tabs[ id ];
                        selected[ 0 ].addClass( 'cke_dialog_tab_selected' );

                        // [IE] an invisible input[type='text'] will enlarge it's width
                        // if it's value is long when it shows, so we clear it's value
                        // before it shows and then recover it (#5649)
                        if ( CKEDITOR.env.ie6Compat || CKEDITOR.env.ie7Compat )
                        {
                                clearOrRecoverTextInputValue( selected[ 1 ] );
                                selected[ 1 ].show();
                                setTimeout( function()
                                {
                                        clearOrRecoverTextInputValue( selected[ 1 ], 1 );
                                }, 0 );
                        }
                        else
                                selected[ 1 ].show();

                        this._.currentTabId = id;
                        this._.currentTabIndex = CKEDITOR.tools.indexOf( this._.tabIdList, id );
                },

                // Dialog state-specific style updates.
                updateStyle : function()
                {
                        // If only a single page shown, a different style is used in the central pane.
                        this.parts.dialog[ ( this._.pageCount === 1 ? 'add' : 'remove' ) + 'Class' ]( 'cke_single_page' );
                },

                /**
                 * Hides a page's tab away from the dialog.
                 * @param {String} id The page's Id.
                 * @example
                 * dialog.hidePage( 'tab_3' );
                 */
                hidePage : function( id )
                {
                        var tab = this._.tabs[id] && this._.tabs[id][0];
                        if ( !tab || this._.pageCount == 1 || !tab.isVisible() )
                                return;
                        // Switch to other tab first when we're hiding the active tab.
                        else if ( id == this._.currentTabId )
                                this.selectPage( getPreviousVisibleTab.call( this ) );

                        tab.hide();
                        this._.pageCount--;
                        this.updateStyle();
                },

                /**
                 * Unhides a page's tab.
                 * @param {String} id The page's Id.
                 * @example
                 * dialog.showPage( 'tab_2' );
                 */
                showPage : function( id )
                {
                        var tab = this._.tabs[id] && this._.tabs[id][0];
                        if ( !tab )
                                return;
                        tab.show();
                        this._.pageCount++;
                        this.updateStyle();
                },

                /**
                 * Gets the root DOM element of the dialog.
                 * @returns {CKEDITOR.dom.element} The &lt;span&gt; element containing this dialog.
                 * @example
                 * var dialogElement = dialogObj.getElement().getFirst();
                 * dialogElement.setStyle( 'padding', '5px' );
                 */
                getElement : function()
                {
                        return this._.element;
                },

                /**
                 * Gets the name of the dialog.
                 * @returns {String} The name of this dialog.
                 * @example
                 * var dialogName = dialogObj.getName();
                 */
                getName : function()
                {
                        return this._.name;
                },

                /**
                 * Gets a dialog UI element object from a dialog page.
                 * @param {String} pageId id of dialog page.
                 * @param {String} elementId id of UI element.
                 * @example
                 * dialogObj.getContentElement( 'tabId', 'elementId' ).setValue( 'Example' );
                 * @returns {CKEDITOR.ui.dialog.uiElement} The dialog UI element.
                 */
                getContentElement : function( pageId, elementId )
                {
                        var page = this._.contents[ pageId ];
                        return page && page[ elementId ];
                },

                /**
                 * Gets the value of a dialog UI element.
                 * @param {String} pageId id of dialog page.
                 * @param {String} elementId id of UI element.
                 * @example
                 * alert( dialogObj.getValueOf( 'tabId', 'elementId' ) );
                 * @returns {Object} The value of the UI element.
                 */
                getValueOf : function( pageId, elementId )
                {
                        return this.getContentElement( pageId, elementId ).getValue();
                },

                /**
                 * Sets the value of a dialog UI element.
                 * @param {String} pageId id of the dialog page.
                 * @param {String} elementId id of the UI element.
                 * @param {Object} value The new value of the UI element.
                 * @example
                 * dialogObj.setValueOf( 'tabId', 'elementId', 'Example' );
                 */
                setValueOf : function( pageId, elementId, value )
                {
                        return this.getContentElement( pageId, elementId ).setValue( value );
                },

                /**
                 * Gets the UI element of a button in the dialog's button row.
                 * @param {String} id The id of the button.
                 * @example
                 * @returns {CKEDITOR.ui.dialog.button} The button object.
                 */
                getButton : function( id )
                {
                        return this._.buttons[ id ];
                },

                /**
                 * Simulates a click to a dialog button in the dialog's button row.
                 * @param {String} id The id of the button.
                 * @example
                 * @returns The return value of the dialog's "click" event.
                 */
                click : function( id )
                {
                        return this._.buttons[ id ].click();
                },

                /**
                 * Disables a dialog button.
                 * @param {String} id The id of the button.
                 * @example
                 */
                disableButton : function( id )
                {
                        return this._.buttons[ id ].disable();
                },

                /**
                 * Enables a dialog button.
                 * @param {String} id The id of the button.
                 * @example
                 */
                enableButton : function( id )
                {
                        return this._.buttons[ id ].enable();
                },

                /**
                 * Gets the number of pages in the dialog.
                 * @returns {Number} Page count.
                 */
                getPageCount : function()
                {
                        return this._.pageCount;
                },

                /**
                 * Gets the editor instance which opened this dialog.
                 * @returns {CKEDITOR.editor} Parent editor instances.
                 */
                getParentEditor : function()
                {
                        return this._.editor;
                },

                /**
                 * Gets the element that was selected when opening the dialog, if any.
                 * @returns {CKEDITOR.dom.element} The element that was selected, or null.
                 */
                getSelectedElement : function()
                {
                        return this.getParentEditor().getSelection().getSelectedElement();
                },

                /**
                 * Adds element to dialog's focusable list.
                 *
                 * @param {CKEDITOR.dom.element} element
                 * @param {Number} [index]
                 */
                addFocusable: function( element, index ) {
                        if ( typeof index == 'undefined' )
                        {
                                index = this._.focusList.length;
                                this._.focusList.push( new Focusable( this, element, index ) );
                        }
                        else
                        {
                                this._.focusList.splice( index, 0, new Focusable( this, element, index ) );
                                for ( var i = index + 1 ; i < this._.focusList.length ; i++ )
                                        this._.focusList[ i ].focusIndex++;
                        }
                }
        };

        CKEDITOR.tools.extend( CKEDITOR.dialog,
                /**
                 * @lends CKEDITOR.dialog
                 */
                {
                        /**
                         * Registers a dialog.
                         * @param {String} name The dialog's name.
                         * @param {Function|String} dialogDefinition
                         * A function returning the dialog's definition, or the URL to the .js file holding the function.
                         * The function should accept an argument "editor" which is the current editor instance, and
                         * return an object conforming to {@link CKEDITOR.dialog.definition}.
                         * @see CKEDITOR.dialog.definition
                         * @example
                         * // Full sample plugin, which does not only register a dialog window but also adds an item to the context menu.
                         * // To open the dialog window, choose "Open dialog" in the context menu.
                         * CKEDITOR.plugins.add( 'myplugin',
                         * {
                         *      init: function( editor )
                         *      {
                         *              editor.addCommand( 'mydialog',new CKEDITOR.dialogCommand( 'mydialog' ) );
                         *
                         *              if ( editor.contextMenu )
                         *              {
                         *                      editor.addMenuGroup( 'mygroup', 10 );
                         *                      editor.addMenuItem( 'My Dialog',
                         *                      {
                         *                              label : 'Open dialog',
                         *                              command : 'mydialog',
                         *                              group : 'mygroup'
                         *                      });
                         *                      editor.contextMenu.addListener( function( element )
                         *                      {
                         *                              return { 'My Dialog' : CKEDITOR.TRISTATE_OFF };
                         *                      });
                         *              }
                         *
                         *              <strong>CKEDITOR.dialog.add</strong>( 'mydialog', function( api )
                         *              {
                         *                      // CKEDITOR.dialog.definition
                         *                      var <strong>dialogDefinition</strong> =
                         *                      {
                         *                              title : 'Sample dialog',
                         *                              minWidth : 390,
                         *                              minHeight : 130,
                         *                              contents : [
                         *                                      {
                         *                                              id : 'tab1',
                         *                                              label : 'Label',
                         *                                              title : 'Title',
                         *                                              expand : true,
                         *                                              padding : 0,
                         *                                              elements :
                         *                                              [
                         *                                                      {
                         *                                                              type : 'html',
                         *                                                              html : '&lt;p&gt;This is some sample HTML content.&lt;/p&gt;'
                         *                                                      },
                         *                                                      {
                         *                                                              type : 'textarea',
                         *                                                              id : 'textareaId',
                         *                                                              rows : 4,
                         *                                                              cols : 40
                         *                                                      }
                         *                                              ]
                         *                                      }
                         *                              ],
                         *                              buttons : [ CKEDITOR.dialog.okButton, CKEDITOR.dialog.cancelButton ],
                         *                              onOk : function() {
                         *                                      // "this" is now a CKEDITOR.dialog object.
                         *                                      // Accessing dialog elements:
                         *                                      var textareaObj = this.<strong>getContentElement</strong>( 'tab1', 'textareaId' );
                         *                                      alert( "You have entered: " + textareaObj.getValue() );
                         *                              }
                         *                      };
                         *
                         *                      return dialogDefinition;
                         *              } );
                         *      }
                         * } );
                         *
                         * CKEDITOR.replace( 'editor1', { extraPlugins : 'myplugin' } );
                         */
                        add : function( name, dialogDefinition )
                        {
                                // Avoid path registration from multiple instances override definition.
                                if ( !this._.dialogDefinitions[name]
                                        || typeof  dialogDefinition == 'function' )
                                        this._.dialogDefinitions[name] = dialogDefinition;
                        },

                        exists : function( name )
                        {
                                return !!this._.dialogDefinitions[ name ];
                        },

                        getCurrent : function()
                        {
                                return CKEDITOR.dialog._.currentTop;
                        },

                        /**
                         * The default OK button for dialogs. Fires the "ok" event and closes the dialog if the event succeeds.
                         * @static
                         * @field
                         * @example
                         * @type Function
                         */
                        okButton : (function()
                        {
                                var retval = function( editor, override )
                                {
                                        override = override || {};
                                        return CKEDITOR.tools.extend( {
                                                id : 'ok',
                                                type : 'button',
                                                label : editor.lang.common.ok,
                                                'class' : 'cke_dialog_ui_button_ok',
                                                onClick : function( evt )
                                                {
                                                        var dialog = evt.data.dialog;
                                                        if ( dialog.fire( 'ok', { hide : true } ).hide !== false )
                                                                dialog.hide();
                                                }
                                        }, override, true );
                                };
                                retval.type = 'button';
                                retval.override = function( override )
                                {
                                        return CKEDITOR.tools.extend( function( editor ){ return retval( editor, override ); },
                                                        { type : 'button' }, true );
                                };
                                return retval;
                        })(),

                        /**
                         * The default cancel button for dialogs. Fires the "cancel" event and closes the dialog if no UI element value changed.
                         * @static
                         * @field
                         * @example
                         * @type Function
                         */
                        cancelButton : (function()
                        {
                                var retval = function( editor, override )
                                {
                                        override = override || {};
                                        return CKEDITOR.tools.extend( {
                                                id : 'cancel',
                                                type : 'button',
                                                label : editor.lang.common.cancel,
                                                'class' : 'cke_dialog_ui_button_cancel',
                                                onClick : function( evt )
                                                {
                                                        var dialog = evt.data.dialog;
                                                        if ( dialog.fire( 'cancel', { hide : true } ).hide !== false )
                                                                dialog.hide();
                                                }
                                        }, override, true );
                                };
                                retval.type = 'button';
                                retval.override = function( override )
                                {
                                        return CKEDITOR.tools.extend( function( editor ){ return retval( editor, override ); },
                                                        { type : 'button' }, true );
                                };
                                return retval;
                        })(),

                        /**
                         * Registers a dialog UI element.
                         * @param {String} typeName The name of the UI element.
                         * @param {Function} builder The function to build the UI element.
                         * @example
                         */
                        addUIElement : function( typeName, builder )
                        {
                                this._.uiElementBuilders[ typeName ] = builder;
                        }
                });

        CKEDITOR.dialog._ =
        {
                uiElementBuilders : {},

                dialogDefinitions : {},

                currentTop : null,

                currentZIndex : null
        };

        // "Inherit" (copy actually) from CKEDITOR.event.
        CKEDITOR.event.implementOn( CKEDITOR.dialog );
        CKEDITOR.event.implementOn( CKEDITOR.dialog.prototype, true );

        var defaultDialogDefinition =
        {
                resizable : CKEDITOR.DIALOG_RESIZE_BOTH,
                minWidth : 600,
                minHeight : 400,
                buttons : [ CKEDITOR.dialog.okButton, CKEDITOR.dialog.cancelButton ]
        };

        // Tool function used to return an item from an array based on its id
        // property.
        var getById = function( array, id, recurse )
        {
                for ( var i = 0, item ; ( item = array[ i ] ) ; i++ )
                {
                        if ( item.id == id )
                                return item;
                        if ( recurse && item[ recurse ] )
                        {
                                var retval = getById( item[ recurse ], id, recurse ) ;
                                if ( retval )
                                        return retval;
                        }
                }
                return null;
        };

        // Tool function used to add an item into an array.
        var addById = function( array, newItem, nextSiblingId, recurse, nullIfNotFound )
        {
                if ( nextSiblingId )
                {
                        for ( var i = 0, item ; ( item = array[ i ] ) ; i++ )
                        {
                                if ( item.id == nextSiblingId )
                                {
                                        array.splice( i, 0, newItem );
                                        return newItem;
                                }

                                if ( recurse && item[ recurse ] )
                                {
                                        var retval = addById( item[ recurse ], newItem, nextSiblingId, recurse, true );
                                        if ( retval )
                                                return retval;
                                }
                        }

                        if ( nullIfNotFound )
                                return null;
                }

                array.push( newItem );
                return newItem;
        };

        // Tool function used to remove an item from an array based on its id.
        var removeById = function( array, id, recurse )
        {
                for ( var i = 0, item ; ( item = array[ i ] ) ; i++ )
                {
                        if ( item.id == id )
                                return array.splice( i, 1 );
                        if ( recurse && item[ recurse ] )
                        {
                                var retval = removeById( item[ recurse ], id, recurse );
                                if ( retval )
                                        return retval;
                        }
                }
                return null;
        };

        /**
         * This class is not really part of the API. It is the "definition" property value
         * passed to "dialogDefinition" event handlers.
         * @constructor
         * @name CKEDITOR.dialog.definitionObject
         * @extends CKEDITOR.dialog.definition
         * @example
         * CKEDITOR.on( 'dialogDefinition', function( evt )
         *      {
         *              var definition = evt.data.definition;
         *              var content = definition.getContents( 'page1' );
         *              ...
         *      } );
         */
        var definitionObject = function( dialog, dialogDefinition )
        {
                // TODO : Check if needed.
                this.dialog = dialog;

                // Transform the contents entries in contentObjects.
                var contents = dialogDefinition.contents;
                for ( var i = 0, content ; ( content = contents[i] ) ; i++ )
                        contents[ i ] = content && new contentObject( dialog, content );

                CKEDITOR.tools.extend( this, dialogDefinition );
        };

        definitionObject.prototype =
        /** @lends CKEDITOR.dialog.definitionObject.prototype */
        {
                /**
                 * Gets a content definition.
                 * @param {String} id The id of the content definition.
                 * @returns {CKEDITOR.dialog.definition.content} The content definition
                 *              matching id.
                 */
                getContents : function( id )
                {
                        return getById( this.contents, id );
                },

                /**
                 * Gets a button definition.
                 * @param {String} id The id of the button definition.
                 * @returns {CKEDITOR.dialog.definition.button} The button definition
                 *              matching id.
                 */
                getButton : function( id )
                {
                        return getById( this.buttons, id );
                },

                /**
                 * Adds a content definition object under this dialog definition.
                 * @param {CKEDITOR.dialog.definition.content} contentDefinition The
                 *              content definition.
                 * @param {String} [nextSiblingId] The id of an existing content
                 *              definition which the new content definition will be inserted
                 *              before. Omit if the new content definition is to be inserted as
                 *              the last item.
                 * @returns {CKEDITOR.dialog.definition.content} The inserted content
                 *              definition.
                 */
                addContents : function( contentDefinition, nextSiblingId )
                {
                        return addById( this.contents, contentDefinition, nextSiblingId );
                },

                /**
                 * Adds a button definition object under this dialog definition.
                 * @param {CKEDITOR.dialog.definition.button} buttonDefinition The
                 *              button definition.
                 * @param {String} [nextSiblingId] The id of an existing button
                 *              definition which the new button definition will be inserted
                 *              before. Omit if the new button definition is to be inserted as
                 *              the last item.
                 * @returns {CKEDITOR.dialog.definition.button} The inserted button
                 *              definition.
                 */
                addButton : function( buttonDefinition, nextSiblingId )
                {
                        return addById( this.buttons, buttonDefinition, nextSiblingId );
                },

                /**
                 * Removes a content definition from this dialog definition.
                 * @param {String} id The id of the content definition to be removed.
                 * @returns {CKEDITOR.dialog.definition.content} The removed content
                 *              definition.
                 */
                removeContents : function( id )
                {
                        removeById( this.contents, id );
                },

                /**
                 * Removes a button definition from the dialog definition.
                 * @param {String} id The id of the button definition to be removed.
                 * @returns {CKEDITOR.dialog.definition.button} The removed button
                 *              definition.
                 */
                removeButton : function( id )
                {
                        removeById( this.buttons, id );
                }
        };

        /**
         * This class is not really part of the API. It is the template of the
         * objects representing content pages inside the
         * CKEDITOR.dialog.definitionObject.
         * @constructor
         * @name CKEDITOR.dialog.definition.contentObject
         * @example
         * CKEDITOR.on( 'dialogDefinition', function( evt )
         *      {
         *              var definition = evt.data.definition;
         *              var content = definition.getContents( 'page1' );
         *              content.remove( 'textInput1' );
         *              ...
         *      } );
         */
        function contentObject( dialog, contentDefinition )
        {
                this._ =
                {
                        dialog : dialog
                };

                CKEDITOR.tools.extend( this, contentDefinition );
        }

        contentObject.prototype =
        /** @lends CKEDITOR.dialog.definition.contentObject.prototype */
        {
                /**
                 * Gets a UI element definition under the content definition.
                 * @param {String} id The id of the UI element definition.
                 * @returns {CKEDITOR.dialog.definition.uiElement}
                 */
                get : function( id )
                {
                        return getById( this.elements, id, 'children' );
                },

                /**
                 * Adds a UI element definition to the content definition.
                 * @param {CKEDITOR.dialog.definition.uiElement} elementDefinition The
                 *              UI elemnet definition to be added.
                 * @param {String} nextSiblingId The id of an existing UI element
                 *              definition which the new UI element definition will be inserted
                 *              before. Omit if the new button definition is to be inserted as
                 *              the last item.
                 * @returns {CKEDITOR.dialog.definition.uiElement} The element
                 *              definition inserted.
                 */
                add : function( elementDefinition, nextSiblingId )
                {
                        return addById( this.elements, elementDefinition, nextSiblingId, 'children' );
                },

                /**
                 * Removes a UI element definition from the content definition.
                 * @param {String} id The id of the UI element definition to be
                 *              removed.
                 * @returns {CKEDITOR.dialog.definition.uiElement} The element
                 *              definition removed.
                 * @example
                 */
                remove : function( id )
                {
                        removeById( this.elements, id, 'children' );
                }
        };

        function initDragAndDrop( dialog )
        {
                var lastCoords = null,
                        abstractDialogCoords = null,
                        element = dialog.getElement().getFirst(),
                        editor = dialog.getParentEditor(),
                        magnetDistance = editor.config.dialog_magnetDistance,
                        margins = editor.skin.margins || [ 0, 0, 0, 0 ];

                if ( typeof magnetDistance == 'undefined' )
                        magnetDistance = 20;

                function mouseMoveHandler( evt )
                {
                        var dialogSize = dialog.getSize(),
                                viewPaneSize = CKEDITOR.document.getWindow().getViewPaneSize(),
                                x = evt.data.$.screenX,
                                y = evt.data.$.screenY,
                                dx = x - lastCoords.x,
                                dy = y - lastCoords.y,
                                realX, realY;

                        lastCoords = { x : x, y : y };
                        abstractDialogCoords.x += dx;
                        abstractDialogCoords.y += dy;

                        if ( abstractDialogCoords.x + margins[3] < magnetDistance )
                                realX = - margins[3];
                        else if ( abstractDialogCoords.x - margins[1] > viewPaneSize.width - dialogSize.width - magnetDistance )
                                realX = viewPaneSize.width - dialogSize.width + ( editor.lang.dir == 'rtl' ? 0 : margins[1] );
                        else
                                realX = abstractDialogCoords.x;

                        if ( abstractDialogCoords.y + margins[0] < magnetDistance )
                                realY = - margins[0];
                        else if ( abstractDialogCoords.y - margins[2] > viewPaneSize.height - dialogSize.height - magnetDistance )
                                realY = viewPaneSize.height - dialogSize.height + margins[2];
                        else
                                realY = abstractDialogCoords.y;

                        dialog.move( realX, realY, 1 );

                        evt.data.preventDefault();
                }

                function mouseUpHandler( evt )
                {
                        CKEDITOR.document.removeListener( 'mousemove', mouseMoveHandler );
                        CKEDITOR.document.removeListener( 'mouseup', mouseUpHandler );

                        if ( CKEDITOR.env.ie6Compat )
                        {
                                var coverDoc = currentCover.getChild( 0 ).getFrameDocument();
                                coverDoc.removeListener( 'mousemove', mouseMoveHandler );
                                coverDoc.removeListener( 'mouseup', mouseUpHandler );
                        }
                }

                dialog.parts.title.on( 'mousedown', function( evt )
                        {
                                lastCoords = { x : evt.data.$.screenX, y : evt.data.$.screenY };

                                CKEDITOR.document.on( 'mousemove', mouseMoveHandler );
                                CKEDITOR.document.on( 'mouseup', mouseUpHandler );
                                abstractDialogCoords = dialog.getPosition();

                                if ( CKEDITOR.env.ie6Compat )
                                {
                                        var coverDoc = currentCover.getChild( 0 ).getFrameDocument();
                                        coverDoc.on( 'mousemove', mouseMoveHandler );
                                        coverDoc.on( 'mouseup', mouseUpHandler );
                                }

                                evt.data.preventDefault();
                        }, dialog );
        }

        function initResizeHandles( dialog )
        {
                var def = dialog.definition,
                        resizable = def.resizable;

                if ( resizable == CKEDITOR.DIALOG_RESIZE_NONE )
                        return;

                var editor = dialog.getParentEditor();
                var wrapperWidth, wrapperHeight,
                                viewSize, origin, startSize,
                                dialogCover;

                var mouseDownFn = CKEDITOR.tools.addFunction( function( $event )
                {
                        startSize = dialog.getSize();

                        var content = dialog.parts.contents,
                                iframeDialog = content.$.getElementsByTagName( 'iframe' ).length;

                        // Shim to help capturing "mousemove" over iframe.
                        if ( iframeDialog )
                        {
                                dialogCover = CKEDITOR.dom.element.createFromHtml( '<div class="cke_dialog_resize_cover" style="height: 100%; position: absolute; width: 100%;"></div>' );
                                content.append( dialogCover );
                        }

                        // Calculate the offset between content and chrome size.
                        wrapperHeight = startSize.height - dialog.parts.contents.getSize( 'height',  ! ( CKEDITOR.env.gecko || CKEDITOR.env.opera || CKEDITOR.env.ie && CKEDITOR.env.quirks ) );
                        wrapperWidth = startSize.width - dialog.parts.contents.getSize( 'width', 1 );

                        origin = { x : $event.screenX, y : $event.screenY };

                        viewSize = CKEDITOR.document.getWindow().getViewPaneSize();

                        CKEDITOR.document.on( 'mousemove', mouseMoveHandler );
                        CKEDITOR.document.on( 'mouseup', mouseUpHandler );

                        if ( CKEDITOR.env.ie6Compat )
                        {
                                var coverDoc = currentCover.getChild( 0 ).getFrameDocument();
                                coverDoc.on( 'mousemove', mouseMoveHandler );
                                coverDoc.on( 'mouseup', mouseUpHandler );
                        }

                        $event.preventDefault && $event.preventDefault();
                });

                // Prepend the grip to the dialog.
                dialog.on( 'load', function()
                {
                        var direction = '';
                        if ( resizable == CKEDITOR.DIALOG_RESIZE_WIDTH )
                                direction = ' cke_resizer_horizontal';
                        else if ( resizable == CKEDITOR.DIALOG_RESIZE_HEIGHT )
                                direction = ' cke_resizer_vertical';
                        var resizer = CKEDITOR.dom.element.createFromHtml( '<div' +
                                        ' class="cke_resizer' + direction + ' cke_resizer_' + editor.lang.dir + '"' +
                                        ' title="' + CKEDITOR.tools.htmlEncode( editor.lang.resize ) + '"' +
                                        ' onmousedown="CKEDITOR.tools.callFunction(' + mouseDownFn + ', event )"></div>' );
                        dialog.parts.footer.append( resizer, 1 );
                });
                editor.on( 'destroy', function() { CKEDITOR.tools.removeFunction( mouseDownFn ); } );

                function mouseMoveHandler( evt )
                {
                        var rtl = editor.lang.dir == 'rtl',
                                dx = ( evt.data.$.screenX - origin.x ) * ( rtl ? -1 : 1 ),
                                dy = evt.data.$.screenY - origin.y,
                                width = startSize.width,
                                height = startSize.height,
                                internalWidth = width + dx * ( dialog._.moved ? 1 : 2 ),
                                internalHeight = height + dy * ( dialog._.moved ? 1 : 2 ),
                                element = dialog._.element.getFirst(),
                                right = rtl && element.getComputedStyle( 'right' ),
                                position = dialog.getPosition();

                        if ( position.y + internalHeight > viewSize.height )
                                internalHeight = viewSize.height - position.y;

                        if ( ( rtl ? right : position.x ) + internalWidth > viewSize.width )
                                internalWidth = viewSize.width - ( rtl ? right : position.x );

                        // Make sure the dialog will not be resized to the wrong side when it's in the leftmost position for RTL.
                        if ( ( resizable == CKEDITOR.DIALOG_RESIZE_WIDTH || resizable == CKEDITOR.DIALOG_RESIZE_BOTH ) )
                                width = Math.max( def.minWidth || 0, internalWidth - wrapperWidth );

                        if ( resizable == CKEDITOR.DIALOG_RESIZE_HEIGHT || resizable == CKEDITOR.DIALOG_RESIZE_BOTH )
                                height = Math.max( def.minHeight || 0, internalHeight - wrapperHeight );

                        dialog.resize( width, height );

                        if ( !dialog._.moved )
                                dialog.layout();

                        evt.data.preventDefault();
                }

                function mouseUpHandler()
                {
                        CKEDITOR.document.removeListener( 'mouseup', mouseUpHandler );
                        CKEDITOR.document.removeListener( 'mousemove', mouseMoveHandler );

                        if ( dialogCover )
                        {
                                dialogCover.remove();
                                dialogCover = null;
                        }

                        if ( CKEDITOR.env.ie6Compat )
                        {
                                var coverDoc = currentCover.getChild( 0 ).getFrameDocument();
                                coverDoc.removeListener( 'mouseup', mouseUpHandler );
                                coverDoc.removeListener( 'mousemove', mouseMoveHandler );
                        }
                }
        }

        var resizeCover;
        // Caching resuable covers and allowing only one cover
        // on screen.
        var covers = {},
                currentCover;

        function cancelEvent( ev )
        {
                ev.data.preventDefault(1);
        }

        function showCover( editor )
        {
                var win = CKEDITOR.document.getWindow();
                var config = editor.config,
                        backgroundColorStyle = config.dialog_backgroundCoverColor || 'white',
                        backgroundCoverOpacity = config.dialog_backgroundCoverOpacity,
                        baseFloatZIndex = config.baseFloatZIndex,
                        coverKey = CKEDITOR.tools.genKey(
                                        backgroundColorStyle,
                                        backgroundCoverOpacity,
                                        baseFloatZIndex ),
                        coverElement = covers[ coverKey ];

                if ( !coverElement )
                {
                        var html = [
                                        '<div tabIndex="-1" style="position: ', ( CKEDITOR.env.ie6Compat ? 'absolute' : 'fixed' ),
                                        '; z-index: ', baseFloatZIndex,
                                        '; top: 0px; left: 0px; ',
                                        ( !CKEDITOR.env.ie6Compat ? 'background-color: ' + backgroundColorStyle : '' ),
                                        '" class="cke_dialog_background_cover">'
                                ];

                        if ( CKEDITOR.env.ie6Compat )
                        {
                                // Support for custom document.domain in IE.
                                var isCustomDomain = CKEDITOR.env.isCustomDomain(),
                                        iframeHtml = '<html><body style=\\\'background-color:' + backgroundColorStyle + ';\\\'></body></html>';

                                html.push(
                                        '<iframe' +
                                                ' hidefocus="true"' +
                                                ' frameborder="0"' +
                                                ' id="cke_dialog_background_iframe"' +
                                                ' src="javascript:' );

                                html.push( 'void((function(){' +
                                                                'document.open();' +
                                                                ( isCustomDomain ? 'document.domain=\'' + document.domain + '\';' : '' ) +
                                                                'document.write( \'' + iframeHtml + '\' );' +
                                                                'document.close();' +
                                                        '})())' );

                                html.push(
                                                '"' +
                                                ' style="' +
                                                        'position:absolute;' +
                                                        'left:0;' +
                                                        'top:0;' +
                                                        'width:100%;' +
                                                        'height: 100%;' +
                                                        'progid:DXImageTransform.Microsoft.Alpha(opacity=0)">' +
                                        '</iframe>' );
                        }

                        html.push( '</div>' );

                        coverElement = CKEDITOR.dom.element.createFromHtml( html.join( '' ) );
                        coverElement.setOpacity( backgroundCoverOpacity != undefined ? backgroundCoverOpacity : 0.5 );

                        coverElement.on( 'keydown', cancelEvent );
                        coverElement.on( 'keypress', cancelEvent );
                        coverElement.on( 'keyup', cancelEvent );

                        coverElement.appendTo( CKEDITOR.document.getBody() );
                        covers[ coverKey ] = coverElement;
                }
                else
                        coverElement.   show();

                currentCover = coverElement;
                var resizeFunc = function()
                {
                        var size = win.getViewPaneSize();
                        coverElement.setStyles(
                                {
                                        width : size.width + 'px',
                                        height : size.height + 'px'
                                } );
                };

                var scrollFunc = function()
                {
                        var pos = win.getScrollPosition(),
                                cursor = CKEDITOR.dialog._.currentTop;
                        coverElement.setStyles(
                                        {
                                                left : pos.x + 'px',
                                                top : pos.y + 'px'
                                        });

                        if ( cursor )
                        {
                                do
                                {
                                        var dialogPos = cursor.getPosition();
                                        cursor.move( dialogPos.x, dialogPos.y );
                                } while ( ( cursor = cursor._.parentDialog ) );
                        }
                };

                resizeCover = resizeFunc;
                win.on( 'resize', resizeFunc );
                resizeFunc();
                // Using Safari/Mac, focus must be kept where it is (#7027)
                if ( !( CKEDITOR.env.mac && CKEDITOR.env.webkit ) )
                        coverElement.focus();

                if ( CKEDITOR.env.ie6Compat )
                {
                        // IE BUG: win.$.onscroll assignment doesn't work.. it must be window.onscroll.
                        // So we need to invent a really funny way to make it work.
                        var myScrollHandler = function()
                                {
                                        scrollFunc();
                                        arguments.callee.prevScrollHandler.apply( this, arguments );
                                };
                        win.$.setTimeout( function()
                                {
                                        myScrollHandler.prevScrollHandler = window.onscroll || function(){};
                                        window.onscroll = myScrollHandler;
                                }, 0 );
                        scrollFunc();
                }
        }

        function hideCover()
        {
                if ( !currentCover )
                        return;

                var win = CKEDITOR.document.getWindow();
                currentCover.hide();
                win.removeListener( 'resize', resizeCover );

                if ( CKEDITOR.env.ie6Compat )
                {
                        win.$.setTimeout( function()
                                {
                                        var prevScrollHandler = window.onscroll && window.onscroll.prevScrollHandler;
                                        window.onscroll = prevScrollHandler || null;
                                }, 0 );
                }
                resizeCover = null;
        }

        function removeCovers()
        {
                for ( var coverId in covers )
                        covers[ coverId ].remove();
                covers = {};
        }

        var accessKeyProcessors = {};

        var accessKeyDownHandler = function( evt )
        {
                var ctrl = evt.data.$.ctrlKey || evt.data.$.metaKey,
                        alt = evt.data.$.altKey,
                        shift = evt.data.$.shiftKey,
                        key = String.fromCharCode( evt.data.$.keyCode ),
                        keyProcessor = accessKeyProcessors[( ctrl ? 'CTRL+' : '' ) + ( alt ? 'ALT+' : '') + ( shift ? 'SHIFT+' : '' ) + key];

                if ( !keyProcessor || !keyProcessor.length )
                        return;

                keyProcessor = keyProcessor[keyProcessor.length - 1];
                keyProcessor.keydown && keyProcessor.keydown.call( keyProcessor.uiElement, keyProcessor.dialog, keyProcessor.key );
                evt.data.preventDefault();
        };

        var accessKeyUpHandler = function( evt )
        {
                var ctrl = evt.data.$.ctrlKey || evt.data.$.metaKey,
                        alt = evt.data.$.altKey,
                        shift = evt.data.$.shiftKey,
                        key = String.fromCharCode( evt.data.$.keyCode ),
                        keyProcessor = accessKeyProcessors[( ctrl ? 'CTRL+' : '' ) + ( alt ? 'ALT+' : '') + ( shift ? 'SHIFT+' : '' ) + key];

                if ( !keyProcessor || !keyProcessor.length )
                        return;

                keyProcessor = keyProcessor[keyProcessor.length - 1];
                if ( keyProcessor.keyup )
                {
                        keyProcessor.keyup.call( keyProcessor.uiElement, keyProcessor.dialog, keyProcessor.key );
                        evt.data.preventDefault();
                }
        };

        var registerAccessKey = function( uiElement, dialog, key, downFunc, upFunc )
        {
                var procList = accessKeyProcessors[key] || ( accessKeyProcessors[key] = [] );
                procList.push( {
                                uiElement : uiElement,
                                dialog : dialog,
                                key : key,
                                keyup : upFunc || uiElement.accessKeyUp,
                                keydown : downFunc || uiElement.accessKeyDown
                        } );
        };

        var unregisterAccessKey = function( obj )
        {
                for ( var i in accessKeyProcessors )
                {
                        var list = accessKeyProcessors[i];
                        for ( var j = list.length - 1 ; j >= 0 ; j-- )
                        {
                                if ( list[j].dialog == obj || list[j].uiElement == obj )
                                        list.splice( j, 1 );
                        }
                        if ( list.length === 0 )
                                delete accessKeyProcessors[i];
                }
        };

        var tabAccessKeyUp = function( dialog, key )
        {
                if ( dialog._.accessKeyMap[key] )
                        dialog.selectPage( dialog._.accessKeyMap[key] );
        };

        var tabAccessKeyDown = function( dialog, key )
        {
        };

        // ESC, ENTER
        var preventKeyBubblingKeys = { 27 :1, 13 :1 };
        var preventKeyBubbling = function( e )
        {
                if ( e.data.getKeystroke() in preventKeyBubblingKeys )
                        e.data.stopPropagation();
        };

        (function()
        {
                CKEDITOR.ui.dialog =
                {
                        /**
                         * The base class of all dialog UI elements.
                         * @constructor
                         * @param {CKEDITOR.dialog} dialog Parent dialog object.
                         * @param {CKEDITOR.dialog.definition.uiElement} elementDefinition Element
                         * definition. Accepted fields:
                         * <ul>
                         *      <li><strong>id</strong> (Required) The id of the UI element. See {@link
                         *      CKEDITOR.dialog#getContentElement}</li>
                         *      <li><strong>type</strong> (Required) The type of the UI element. The
                         *      value to this field specifies which UI element class will be used to
                         *      generate the final widget.</li>
                         *      <li><strong>title</strong> (Optional) The popup tooltip for the UI
                         *      element.</li>
                         *      <li><strong>hidden</strong> (Optional) A flag that tells if the element
                         *      should be initially visible.</li>
                         *      <li><strong>className</strong> (Optional) Additional CSS class names
                         *      to add to the UI element. Separated by space.</li>
                         *      <li><strong>style</strong> (Optional) Additional CSS inline styles
                         *      to add to the UI element. A semicolon (;) is required after the last
                         *      style declaration.</li>
                         *      <li><strong>accessKey</strong> (Optional) The alphanumeric access key
                         *      for this element. Access keys are automatically prefixed by CTRL.</li>
                         *      <li><strong>on*</strong> (Optional) Any UI element definition field that
                         *      starts with <em>on</em> followed immediately by a capital letter and
                         *      probably more letters is an event handler. Event handlers may be further
                         *      divided into registered event handlers and DOM event handlers. Please
                         *      refer to {@link CKEDITOR.ui.dialog.uiElement#registerEvents} and
                         *      {@link CKEDITOR.ui.dialog.uiElement#eventProcessors} for more
                         *      information.</li>
                         * </ul>
                         * @param {Array} htmlList
                         * List of HTML code to be added to the dialog's content area.
                         * @param {Function|String} nodeNameArg
                         * A function returning a string, or a simple string for the node name for
                         * the root DOM node. Default is 'div'.
                         * @param {Function|Object} stylesArg
                         * A function returning an object, or a simple object for CSS styles applied
                         * to the DOM node. Default is empty object.
                         * @param {Function|Object} attributesArg
                         * A fucntion returning an object, or a simple object for attributes applied
                         * to the DOM node. Default is empty object.
                         * @param {Function|String} contentsArg
                         * A function returning a string, or a simple string for the HTML code inside
                         * the root DOM node. Default is empty string.
                         * @example
                         */
                        uiElement : function( dialog, elementDefinition, htmlList, nodeNameArg, stylesArg, attributesArg, contentsArg )
                        {
                                if ( arguments.length < 4 )
                                        return;

                                var nodeName = ( nodeNameArg.call ? nodeNameArg( elementDefinition ) : nodeNameArg ) || 'div',
                                        html = [ '<', nodeName, ' ' ],
                                        styles = ( stylesArg && stylesArg.call ? stylesArg( elementDefinition ) : stylesArg ) || {},
                                        attributes = ( attributesArg && attributesArg.call ? attributesArg( elementDefinition ) : attributesArg ) || {},
                                        innerHTML = ( contentsArg && contentsArg.call ? contentsArg.call( this, dialog, elementDefinition ) : contentsArg ) || '',
                                        domId = this.domId = attributes.id || CKEDITOR.tools.getNextId() + '_uiElement',
                                        id = this.id = elementDefinition.id,
                                        i;

                                // Set the id, a unique id is required for getElement() to work.
                                attributes.id = domId;

                                // Set the type and definition CSS class names.
                                var classes = {};
                                if ( elementDefinition.type )
                                        classes[ 'cke_dialog_ui_' + elementDefinition.type ] = 1;
                                if ( elementDefinition.className )
                                        classes[ elementDefinition.className ] = 1;
                                if ( elementDefinition.disabled )
                                        classes[ 'cke_disabled' ] = 1;

                                var attributeClasses = ( attributes['class'] && attributes['class'].split ) ? attributes['class'].split( ' ' ) : [];
                                for ( i = 0 ; i < attributeClasses.length ; i++ )
                                {
                                        if ( attributeClasses[i] )
                                                classes[ attributeClasses[i] ] = 1;
                                }
                                var finalClasses = [];
                                for ( i in classes )
                                        finalClasses.push( i );
                                attributes['class'] = finalClasses.join( ' ' );

                                // Set the popup tooltop.
                                if ( elementDefinition.title )
                                        attributes.title = elementDefinition.title;

                                // Write the inline CSS styles.
                                var styleStr = ( elementDefinition.style || '' ).split( ';' );

                                // Element alignment support.
                                if ( elementDefinition.align )
                                {
                                        var align = elementDefinition.align;
                                        styles[ 'margin-left' ] = align == 'left' ? 0 : 'auto';
                                        styles[ 'margin-right' ] = align == 'right' ? 0 : 'auto';
                                }

                                for ( i in styles )
                                        styleStr.push( i + ':' + styles[i] );
                                if ( elementDefinition.hidden )
                                        styleStr.push( 'display:none' );
                                for ( i = styleStr.length - 1 ; i >= 0 ; i-- )
                                {
                                        if ( styleStr[i] === '' )
                                                styleStr.splice( i, 1 );
                                }
                                if ( styleStr.length > 0 )
                                        attributes.style = ( attributes.style ? ( attributes.style + '; ' ) : '' ) + styleStr.join( '; ' );

                                // Write the attributes.
                                for ( i in attributes )
                                        html.push( i + '="' + CKEDITOR.tools.htmlEncode( attributes[i] ) + '" ');

                                // Write the content HTML.
                                html.push( '>', innerHTML, '</', nodeName, '>' );

                                // Add contents to the parent HTML array.
                                htmlList.push( html.join( '' ) );

                                ( this._ || ( this._ = {} ) ).dialog = dialog;

                                // Override isChanged if it is defined in element definition.
                                if ( typeof( elementDefinition.isChanged ) == 'boolean' )
                                        this.isChanged = function(){ return elementDefinition.isChanged; };
                                if ( typeof( elementDefinition.isChanged ) == 'function' )
                                        this.isChanged = elementDefinition.isChanged;

                                // Overload 'get(set)Value' on definition.
                                if ( typeof( elementDefinition.setValue ) == 'function' )
                                {
                                                this.setValue = CKEDITOR.tools.override( this.setValue, function( org )
                                                {
                                                                return function( val ){ org.call( this, elementDefinition.setValue.call( this, val ) ); };
                                                } );
                                }

                                if ( typeof( elementDefinition.getValue ) == 'function' )
                                {
                                                this.getValue = CKEDITOR.tools.override( this.getValue, function( org )
                                                {
                                                                return function(){ return  elementDefinition.getValue.call( this, org.call( this ) ); };
                                                } );
                                }

                                // Add events.
                                CKEDITOR.event.implementOn( this );

                                this.registerEvents( elementDefinition );
                                if ( this.accessKeyUp && this.accessKeyDown && elementDefinition.accessKey )
                                        registerAccessKey( this, dialog, 'CTRL+' + elementDefinition.accessKey );

                                var me = this;
                                dialog.on( 'load', function()
                                        {
                                                if ( me.getInputElement() )
                                                {
                                                        me.getInputElement().on( 'focus', function()
                                                                {
                                                                        dialog._.tabBarMode = false;
                                                                        dialog._.hasFocus = true;
                                                                        me.fire( 'focus' );
                                                                }, me );
                                                }
                                        } );

                                // Register the object as a tab focus if it can be included.
                                if ( this.keyboardFocusable )
                                {
                                        this.tabIndex = elementDefinition.tabIndex || 0;

                                        this.focusIndex = dialog._.focusList.push( this ) - 1;
                                        this.on( 'focus', function()
                                                {
                                                        dialog._.currentFocusIndex = me.focusIndex;
                                                } );
                                }

                                // Completes this object with everything we have in the
                                // definition.
                                CKEDITOR.tools.extend( this, elementDefinition );
                        },

                        /**
                         * Horizontal layout box for dialog UI elements, auto-expends to available width of container.
                         * @constructor
                         * @extends CKEDITOR.ui.dialog.uiElement
                         * @param {CKEDITOR.dialog} dialog
                         * Parent dialog object.
                         * @param {Array} childObjList
                         * Array of {@link CKEDITOR.ui.dialog.uiElement} objects inside this
                         * container.
                         * @param {Array} childHtmlList
                         * Array of HTML code that correspond to the HTML output of all the
                         * objects in childObjList.
                         * @param {Array} htmlList
                         * Array of HTML code that this element will output to.
                         * @param {CKEDITOR.dialog.definition.uiElement} elementDefinition
                         * The element definition. Accepted fields:
                         * <ul>
                         *      <li><strong>widths</strong> (Optional) The widths of child cells.</li>
                         *      <li><strong>height</strong> (Optional) The height of the layout.</li>
                         *      <li><strong>padding</strong> (Optional) The padding width inside child
                         *       cells.</li>
                         *      <li><strong>align</strong> (Optional) The alignment of the whole layout
                         *      </li>
                         * </ul>
                         * @example
                         */
                        hbox : function( dialog, childObjList, childHtmlList, htmlList, elementDefinition )
                        {
                                if ( arguments.length < 4 )
                                        return;

                                this._ || ( this._ = {} );

                                var children = this._.children = childObjList,
                                        widths = elementDefinition && elementDefinition.widths || null,
                                        height = elementDefinition && elementDefinition.height || null,
                                        styles = {},
                                        i;
                                /** @ignore */
                                var innerHTML = function()
                                {
                                        var html = [ '<tbody><tr class="cke_dialog_ui_hbox">' ];
                                        for ( i = 0 ; i < childHtmlList.length ; i++ )
                                        {
                                                var className = 'cke_dialog_ui_hbox_child',
                                                        styles = [];
                                                if ( i === 0 )
                                                        className = 'cke_dialog_ui_hbox_first';
                                                if ( i == childHtmlList.length - 1 )
                                                        className = 'cke_dialog_ui_hbox_last';
                                                html.push( '<td class="', className, '" role="presentation" ' );
                                                if ( widths )
                                                {
                                                        if ( widths[i] )
                                                                styles.push( 'width:' + cssLength( widths[i] ) );
                                                }
                                                else
                                                        styles.push( 'width:' + Math.floor( 100 / childHtmlList.length ) + '%' );
                                                if ( height )
                                                        styles.push( 'height:' + cssLength( height ) );
                                                if ( elementDefinition && elementDefinition.padding != undefined )
                                                        styles.push( 'padding:' + cssLength( elementDefinition.padding ) );
                                                // In IE Quirks alignment has to be done on table cells. (#7324)
                                                if ( CKEDITOR.env.ie && CKEDITOR.env.quirks && children[ i ].align )
                                                        styles.push( 'text-align:' + children[ i ].align );
                                                if ( styles.length > 0 )
                                                        html.push( 'style="' + styles.join('; ') + '" ' );
                                                html.push( '>', childHtmlList[i], '</td>' );
                                        }
                                        html.push( '</tr></tbody>' );
                                        return html.join( '' );
                                };

                                var attribs = { role : 'presentation' };
                                elementDefinition && elementDefinition.align && ( attribs.align = elementDefinition.align );

                                CKEDITOR.ui.dialog.uiElement.call(
                                        this,
                                        dialog,
                                        elementDefinition || { type : 'hbox' },
                                        htmlList,
                                        'table',
                                        styles,
                                        attribs,
                                        innerHTML );
                        },

                        /**
                         * Vertical layout box for dialog UI elements.
                         * @constructor
                         * @extends CKEDITOR.ui.dialog.hbox
                         * @param {CKEDITOR.dialog} dialog
                         * Parent dialog object.
                         * @param {Array} childObjList
                         * Array of {@link CKEDITOR.ui.dialog.uiElement} objects inside this
                         * container.
                         * @param {Array} childHtmlList
                         * Array of HTML code that correspond to the HTML output of all the
                         * objects in childObjList.
                         * @param {Array} htmlList
                         * Array of HTML code that this element will output to.
                         * @param {CKEDITOR.dialog.definition.uiElement} elementDefinition
                         * The element definition. Accepted fields:
                         * <ul>
                         *      <li><strong>width</strong> (Optional) The width of the layout.</li>
                         *      <li><strong>heights</strong> (Optional) The heights of individual cells.
                         *      </li>
                         *      <li><strong>align</strong> (Optional) The alignment of the layout.</li>
                         *      <li><strong>padding</strong> (Optional) The padding width inside child
                         *      cells.</li>
                         *      <li><strong>expand</strong> (Optional) Whether the layout should expand
                         *      vertically to fill its container.</li>
                         * </ul>
                         * @example
                         */
                        vbox : function( dialog, childObjList, childHtmlList, htmlList, elementDefinition )
                        {
                                if ( arguments.length < 3 )
                                        return;

                                this._ || ( this._ = {} );

                                var children = this._.children = childObjList,
                                        width = elementDefinition && elementDefinition.width || null,
                                        heights = elementDefinition && elementDefinition.heights || null;
                                /** @ignore */
                                var innerHTML = function()
                                {
                                        var html = [ '<table role="presentation" cellspacing="0" border="0" ' ];
                                        html.push( 'style="' );
                                        if ( elementDefinition && elementDefinition.expand )
                                                html.push( 'height:100%;' );
                                        html.push( 'width:' + cssLength( width || '100%' ), ';' );
                                        html.push( '"' );
                                        html.push( 'align="', CKEDITOR.tools.htmlEncode(
                                                ( elementDefinition && elementDefinition.align ) || ( dialog.getParentEditor().lang.dir == 'ltr' ? 'left' : 'right' ) ), '" ' );

                                        html.push( '><tbody>' );
                                        for ( var i = 0 ; i < childHtmlList.length ; i++ )
                                        {
                                                var styles = [];
                                                html.push( '<tr><td role="presentation" ' );
                                                if ( width )
                                                        styles.push( 'width:' + cssLength( width || '100%' ) );
                                                if ( heights )
                                                        styles.push( 'height:' + cssLength( heights[i] ) );
                                                else if ( elementDefinition && elementDefinition.expand )
                                                        styles.push( 'height:' + Math.floor( 100 / childHtmlList.length ) + '%' );
                                                if ( elementDefinition && elementDefinition.padding != undefined )
                                                        styles.push( 'padding:' + cssLength( elementDefinition.padding ) );
                                                // In IE Quirks alignment has to be done on table cells. (#7324)
                                                if ( CKEDITOR.env.ie && CKEDITOR.env.quirks && children[ i ].align )
                                                        styles.push( 'text-align:' + children[ i ].align );
                                                if ( styles.length > 0 )
                                                        html.push( 'style="', styles.join( '; ' ), '" ' );
                                                html.push( ' class="cke_dialog_ui_vbox_child">', childHtmlList[i], '</td></tr>' );
                                        }
                                        html.push( '</tbody></table>' );
                                        return html.join( '' );
                                };
                                CKEDITOR.ui.dialog.uiElement.call( this, dialog, elementDefinition || { type : 'vbox' }, htmlList, 'div', null, { role : 'presentation' }, innerHTML );
                        }
                };
        })();

        CKEDITOR.ui.dialog.uiElement.prototype =
        {
                /**
                 * Gets the root DOM element of this dialog UI object.
                 * @returns {CKEDITOR.dom.element} Root DOM element of UI object.
                 * @example
                 * uiElement.getElement().hide();
                 */
                getElement : function()
                {
                        return CKEDITOR.document.getById( this.domId );
                },

                /**
                 * Gets the DOM element that the user inputs values.
                 * This function is used by setValue(), getValue() and focus(). It should
                 * be overrided in child classes where the input element isn't the root
                 * element.
                 * @returns {CKEDITOR.dom.element} The element where the user input values.
                 * @example
                 * var rawValue = textInput.getInputElement().$.value;
                 */
                getInputElement : function()
                {
                        return this.getElement();
                },

                /**
                 * Gets the parent dialog object containing this UI element.
                 * @returns {CKEDITOR.dialog} Parent dialog object.
                 * @example
                 * var dialog = uiElement.getDialog();
                 */
                getDialog : function()
                {
                        return this._.dialog;
                },

                /**
                 * Sets the value of this dialog UI object.
                 * @param {Object} value The new value.
                 * @param {Boolean} noChangeEvent Internal commit, to supress 'change' event on this element.
                 * @returns {CKEDITOR.dialog.uiElement} The current UI element.
                 * @example
                 * uiElement.setValue( 'Dingo' );
                 */
                setValue : function( value, noChangeEvent )
                {
                        this.getInputElement().setValue( value );
                        !noChangeEvent && this.fire( 'change', { value : value } );
                        return this;
                },

                /**
                 * Gets the current value of this dialog UI object.
                 * @returns {Object} The current value.
                 * @example
                 * var myValue = uiElement.getValue();
                 */
                getValue : function()
                {
                        return this.getInputElement().getValue();
                },

                /**
                 * Tells whether the UI object's value has changed.
                 * @returns {Boolean} true if changed, false if not changed.
                 * @example
                 * if ( uiElement.isChanged() )
                 * &nbsp;&nbsp;confirm( 'Value changed! Continue?' );
                 */
                isChanged : function()
                {
                        // Override in input classes.
                        return false;
                },

                /**
                 * Selects the parent tab of this element. Usually called by focus() or overridden focus() methods.
                 * @returns {CKEDITOR.dialog.uiElement} The current UI element.
                 * @example
                 * focus : function()
                 * {
                 *              this.selectParentTab();
                 *              // do something else.
                 * }
                 */
                selectParentTab : function()
                {
                        var element = this.getInputElement(),
                                cursor = element,
                                tabId;
                        while ( ( cursor = cursor.getParent() ) && cursor.$.className.search( 'cke_dialog_page_contents' ) == -1 )
                        { /*jsl:pass*/ }

                        // Some widgets don't have parent tabs (e.g. OK and Cancel buttons).
                        if ( !cursor )
                                return this;

                        tabId = cursor.getAttribute( 'name' );
                        // Avoid duplicate select.
                        if ( this._.dialog._.currentTabId != tabId )
                                this._.dialog.selectPage( tabId );
                        return this;
                },

                /**
                 * Puts the focus to the UI object. Switches tabs if the UI object isn't in the active tab page.
                 * @returns {CKEDITOR.dialog.uiElement} The current UI element.
                 * @example
                 * uiElement.focus();
                 */
                focus : function()
                {
                        this.selectParentTab().getInputElement().focus();
                        return this;
                },

                /**
                 * Registers the on* event handlers defined in the element definition.
                 * The default behavior of this function is:
                 * <ol>
                 *  <li>
                 *      If the on* event is defined in the class's eventProcesors list,
                 *      then the registration is delegated to the corresponding function
                 *      in the eventProcessors list.
                 *  </li>
                 *  <li>
                 *      If the on* event is not defined in the eventProcessors list, then
                 *      register the event handler under the corresponding DOM event of
                 *      the UI element's input DOM element (as defined by the return value
                 *      of {@link CKEDITOR.ui.dialog.uiElement#getInputElement}).
                 *  </li>
                 * </ol>
                 * This function is only called at UI element instantiation, but can
                 * be overridded in child classes if they require more flexibility.
                 * @param {CKEDITOR.dialog.definition.uiElement} definition The UI element
                 * definition.
                 * @returns {CKEDITOR.dialog.uiElement} The current UI element.
                 * @example
                 */
                registerEvents : function( definition )
                {
                        var regex = /^on([A-Z]\w+)/,
                                match;

                        var registerDomEvent = function( uiElement, dialog, eventName, func )
                        {
                                dialog.on( 'load', function()
                                {
                                        uiElement.getInputElement().on( eventName, func, uiElement );
                                });
                        };

                        for ( var i in definition )
                        {
                                if ( !( match = i.match( regex ) ) )
                                        continue;
                                if ( this.eventProcessors[i] )
                                        this.eventProcessors[i].call( this, this._.dialog, definition[i] );
                                else
                                        registerDomEvent( this, this._.dialog, match[1].toLowerCase(), definition[i] );
                        }

                        return this;
                },

                /**
                 * The event processor list used by
                 * {@link CKEDITOR.ui.dialog.uiElement#getInputElement} at UI element
                 * instantiation. The default list defines three on* events:
                 * <ol>
                 *  <li>onLoad - Called when the element's parent dialog opens for the
                 *  first time</li>
                 *  <li>onShow - Called whenever the element's parent dialog opens.</li>
                 *  <li>onHide - Called whenever the element's parent dialog closes.</li>
                 * </ol>
                 * @field
                 * @type Object
                 * @example
                 * // This connects the 'click' event in CKEDITOR.ui.dialog.button to onClick
                 * // handlers in the UI element's definitions.
                 * CKEDITOR.ui.dialog.button.eventProcessors = CKEDITOR.tools.extend( {},
                 * &nbsp;&nbsp;CKEDITOR.ui.dialog.uiElement.prototype.eventProcessors,
                 * &nbsp;&nbsp;{ onClick : function( dialog, func ) { this.on( 'click', func ); } },
                 * &nbsp;&nbsp;true );
                 */
                eventProcessors :
                {
                        onLoad : function( dialog, func )
                        {
                                dialog.on( 'load', func, this );
                        },

                        onShow : function( dialog, func )
                        {
                                dialog.on( 'show', func, this );
                        },

                        onHide : function( dialog, func )
                        {
                                dialog.on( 'hide', func, this );
                        }
                },

                /**
                 * The default handler for a UI element's access key down event, which
                 * tries to put focus to the UI element.<br />
                 * Can be overridded in child classes for more sophisticaed behavior.
                 * @param {CKEDITOR.dialog} dialog The parent dialog object.
                 * @param {String} key The key combination pressed. Since access keys
                 * are defined to always include the CTRL key, its value should always
                 * include a 'CTRL+' prefix.
                 * @example
                 */
                accessKeyDown : function( dialog, key )
                {
                        this.focus();
                },

                /**
                 * The default handler for a UI element's access key up event, which
                 * does nothing.<br />
                 * Can be overridded in child classes for more sophisticated behavior.
                 * @param {CKEDITOR.dialog} dialog The parent dialog object.
                 * @param {String} key The key combination pressed. Since access keys
                 * are defined to always include the CTRL key, its value should always
                 * include a 'CTRL+' prefix.
                 * @example
                 */
                accessKeyUp : function( dialog, key )
                {
                },

                /**
                 * Disables a UI element.
                 * @example
                 */
                disable : function()
                {
                        var element = this.getElement(),
                                input = this.getInputElement();
                        input.setAttribute( 'disabled', 'true' );
                        element.addClass( 'cke_disabled' );
                },

                /**
                 * Enables a UI element.
                 * @example
                 */
                enable : function()
                {
                        var element = this.getElement(),
                                input = this.getInputElement();
                        input.removeAttribute( 'disabled' );
                        element.removeClass( 'cke_disabled' );
                },

                /**
                 * Determines whether an UI element is enabled or not.
                 * @returns {Boolean} Whether the UI element is enabled.
                 * @example
                 */
                isEnabled : function()
                {
                        return !this.getElement().hasClass( 'cke_disabled' );
                },

                /**
                 * Determines whether an UI element is visible or not.
                 * @returns {Boolean} Whether the UI element is visible.
                 * @example
                 */
                isVisible : function()
                {
                        return this.getInputElement().isVisible();
                },

                /**
                 * Determines whether an UI element is focus-able or not.
                 * Focus-able is defined as being both visible and enabled.
                 * @returns {Boolean} Whether the UI element can be focused.
                 * @example
                 */
                isFocusable : function()
                {
                        if ( !this.isEnabled() || !this.isVisible() )
                                return false;
                        return true;
                }
        };

        CKEDITOR.ui.dialog.hbox.prototype = CKEDITOR.tools.extend( new CKEDITOR.ui.dialog.uiElement,
                /**
                 * @lends CKEDITOR.ui.dialog.hbox.prototype
                 */
                {
                        /**
                         * Gets a child UI element inside this container.
                         * @param {Array|Number} indices An array or a single number to indicate the child's
                         * position in the container's descendant tree. Omit to get all the children in an array.
                         * @returns {Array|CKEDITOR.ui.dialog.uiElement} Array of all UI elements in the container
                         * if no argument given, or the specified UI element if indices is given.
                         * @example
                         * var checkbox = hbox.getChild( [0,1] );
                         * checkbox.setValue( true );
                         */
                        getChild : function( indices )
                        {
                                // If no arguments, return a clone of the children array.
                                if ( arguments.length < 1 )
                                        return this._.children.concat();

                                // If indices isn't array, make it one.
                                if ( !indices.splice )
                                        indices = [ indices ];

                                // Retrieve the child element according to tree position.
                                if ( indices.length < 2 )
                                        return this._.children[ indices[0] ];
                                else
                                        return ( this._.children[ indices[0] ] && this._.children[ indices[0] ].getChild ) ?
                                                this._.children[ indices[0] ].getChild( indices.slice( 1, indices.length ) ) :
                                                null;
                        }
                }, true );

        CKEDITOR.ui.dialog.vbox.prototype = new CKEDITOR.ui.dialog.hbox();



        (function()
        {
                var commonBuilder = {
                        build : function( dialog, elementDefinition, output )
                        {
                                var children = elementDefinition.children,
                                        child,
                                        childHtmlList = [],
                                        childObjList = [];
                                for ( var i = 0 ; ( i < children.length && ( child = children[i] ) ) ; i++ )
                                {
                                        var childHtml = [];
                                        childHtmlList.push( childHtml );
                                        childObjList.push( CKEDITOR.dialog._.uiElementBuilders[ child.type ].build( dialog, child, childHtml ) );
                                }
                                return new CKEDITOR.ui.dialog[elementDefinition.type]( dialog, childObjList, childHtmlList, output, elementDefinition );
                        }
                };

                CKEDITOR.dialog.addUIElement( 'hbox', commonBuilder );
                CKEDITOR.dialog.addUIElement( 'vbox', commonBuilder );
        })();

        /**
         * Generic dialog command. It opens a specific dialog when executed.
         * @constructor
         * @augments CKEDITOR.commandDefinition
         * @param {string} dialogName The name of the dialog to open when executing
         *              this command.
         * @example
         * // Register the "link" command, which opens the "link" dialog.
         * editor.addCommand( 'link', <b>new CKEDITOR.dialogCommand( 'link' )</b> );
         */
        CKEDITOR.dialogCommand = function( dialogName )
        {
                this.dialogName = dialogName;
        };

        CKEDITOR.dialogCommand.prototype =
        {
                /** @ignore */
                exec : function( editor )
                {
                        editor.openDialog( this.dialogName );
                },

                // Dialog commands just open a dialog ui, thus require no undo logic,
                // undo support should dedicate to specific dialog implementation.
                canUndo: false,

                editorFocus : CKEDITOR.env.ie || CKEDITOR.env.webkit
        };

        (function()
        {
                var notEmptyRegex = /^([a]|[^a])+$/,
                        integerRegex = /^\d*$/,
                        numberRegex = /^\d*(?:\.\d+)?$/,
                        htmlLengthRegex = /^(((\d*(\.\d+))|(\d*))(px|\%)?)?$/,
                        cssLengthRegex = /^(((\d*(\.\d+))|(\d*))(px|em|ex|in|cm|mm|pt|pc|\%)?)?$/i;

                CKEDITOR.VALIDATE_OR = 1;
                CKEDITOR.VALIDATE_AND = 2;

                CKEDITOR.dialog.validate =
                {
                        functions : function()
                        {
                                var args = arguments;
                                return function()
                                {
                                        /**
                                         * It's important for validate functions to be able to accept the value
                                         * as argument in addition to this.getValue(), so that it is possible to
                                         * combine validate functions together to make more sophisticated
                                         * validators.
                                         */
                                        var value = this && this.getValue ? this.getValue() : args[ 0 ];

                                        var msg = undefined,
                                                relation = CKEDITOR.VALIDATE_AND,
                                                functions = [], i;

                                        for ( i = 0 ; i < args.length ; i++ )
                                        {
                                                if ( typeof( args[i] ) == 'function' )
                                                        functions.push( args[i] );
                                                else
                                                        break;
                                        }

                                        if ( i < args.length && typeof( args[i] ) == 'string' )
                                        {
                                                msg = args[i];
                                                i++;
                                        }

                                        if ( i < args.length && typeof( args[i]) == 'number' )
                                                relation = args[i];

                                        var passed = ( relation == CKEDITOR.VALIDATE_AND ? true : false );
                                        for ( i = 0 ; i < functions.length ; i++ )
                                        {
                                                if ( relation == CKEDITOR.VALIDATE_AND )
                                                        passed = passed && functions[i]( value );
                                                else
                                                        passed = passed || functions[i]( value );
                                        }

                                        return !passed ? msg : true;
                                };
                        },

                        regex : function( regex, msg )
                        {
                                /*
                                 * Can be greatly shortened by deriving from functions validator if code size
                                 * turns out to be more important than performance.
                                 */
                                return function()
                                {
                                        var value = this && this.getValue ? this.getValue() : arguments[0];
                                        return !regex.test( value ) ? msg : true;
                                };
                        },

                        notEmpty : function( msg )
                        {
                                return this.regex( notEmptyRegex, msg );
                        },

                        integer : function( msg )
                        {
                                return this.regex( integerRegex, msg );
                        },

                        'number' : function( msg )
                        {
                                return this.regex( numberRegex, msg );
                        },

                        'cssLength' : function( msg )
                        {
                                return this.functions( function( val ){ return cssLengthRegex.test( CKEDITOR.tools.trim( val ) ); }, msg );
                        },

                        'htmlLength' : function( msg )
                        {
                                return this.functions( function( val ){ return htmlLengthRegex.test( CKEDITOR.tools.trim( val ) ); }, msg );
                        },

                        equals : function( value, msg )
                        {
                                return this.functions( function( val ){ return val == value; }, msg );
                        },

                        notEqual : function( value, msg )
                        {
                                return this.functions( function( val ){ return val != value; }, msg );
                        }
                };

        CKEDITOR.on( 'instanceDestroyed', function( evt )
        {
                // Remove dialog cover on last instance destroy.
                if ( CKEDITOR.tools.isEmpty( CKEDITOR.instances ) )
                {
                        var currentTopDialog;
                        while ( ( currentTopDialog = CKEDITOR.dialog._.currentTop ) )
                                currentTopDialog.hide();
                        removeCovers();
                }

                var dialogs = evt.editor._.storedDialogs;
                for ( var name in dialogs )
                        dialogs[ name ].destroy();

        });

        })();

        // Extend the CKEDITOR.editor class with dialog specific functions.
        CKEDITOR.tools.extend( CKEDITOR.editor.prototype,
                /** @lends CKEDITOR.editor.prototype */
                {
                        /**
                         * Loads and opens a registered dialog.
                         * @param {String} dialogName The registered name of the dialog.
                         * @param {Function} callback The function to be invoked after dialog instance created.
                         * @see CKEDITOR.dialog.add
                         * @example
                         * CKEDITOR.instances.editor1.openDialog( 'smiley' );
                         * @returns {CKEDITOR.dialog} The dialog object corresponding to the dialog displayed. null if the dialog name is not registered.
                         */
                        openDialog : function( dialogName, callback )
                        {
                                if ( this.mode == 'wysiwyg' && CKEDITOR.env.ie )
                                {
                                        var selection = this.getSelection();
                                        selection && selection.lock();
                                }

                                var dialogDefinitions = CKEDITOR.dialog._.dialogDefinitions[ dialogName ],
                                                dialogSkin = this.skin.dialog;

                                if ( CKEDITOR.dialog._.currentTop === null )
                                        showCover( this );

                                // If the dialogDefinition is already loaded, open it immediately.
                                if ( typeof dialogDefinitions == 'function' && dialogSkin._isLoaded )
                                {
                                        var storedDialogs = this._.storedDialogs ||
                                                ( this._.storedDialogs = {} );

                                        var dialog = storedDialogs[ dialogName ] ||
                                                ( storedDialogs[ dialogName ] = new CKEDITOR.dialog( this, dialogName ) );

                                        callback && callback.call( dialog, dialog );
                                        dialog.show();

                                        return dialog;
                                }
                                else if ( dialogDefinitions == 'failed' )
                                {
                                        hideCover();
                                        throw new Error( '[CKEDITOR.dialog.openDialog] Dialog "' + dialogName + '" failed when loading definition.' );
                                }

                                var me = this;

                                function onDialogFileLoaded( success )
                                {
                                        var dialogDefinition = CKEDITOR.dialog._.dialogDefinitions[ dialogName ],
                                                        skin = me.skin.dialog;

                                        // Check if both skin part and definition is loaded.
                                        if ( !skin._isLoaded || loadDefinition && typeof success == 'undefined' )
                                                return;

                                        // In case of plugin error, mark it as loading failed.
                                        if ( typeof dialogDefinition != 'function' )
                                                CKEDITOR.dialog._.dialogDefinitions[ dialogName ] = 'failed';

                                        me.openDialog( dialogName, callback );
                                }

                                if ( typeof dialogDefinitions == 'string' )
                                {
                                        var loadDefinition = 1;
                                        CKEDITOR.scriptLoader.load( CKEDITOR.getUrl( dialogDefinitions ), onDialogFileLoaded, null, 0, 1 );
                                }

                                CKEDITOR.skins.load( this, 'dialog', onDialogFileLoaded );

                                return null;
                        }
                });
})();

CKEDITOR.plugins.add( 'dialog',
        {
                requires : [ 'dialogui' ]
        });

// Dialog related configurations.

/**
 * The color of the dialog background cover. It should be a valid CSS color
 * string.
 * @name CKEDITOR.config.dialog_backgroundCoverColor
 * @type String
 * @default 'white'
 * @example
 * config.dialog_backgroundCoverColor = 'rgb(255, 254, 253)';
 */

/**
 * The opacity of the dialog background cover. It should be a number within the
 * range [0.0, 1.0].
 * @name CKEDITOR.config.dialog_backgroundCoverOpacity
 * @type Number
 * @default 0.5
 * @example
 * config.dialog_backgroundCoverOpacity = 0.7;
 */

/**
 * If the dialog has more than one tab, put focus into the first tab as soon as dialog is opened.
 * @name CKEDITOR.config.dialog_startupFocusTab
 * @type Boolean
 * @default false
 * @example
 * config.dialog_startupFocusTab = true;
 */

/**
 * The distance of magnetic borders used in moving and resizing dialogs,
 * measured in pixels.
 * @name CKEDITOR.config.dialog_magnetDistance
 * @type Number
 * @default 20
 * @example
 * config.dialog_magnetDistance = 30;
 */

/**
 * The guideline to follow when generating the dialog buttons. There are 3 possible options:
 * <ul>
 *     <li>'OS' - the buttons will be displayed in the default order of the user's OS;</li>
 *     <li>'ltr' - for Left-To-Right order;</li>
 *     <li>'rtl' - for Right-To-Left order.</li>
 * </ul>
 * @name CKEDITOR.config.dialog_buttonsOrder
 * @type String
 * @default 'OS'
 * @since 3.5
 * @example
 * config.dialog_buttonsOrder = 'rtl';
 */

/**
 * The dialog contents to removed. It's a string composed by dialog name and tab name with a colon between them.
 * Separate each pair with semicolon (see example).
 * <b>Note: All names are case-sensitive.</b>
 * <b>Note: Be cautious when specifying dialog tabs that are mandatory, like "info", dialog functionality might be broken because of this!</b>
 * @name CKEDITOR.config.removeDialogTabs
 * @type String
 * @since 3.5
 * @default ''
 * @example
 * config.removeDialogTabs = 'flash:advanced;image:Link';
 */

/**
 * 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.
 * <p>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.</p>
 * @name CKEDITOR#dialogDefinition
 * @event
 * @param {CKEDITOR.dialog.definition} data The dialog defination that
 *              is being loaded.
 * @param {CKEDITOR.editor} editor The editor instance that will use the
 *              dialog.
 */

/**
 * Fired when a tab is going to be selected in a dialog
 * @name CKEDITOR.dialog#selectPage
 * @event
 * @param {String} page The id of the page that it's gonna be selected.
 * @param {String} currentPage The id of the current page.
 */

/**
 * Fired when the user tries to dismiss a dialog
 * @name CKEDITOR.dialog#cancel
 * @event
 * @param {Boolean} hide Whether the event should proceed or not.
 */

/**
 * Fired when the user tries to confirm a dialog
 * @name CKEDITOR.dialog#ok
 * @event
 * @param {Boolean} hide Whether the event should proceed or not.
 */

/**
 * Fired when a dialog is shown
 * @name CKEDITOR.dialog#show
 * @event
 */

/**
 * Fired when a dialog is shown
 * @name CKEDITOR.editor#dialogShow
 * @event
 */

/**
 * Fired when a dialog is hidden
 * @name CKEDITOR.dialog#hide
 * @event
 */

/**
 * Fired when a dialog is hidden
 * @name CKEDITOR.editor#dialogHide
 * @event
 */

/**
 * Fired when a dialog is being resized. The event is fired on
 * both the 'CKEDITOR.dialog' object and the dialog instance
 * since 3.5.3, previously it's available only in the global object.
 * @name CKEDITOR.dialog#resize
 * @since 3.5
 * @event
 * @param {CKEDITOR.dialog} dialog The dialog being resized (if
 * it's fired on the dialog itself, this parameter isn't sent).
 * @param {String} skin The skin name.
 * @param {Number} width The new width.
 * @param {Number} height The new height.
 */