X-Git-Url: https://jasonwoof.com/gitweb/?a=blobdiff_plain;f=_source%2Fthemes%2Fdefault%2Ftheme.js;h=b1e94ba8b1bbc55da452839319c4c174ed213320;hb=4e90e78dc97789709ee7404359a5517540c27553;hp=078eb19b99869037b83a0e4e6d2b741fa02abd0e;hpb=f8fc585c18d287eb325c575596d183122486b641;p=ckeditor.git diff --git a/_source/themes/default/theme.js b/_source/themes/default/theme.js index 078eb19..b1e94ba 100644 --- a/_source/themes/default/theme.js +++ b/_source/themes/default/theme.js @@ -1,8 +1,13 @@ /* -Copyright (c) 2003-2010, CKSource - Frederico Knabben. All rights reserved. +Copyright (c) 2003-2011, CKSource - Frederico Knabben. All rights reserved. For licensing, see LICENSE.html or http://ckeditor.com/license */ +/** + * @name CKEDITOR.theme + * @class + */ + CKEDITOR.themes.add( 'default', (function() { function checkSharedSpace( editor, spaceName ) @@ -21,8 +26,10 @@ CKEDITOR.themes.add( 'default', (function() { // Creates an HTML structure that reproduces the editor class hierarchy. var html = - '' + - '' + + '' + + '' + '' + '' + '' + @@ -40,6 +47,10 @@ CKEDITOR.themes.add( 'default', (function() // Get the deeper inner
. container = mainContainer.getChild( [0,0,0,0] ); + // Save a reference to the shared space container. + !editor.sharedSpaces && ( editor.sharedSpaces = {} ); + editor.sharedSpaces[ spaceName ] = container; + // When the editor gets focus, we show the space container, hiding others. editor.on( 'focus', function() { @@ -65,7 +76,7 @@ CKEDITOR.themes.add( 'default', (function() return container; } - return { + return /** @lends CKEDITOR.theme */ { build : function( editor, themePath ) { var name = editor.name, @@ -113,12 +124,11 @@ CKEDITOR.themes.add( 'default', (function() var container = CKEDITOR.dom.element.createFromHtml( [ '
' + 'X' + '
' + - '' + + '' + + '' + '' + - '' + - '' + + '' + + '' + + '' + + '' + + '' + '' + '
' + '
' + @@ -222,50 +248,43 @@ CKEDITOR.themes.add( 'default', (function() close : close, tabs : body.getChild( 2 ), contents : body.getChild( [ 3, 0, 0, 0 ] ), - footer : body.getChild( 4 ) + footer : body.getChild( [ 3, 0, 1, 0 ] ) } }; }, destroy : function( editor ) { - var container = editor.container; - container.clearCustomData(); - editor.element.clearCustomData(); - - /* - * IE BUG: Removing the editor DOM elements while the selection is inside - * the editing area would break IE7/8's selection system. So we need to put - * the selection back to the parent document without scrolling the window. - * (#3812) - */ - if ( CKEDITOR.env.ie ) - { - container.setStyle( 'display', 'none' ); - - var $range = document.body.createTextRange(); - $range.moveToElementText( container.$ ); - try - { - // Putting the selection to a display:none element - this will certainly - // fail. But! We've just put the selection document back to the parent - // document without scrolling the window! - $range.select(); - } - catch ( e ) {} - } + var container = editor.container, + element = editor.element; if ( container ) + { + container.clearCustomData(); container.remove(); + } - if ( editor.elementMode == CKEDITOR.ELEMENT_MODE_REPLACE ) - editor.element.show(); - - delete editor.element; + if ( element ) + { + element.clearCustomData(); + editor.elementMode == CKEDITOR.ELEMENT_MODE_REPLACE && element.show(); + delete editor.element; + } } }; })() ); +/** + * Returns the DOM element that represents a theme space. The default theme defines + * three spaces, namely "top", "contents" and "bottom", representing the main + * blocks that compose the editor interface. + * @param {String} spaceName The space name. + * @returns {CKEDITOR.dom.element} The element that represents the space. + * @example + * // Hide the bottom space in the UI. + * var bottom = editor.getThemeSpace( 'bottom' ); + * bottom.setStyle( 'display', 'none' ); + */ CKEDITOR.editor.prototype.getThemeSpace = function( spaceName ) { var spacePrefix = 'cke_' + spaceName; @@ -274,12 +293,28 @@ CKEDITOR.editor.prototype.getThemeSpace = function( spaceName ) return space; }; +/** + * Resizes the editor interface. + * @param {Number|String} width The new width. It can be an pixels integer or a + * CSS size value. + * @param {Number|String} height The new height. It can be an pixels integer or + * a CSS size value. + * @param {Boolean} [isContentHeight] Indicates that the provided height is to + * be applied to the editor contents space, not to the entire editor + * interface. Defaults to false. + * @param {Boolean} [resizeInner] Indicates that the first inner interface + * element must receive the size, not the outer element. The default theme + * defines the interface inside a pair of span elements + * (<span><span>...</span></span>). By default the + * first span element receives the sizes. If this parameter is set to + * true, the second span is sized instead. + * @example + * editor.resize( 900, 300 ); + * @example + * editor.resize( '100%', 450, true ); + */ CKEDITOR.editor.prototype.resize = function( width, height, isContentHeight, resizeInner ) { - var numberRegex = /^\d+$/; - if ( numberRegex.test( width ) ) - width += 'px'; - var container = this.container, contents = CKEDITOR.document.getById( 'cke_contents_' + this.name ), outer = resizeInner ? container.getChild( 1 ) : container; @@ -288,7 +323,8 @@ CKEDITOR.editor.prototype.resize = function( width, height, isContentHeight, res // WEBKIT BUG: Webkit requires that we put the editor off from display when we // resize it. If we don't, the browser crashes! CKEDITOR.env.webkit && outer.setStyle( 'display', 'none' ); - outer.setStyle( 'width', width ); + // Set as border box width. (#5353) + outer.setSize( 'width', width, true ); if ( CKEDITOR.env.webkit ) { outer.$.offsetWidth; @@ -304,9 +340,16 @@ CKEDITOR.editor.prototype.resize = function( width, height, isContentHeight, res this.fire( 'resize' ); }; +/** + * Gets the element that can be freely used to check the editor size. This method + * is mainly used by the resize plugin, which adds a UI handle that can be used + * to resize the editor. + * @returns {CKEDITOR.dom.element} The resizable element. + * @example + */ CKEDITOR.editor.prototype.getResizable = function() { - return this.container.getChild( 1 ); + return this.container; }; /** @@ -334,3 +377,10 @@ CKEDITOR.editor.prototype.getResizable = function() * top : 'someElementId' * }; */ + +/** + * Fired after the editor instance is resized through + * the {@link CKEDITOR.editor.prototype.resize} method. + * @name CKEDITOR.editor#resize + * @event + */