container.clearCustomData();\r
editor.element.clearCustomData();\r
\r
- /*\r
- * IE BUG: Removing the editor DOM elements while the selection is inside\r
- * the editing area would break IE7/8's selection system. So we need to put\r
- * the selection back to the parent document without scrolling the window.\r
- * (#3812)\r
- */\r
- if ( CKEDITOR.env.ie )\r
- {\r
- container.setStyle( 'display', 'none' );\r
-\r
- var $range = document.body.createTextRange();\r
- $range.moveToElementText( container.$ );\r
- try\r
- {\r
- // Putting the selection to a display:none element - this will certainly\r
- // fail. But! We've just put the selection document back to the parent\r
- // document without scrolling the window!\r
- $range.select();\r
- }\r
- catch ( e ) {}\r
- }\r
-\r
if ( container )\r
container.remove();\r
\r
};\r
})() );\r
\r
+/**\r
+ * Returns the DOM element that represents a theme space. The default theme defines\r
+ * three spaces, namely "top", "contents" and "bottom", representing the main\r
+ * blocks that compose the editor interface.\r
+ * @param {String} spaceName The space name.\r
+ * @returns {CKEDITOR.dom.element} The element that represents the space.\r
+ * @example\r
+ * // Hide the bottom space in the UI.\r
+ * var bottom = editor.getThemeSpace( 'bottom' );\r
+ * bottom.setStyle( 'display', 'none' );\r
+ */\r
CKEDITOR.editor.prototype.getThemeSpace = function( spaceName )\r
{\r
var spacePrefix = 'cke_' + spaceName;\r
return space;\r
};\r
\r
+/**\r
+ * Resizes the editor interface.\r
+ * @param {Number|String} width The new width. It can be an pixels integer or a\r
+ * CSS size value.\r
+ * @param {Number|String} height The new height. It can be an pixels integer or\r
+ * a CSS size value.\r
+ * @param {Boolean} [isContentHeight] Indicates that the provided height is to\r
+ * be applied to the editor contents space, not to the entire editor\r
+ * interface. Defaults to false.\r
+ * @param {Boolean} [resizeInner] Indicates that the first inner interface\r
+ * element must receive the size, not the outer element. The default theme\r
+ * defines the interface inside a pair of span elements\r
+ * (<span><span>...</span></span>). By default the\r
+ * first span element receives the sizes. If this parameter is set to\r
+ * true, the second span is sized instead.\r
+ * @example\r
+ * editor.resize( 900, 300 );\r
+ * @example\r
+ * editor.resize( '100%', 450, true );\r
+ */\r
CKEDITOR.editor.prototype.resize = function( width, height, isContentHeight, resizeInner )\r
{\r
- var numberRegex = /^\d+$/;\r
- if ( numberRegex.test( width ) )\r
- width += 'px';\r
-\r
var container = this.container,\r
contents = CKEDITOR.document.getById( 'cke_contents_' + this.name ),\r
outer = resizeInner ? container.getChild( 1 ) : container;\r
// WEBKIT BUG: Webkit requires that we put the editor off from display when we\r
// resize it. If we don't, the browser crashes!\r
CKEDITOR.env.webkit && outer.setStyle( 'display', 'none' );\r
- outer.setStyle( 'width', width );\r
+ // Set as border box width. (#5353)\r
+ outer.setSize( 'width', width, true );\r
if ( CKEDITOR.env.webkit )\r
{\r
outer.$.offsetWidth;\r
this.fire( 'resize' );\r
};\r
\r
+/**\r
+ * Gets the element that can be freely used to check the editor size. This method\r
+ * is mainly used by the resize plugin, which adds a UI handle that can be used\r
+ * to resize the editor.\r
+ * @returns {CKEDITOR.dom.element} The resizable element.\r
+ * @example\r
+ */\r
CKEDITOR.editor.prototype.getResizable = function()\r
{\r
return this.container.getChild( 1 );\r
* top : 'someElementId'\r
* };\r
*/\r
+\r
+/**\r
+ * Fired after the editor instance is resized through\r
+ * the {@link CKEDITOR.editor.prototype.resize} method.\r
+ * @name CKEDITOR#resize\r
+ * @event\r
+ */\r