_source/core/dom/document.js

   1 /*\r
   2 Copyright (c) 2003-2010, CKSource - Frederico Knabben. All rights reserved.\r
   3 For licensing, see LICENSE.html or http://ckeditor.com/license\r
   4 */\r
   5 \r
   6 /**\r
   7  * @fileOverview Defines the {@link CKEDITOR.dom.document} class, which\r
   8  *              represents a DOM document.\r
   9  */\r
  10 \r
  11 /**\r
  12  * Represents a DOM document.\r
  13  * @constructor\r
  14  * @augments CKEDITOR.dom.domObject\r
  15  * @param {Object} domDocument A native DOM document.\r
  16  * @example\r
  17  * var document = new CKEDITOR.dom.document( document );\r
  18  */\r
  19 CKEDITOR.dom.document = function( domDocument )\r
  20 {\r
  21         CKEDITOR.dom.domObject.call( this, domDocument );\r
  22 };\r
  23 \r
  24 // PACKAGER_RENAME( CKEDITOR.dom.document )\r
  25 \r
  26 CKEDITOR.dom.document.prototype = new CKEDITOR.dom.domObject();\r
  27 \r
  28 CKEDITOR.tools.extend( CKEDITOR.dom.document.prototype,\r
  29         /** @lends CKEDITOR.dom.document.prototype */\r
  30         {\r
  31                 /**\r
  32                  * Appends a CSS file to the document.\r
  33                  * @param {String} cssFileUrl The CSS file URL.\r
  34                  * @example\r
  35                  * <b>CKEDITOR.document.appendStyleSheet( '/mystyles.css' )</b>;\r
  36                  */\r
  37                 appendStyleSheet : function( cssFileUrl )\r
  38                 {\r
  39                         if ( this.$.createStyleSheet )\r
  40                                 this.$.createStyleSheet( cssFileUrl );\r
  41                         else\r
  42                         {\r
  43                                 var link = new CKEDITOR.dom.element( 'link' );\r
  44                                 link.setAttributes(\r
  45                                         {\r
  46                                                 rel             :'stylesheet',\r
  47                                                 type    : 'text/css',\r
  48                                                 href    : cssFileUrl\r
  49                                         });\r
  50 \r
  51                                 this.getHead().append( link );\r
  52                         }\r
  53                 },\r
  54 \r
  55                 appendStyleText : function( cssStyleText )\r
  56                 {\r
  57                         if ( this.$.createStyleSheet )\r
  58                         {\r
  59                                 var styleSheet = this.$.createStyleSheet( "" );\r
  60                                 styleSheet.cssText = cssStyleText ;\r
  61                         }\r
  62                         else\r
  63                         {\r
  64                                 var style = new CKEDITOR.dom.element( 'style', this );\r
  65                                 style.append( new CKEDITOR.dom.text( cssStyleText, this ) );\r
  66                                 this.getHead().append( style );\r
  67                         }\r
  68                 },\r
  69 \r
  70                 createElement : function( name, attribsAndStyles )\r
  71                 {\r
  72                         var element = new CKEDITOR.dom.element( name, this );\r
  73 \r
  74                         if ( attribsAndStyles )\r
  75                         {\r
  76                                 if ( attribsAndStyles.attributes )\r
  77                                         element.setAttributes( attribsAndStyles.attributes );\r
  78 \r
  79                                 if ( attribsAndStyles.styles )\r
  80                                         element.setStyles( attribsAndStyles.styles );\r
  81                         }\r
  82 \r
  83                         return element;\r
  84                 },\r
  85 \r
  86                 createText : function( text )\r
  87                 {\r
  88                         return new CKEDITOR.dom.text( text, this );\r
  89                 },\r
  90 \r
  91                 focus : function()\r
  92                 {\r
  93                         this.getWindow().focus();\r
  94                 },\r
  95 \r
  96                 /**\r
  97                  * Gets and element based on its id.\r
  98                  * @param {String} elementId The element id.\r
  99                  * @returns {CKEDITOR.dom.element} The element instance, or null if not found.\r
 100                  * @example\r
 101                  * var element = <b>CKEDITOR.document.getById( 'myElement' )</b>;\r
 102                  * alert( element.getId() );  // "myElement"\r
 103                  */\r
 104                 getById : function( elementId )\r
 105                 {\r
 106                         var $ = this.$.getElementById( elementId );\r
 107                         return $ ? new CKEDITOR.dom.element( $ ) : null;\r
 108                 },\r
 109 \r
 110                 getByAddress : function( address, normalized )\r
 111                 {\r
 112                         var $ = this.$.documentElement;\r
 113 \r
 114                         for ( var i = 0 ; $ && i < address.length ; i++ )\r
 115                         {\r
 116                                 var target = address[ i ];\r
 117 \r
 118                                 if ( !normalized )\r
 119                                 {\r
 120                                         $ = $.childNodes[ target ];\r
 121                                         continue;\r
 122                                 }\r
 123 \r
 124                                 var currentIndex = -1;\r
 125 \r
 126                                 for (var j = 0 ; j < $.childNodes.length ; j++ )\r
 127                                 {\r
 128                                         var candidate = $.childNodes[ j ];\r
 129 \r
 130                                         if ( normalized === true &&\r
 131                                                         candidate.nodeType == 3 &&\r
 132                                                         candidate.previousSibling &&\r
 133                                                         candidate.previousSibling.nodeType == 3 )\r
 134                                         {\r
 135                                                 continue;\r
 136                                         }\r
 137 \r
 138                                         currentIndex++;\r
 139 \r
 140                                         if ( currentIndex == target )\r
 141                                         {\r
 142                                                 $ = candidate;\r
 143                                                 break;\r
 144                                         }\r
 145                                 }\r
 146                         }\r
 147 \r
 148                         return $ ? new CKEDITOR.dom.node( $ ) : null;\r
 149                 },\r
 150 \r
 151                 getElementsByTag : function( tagName, namespace )\r
 152                 {\r
 153                         if ( !CKEDITOR.env.ie && namespace )\r
 154                                 tagName = namespace + ':' + tagName;\r
 155                         return new CKEDITOR.dom.nodeList( this.$.getElementsByTagName( tagName ) );\r
 156                 },\r
 157 \r
 158                 /**\r
 159                  * Gets the &lt;head&gt; element for this document.\r
 160                  * @returns {CKEDITOR.dom.element} The &lt;head&gt; element.\r
 161                  * @example\r
 162                  * var element = <b>CKEDITOR.document.getHead()</b>;\r
 163                  * alert( element.getName() );  // "head"\r
 164                  */\r
 165                 getHead : function()\r
 166                 {\r
 167                         var head = this.$.getElementsByTagName( 'head' )[0];\r
 168                         head = new CKEDITOR.dom.element( head );\r
 169 \r
 170                         return (\r
 171                         /** @ignore */\r
 172                         this.getHead = function()\r
 173                                 {\r
 174                                         return head;\r
 175                                 })();\r
 176                 },\r
 177 \r
 178                 /**\r
 179                  * Gets the &lt;body&gt; element for this document.\r
 180                  * @returns {CKEDITOR.dom.element} The &lt;body&gt; element.\r
 181                  * @example\r
 182                  * var element = <b>CKEDITOR.document.getBody()</b>;\r
 183                  * alert( element.getName() );  // "body"\r
 184                  */\r
 185                 getBody : function()\r
 186                 {\r
 187                         var body = new CKEDITOR.dom.element( this.$.body );\r
 188 \r
 189                         return (\r
 190                         /** @ignore */\r
 191                         this.getBody = function()\r
 192                                 {\r
 193                                         return body;\r
 194                                 })();\r
 195                 },\r
 196 \r
 197                 getDocumentElement : function()\r
 198                 {\r
 199                         var documentElement = new CKEDITOR.dom.element( this.$.documentElement );\r
 200 \r
 201                         return (\r
 202                         /** @ignore */\r
 203                         this.getDocumentElement = function()\r
 204                                 {\r
 205                                         return documentElement;\r
 206                                 })();\r
 207                 },\r
 208 \r
 209                 /**\r
 210                  * Gets the window object that holds this document.\r
 211                  * @returns {CKEDITOR.dom.window} The window object.\r
 212                  * @example\r
 213                  */\r
 214                 getWindow : function()\r
 215                 {\r
 216                         var win = new CKEDITOR.dom.window( this.$.parentWindow || this.$.defaultView );\r
 217 \r
 218                         return (\r
 219                         /** @ignore */\r
 220                         this.getWindow = function()\r
 221                                 {\r
 222                                         return win;\r
 223                                 })();\r
 224                 }\r
 225         });\r