_source/core/env.js

   1 /*\r
   2 Copyright (c) 2003-2011, 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.env} object, which constains\r
   8  *              environment and browser information.\r
   9  */\r
  10 \r
  11 if ( !CKEDITOR.env )\r
  12 {\r
  13         /**\r
  14          * @namespace Environment and browser information.\r
  15          */\r
  16         CKEDITOR.env = (function()\r
  17         {\r
  18                 var agent = navigator.userAgent.toLowerCase();\r
  19                 var opera = window.opera;\r
  20 \r
  21                 var env =\r
  22                 /** @lends CKEDITOR.env */\r
  23                 {\r
  24                         /**\r
  25                          * Indicates that CKEditor is running on Internet Explorer.\r
  26                          * @type Boolean\r
  27                          * @example\r
  28                          * if ( CKEDITOR.env.ie )\r
  29                          *     alert( "I'm on IE!" );\r
  30                          */\r
  31                         ie              : /*@cc_on!@*/false,\r
  32 \r
  33                         /**\r
  34                          * Indicates that CKEditor is running on Opera.\r
  35                          * @type Boolean\r
  36                          * @example\r
  37                          * if ( CKEDITOR.env.opera )\r
  38                          *     alert( "I'm on Opera!" );\r
  39                          */\r
  40                         opera   : ( !!opera && opera.version ),\r
  41 \r
  42                         /**\r
  43                          * Indicates that CKEditor is running on a WebKit based browser, like\r
  44                          * Safari.\r
  45                          * @type Boolean\r
  46                          * @example\r
  47                          * if ( CKEDITOR.env.webkit )\r
  48                          *     alert( "I'm on WebKit!" );\r
  49                          */\r
  50                         webkit  : ( agent.indexOf( ' applewebkit/' ) > -1 ),\r
  51 \r
  52                         /**\r
  53                          * Indicates that CKEditor is running on Adobe AIR.\r
  54                          * @type Boolean\r
  55                          * @example\r
  56                          * if ( CKEDITOR.env.air )\r
  57                          *     alert( "I'm on AIR!" );\r
  58                          */\r
  59                         air             : ( agent.indexOf( ' adobeair/' ) > -1 ),\r
  60 \r
  61                         /**\r
  62                          * Indicates that CKEditor is running on Macintosh.\r
  63                          * @type Boolean\r
  64                          * @example\r
  65                          * if ( CKEDITOR.env.mac )\r
  66                          *     alert( "I love apples!" );\r
  67                          */\r
  68                         mac     : ( agent.indexOf( 'macintosh' ) > -1 ),\r
  69 \r
  70                         /**\r
  71                          * Indicates that CKEditor is running on a quirks mode environemnt.\r
  72                          * @type Boolean\r
  73                          * @example\r
  74                          * if ( CKEDITOR.env.quirks )\r
  75                          *     alert( "Nooooo!" );\r
  76                          */\r
  77                         quirks : ( document.compatMode == 'BackCompat' ),\r
  78 \r
  79                         /**\r
  80                          * Indicates that CKEditor is running on a mobile like environemnt.\r
  81                          * @type Boolean\r
  82                          * @example\r
  83                          * if ( CKEDITOR.env.mobile )\r
  84                          *     alert( "I'm running with CKEditor today!" );\r
  85                          */\r
  86                         mobile : ( agent.indexOf( 'mobile' ) > -1 ),\r
  87 \r
  88                         /**\r
  89                          * Indicates that the browser has a custom domain enabled. This has\r
  90                          * been set with "document.domain".\r
  91                          * @returns {Boolean} "true" if a custom domain is enabled.\r
  92                          * @example\r
  93                          * if ( CKEDITOR.env.isCustomDomain() )\r
  94                          *     alert( "I'm in a custom domain!" );\r
  95                          */\r
  96                         isCustomDomain : function()\r
  97                         {\r
  98                                 if ( !this.ie )\r
  99                                         return false;\r
 100 \r
 101                                 var domain = document.domain,\r
 102                                         hostname = window.location.hostname;\r
 103 \r
 104                                 return domain != hostname &&\r
 105                                         domain != ( '[' + hostname + ']' );     // IPv6 IP support (#5434)\r
 106                         }\r
 107                 };\r
 108 \r
 109                 /**\r
 110                  * Indicates that CKEditor is running on a Gecko based browser, like\r
 111                  * Firefox.\r
 112                  * @name CKEDITOR.env.gecko\r
 113                  * @type Boolean\r
 114                  * @example\r
 115                  * if ( CKEDITOR.env.gecko )\r
 116                  *     alert( "I'm riding a gecko!" );\r
 117                  */\r
 118                 env.gecko = ( navigator.product == 'Gecko' && !env.webkit && !env.opera );\r
 119 \r
 120                 var version = 0;\r
 121 \r
 122                 // Internet Explorer 6.0+\r
 123                 if ( env.ie )\r
 124                 {\r
 125                         version = parseFloat( agent.match( /msie (\d+)/ )[1] );\r
 126 \r
 127                         /**\r
 128                          * Indicates that CKEditor is running on Internet Explorer 8.\r
 129                          * @name CKEDITOR.env.ie8\r
 130                          * @type Boolean\r
 131                          * @example\r
 132                          * if ( CKEDITOR.env.ie8 )\r
 133                          *     alert( "I'm on IE8!" );\r
 134                          */\r
 135                         env.ie8 = !!document.documentMode;\r
 136 \r
 137                         /**\r
 138                          * Indicates that CKEditor is running on Internet Explorer 8 on\r
 139                          * standards mode.\r
 140                          * @name CKEDITOR.env.ie8Compat\r
 141                          * @type Boolean\r
 142                          * @example\r
 143                          * if ( CKEDITOR.env.ie8Compat )\r
 144                          *     alert( "Now I'm on IE8, for real!" );\r
 145                          */\r
 146                         env.ie8Compat = document.documentMode == 8;\r
 147 \r
 148                         /**\r
 149                          * Indicates that CKEditor is running on Internet Explorer 9's standards mode.\r
 150                          * @name CKEDITOR.env.ie9Compat\r
 151                          * @type Boolean\r
 152                          * @example\r
 153                          * if ( CKEDITOR.env.ie9Compat )\r
 154                          *     alert( "IE9, the beauty of the web!" );\r
 155                          */\r
 156                         env.ie9Compat = document.documentMode == 9;\r
 157 \r
 158                         /**\r
 159                          * Indicates that CKEditor is running on an IE7-like environment, which\r
 160                          * includes IE7 itself and IE8's IE7 document mode.\r
 161                          * @name CKEDITOR.env.ie7Compat\r
 162                          * @type Boolean\r
 163                          * @example\r
 164                          * if ( CKEDITOR.env.ie8Compat )\r
 165                          *     alert( "I'm on IE7 or on an IE7 like IE8!" );\r
 166                          */\r
 167                         env.ie7Compat = ( ( version == 7 && !document.documentMode )\r
 168                                         || document.documentMode == 7 );\r
 169 \r
 170                         /**\r
 171                          * Indicates that CKEditor is running on an IE6-like environment, which\r
 172                          * includes IE6 itself and IE7 and IE8 quirks mode.\r
 173                          * @name CKEDITOR.env.ie6Compat\r
 174                          * @type Boolean\r
 175                          * @example\r
 176                          * if ( CKEDITOR.env.ie6Compat )\r
 177                          *     alert( "I'm on IE6 or quirks mode!" );\r
 178                          */\r
 179                         env.ie6Compat = ( version < 7 || env.quirks );\r
 180                 }\r
 181 \r
 182                 // Gecko.\r
 183                 if ( env.gecko )\r
 184                 {\r
 185                         var geckoRelease = agent.match( /rv:([\d\.]+)/ );\r
 186                         if ( geckoRelease )\r
 187                         {\r
 188                                 geckoRelease = geckoRelease[1].split( '.' );\r
 189                                 version = geckoRelease[0] * 10000 + ( geckoRelease[1] || 0 ) * 100 + ( geckoRelease[2] || 0 ) * 1;\r
 190                         }\r
 191                 }\r
 192 \r
 193                 // Opera 9.50+\r
 194                 if ( env.opera )\r
 195                         version = parseFloat( opera.version() );\r
 196 \r
 197                 // Adobe AIR 1.0+\r
 198                 // Checked before Safari because AIR have the WebKit rich text editor\r
 199                 // features from Safari 3.0.4, but the version reported is 420.\r
 200                 if ( env.air )\r
 201                         version = parseFloat( agent.match( / adobeair\/(\d+)/ )[1] );\r
 202 \r
 203                 // WebKit 522+ (Safari 3+)\r
 204                 if ( env.webkit )\r
 205                         version = parseFloat( agent.match( / applewebkit\/(\d+)/ )[1] );\r
 206 \r
 207                 /**\r
 208                  * Contains the browser version.<br />\r
 209                  * <br />\r
 210                  * For gecko based browsers (like Firefox) it contains the revision\r
 211                  * number with first three parts concatenated with a padding zero\r
 212                  * (e.g. for revision 1.9.0.2 we have 10900).<br />\r
 213                  * <br />\r
 214                  * For webkit based browser (like Safari and Chrome) it contains the\r
 215                  * WebKit build version (e.g. 522).\r
 216                  * @name CKEDITOR.env.version\r
 217                  * @type Boolean\r
 218                  * @example\r
 219                  * if ( CKEDITOR.env.ie && <b>CKEDITOR.env.version</b> <= 6 )\r
 220                  *     alert( "Ouch!" );\r
 221                  */\r
 222                 env.version = version;\r
 223 \r
 224                 /**\r
 225                  * Indicates that CKEditor is running on a compatible browser.\r
 226                  * @name CKEDITOR.env.isCompatible\r
 227                  * @type Boolean\r
 228                  * @example\r
 229                  * if ( CKEDITOR.env.isCompatible )\r
 230                  *     alert( "Your browser is pretty cool!" );\r
 231                  */\r
 232                 env.isCompatible =\r
 233                         !env.mobile && (\r
 234                         ( env.ie && version >= 6 ) ||\r
 235                         ( env.gecko && version >= 10801 ) ||\r
 236                         ( env.opera && version >= 9.5 ) ||\r
 237                         ( env.air && version >= 1 ) ||\r
 238                         ( env.webkit && version >= 522 ) ||\r
 239                         false );\r
 240 \r
 241                 /**\r
 242                  * The CSS class to be appended on the main UI containers, making it\r
 243                  * easy to apply browser specific styles to it.\r
 244                  * @name CKEDITOR.env.cssClass\r
 245                  * @type String\r
 246                  * @example\r
 247                  * myDiv.className = CKEDITOR.env.cssClass;\r
 248                  */\r
 249                 env.cssClass =\r
 250                         'cke_browser_' + (\r
 251                                 env.ie ? 'ie' :\r
 252                                 env.gecko ? 'gecko' :\r
 253                                 env.opera ? 'opera' :\r
 254                                 env.webkit ? 'webkit' :\r
 255                                 'unknown' );\r
 256 \r
 257                 if ( env.quirks )\r
 258                         env.cssClass += ' cke_browser_quirks';\r
 259 \r
 260                 if ( env.ie )\r
 261                 {\r
 262                         env.cssClass += ' cke_browser_ie' + (\r
 263                                 env.version < 7 ? '6' :\r
 264                                 env.version >= 8 ? document.documentMode:\r
 265                                 '7' );\r
 266 \r
 267                         if ( env.quirks )\r
 268                                 env.cssClass += ' cke_browser_iequirks';\r
 269                 }\r
 270 \r
 271                 if ( env.gecko && version < 10900 )\r
 272                         env.cssClass += ' cke_browser_gecko18';\r
 273 \r
 274                 if ( env.air )\r
 275                         env.cssClass += ' cke_browser_air';\r
 276 \r
 277                 return env;\r
 278         })();\r
 279 }\r
 280 \r
 281 // PACKAGER_RENAME( CKEDITOR.env )\r
 282 // PACKAGER_RENAME( CKEDITOR.env.ie )\r