X-Git-Url: https://jasonwoof.com/gitweb/?a=blobdiff_plain;f=_source%2Fthemes%2Fdefault%2Ftheme.js;h=669aeb36a402da2d513a0e131b0b3653b34e597b;hb=614511639979907ceb0da3614122a4d8eb963ad4;hp=85229c08770a5ba1c1799d529e6564d0b2ade3ad;hpb=8665a7c6c60586526e32e8941fe2896739b6ebfb;p=ckeditor.git diff --git a/_source/themes/default/theme.js b/_source/themes/default/theme.js index 85229c0..669aeb3 100644 --- a/_source/themes/default/theme.js +++ b/_source/themes/default/theme.js @@ -3,6 +3,11 @@ Copyright (c) 2003-2010, 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 ) @@ -22,7 +27,7 @@ CKEDITOR.themes.add( 'default', (function() // Creates an HTML structure that reproduces the editor class hierarchy. var html = '' + - '' + + '' + '' + '' + '' + @@ -65,7 +70,7 @@ CKEDITOR.themes.add( 'default', (function() return container; } - return { + return /** @lends CKEDITOR.theme */ { build : function( editor, themePath ) { var name = editor.name, @@ -113,11 +118,11 @@ CKEDITOR.themes.add( 'default', (function() var container = CKEDITOR.dom.element.createFromHtml( [ '' + 'X' + '
' + - '' + + '' + + '' + '' + - '' + - '' + + '' + + '' + + '' + + '' + + '' + '' + '
' + '
' + @@ -221,7 +230,7 @@ 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 ] ) } }; }, @@ -232,28 +241,6 @@ CKEDITOR.themes.add( 'default', (function() 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 ) {} - } - if ( container ) container.remove(); @@ -265,6 +252,17 @@ CKEDITOR.themes.add( 'default', (function() }; })() ); +/** + * 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; @@ -273,12 +271,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; @@ -287,7 +301,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; @@ -303,6 +318,13 @@ 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 ); @@ -333,3 +355,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#resize + * @event + */