_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                          * Indicates that page is running under an encrypted connection.\r
 110                          * @returns {Boolean} "true" if the page has an encrypted connection.\r
 111                          * @example\r
 112                          * if ( CKEDITOR.env.secure )\r
 113                          *     alert( "I'm in SSL!" );\r
 114                          */\r
 115                         secure : location.protocol == 'https:'\r
 116                 };\r
 117 \r
 118                 /**\r
 119                  * Indicates that CKEditor is running on a Gecko based browser, like\r
 120                  * Firefox.\r
 121                  * @name CKEDITOR.env.gecko\r
 122                  * @type Boolean\r
 123                  * @example\r
 124                  * if ( CKEDITOR.env.gecko )\r
 125                  *     alert( "I'm riding a gecko!" );\r
 126                  */\r
 127                 env.gecko = ( navigator.product == 'Gecko' && !env.webkit && !env.opera );\r
 128 \r
 129                 var version = 0;\r
 130 \r
 131                 // Internet Explorer 6.0+\r
 132                 if ( env.ie )\r
 133                 {\r
 134                         version = parseFloat( agent.match( /msie (\d+)/ )[1] );\r
 135 \r
 136                         /**\r
 137                          * Indicates that CKEditor is running on Internet Explorer 8.\r
 138                          * @name CKEDITOR.env.ie8\r
 139                          * @type Boolean\r
 140                          * @example\r
 141                          * if ( CKEDITOR.env.ie8 )\r
 142                          *     alert( "I'm on IE8!" );\r
 143                          */\r
 144                         env.ie8 = !!document.documentMode;\r
 145 \r
 146                         /**\r
 147                          * Indicates that CKEditor is running on Internet Explorer 8 on\r
 148                          * standards mode.\r
 149                          * @name CKEDITOR.env.ie8Compat\r
 150                          * @type Boolean\r
 151                          * @example\r
 152                          * if ( CKEDITOR.env.ie8Compat )\r
 153                          *     alert( "Now I'm on IE8, for real!" );\r
 154                          */\r
 155                         env.ie8Compat = document.documentMode == 8;\r
 156 \r
 157                         /**\r
 158                          * Indicates that CKEditor is running on Internet Explorer 9's standards mode.\r
 159                          * @name CKEDITOR.env.ie9Compat\r
 160                          * @type Boolean\r
 161                          * @example\r
 162                          * if ( CKEDITOR.env.ie9Compat )\r
 163                          *     alert( "IE9, the beauty of the web!" );\r
 164                          */\r
 165                         env.ie9Compat = document.documentMode == 9;\r
 166 \r
 167                         /**\r
 168                          * Indicates that CKEditor is running on an IE7-like environment, which\r
 169                          * includes IE7 itself and IE8's IE7 document mode.\r
 170                          * @name CKEDITOR.env.ie7Compat\r
 171                          * @type Boolean\r
 172                          * @example\r
 173                          * if ( CKEDITOR.env.ie8Compat )\r
 174                          *     alert( "I'm on IE7 or on an IE7 like IE8!" );\r
 175                          */\r
 176                         env.ie7Compat = ( ( version == 7 && !document.documentMode )\r
 177                                         || document.documentMode == 7 );\r
 178 \r
 179                         /**\r
 180                          * Indicates that CKEditor is running on an IE6-like environment, which\r
 181                          * includes IE6 itself and IE7 and IE8 quirks mode.\r
 182                          * @name CKEDITOR.env.ie6Compat\r
 183                          * @type Boolean\r
 184                          * @example\r
 185                          * if ( CKEDITOR.env.ie6Compat )\r
 186                          *     alert( "I'm on IE6 or quirks mode!" );\r
 187                          */\r
 188                         env.ie6Compat = ( version < 7 || env.quirks );\r
 189                 }\r
 190 \r
 191                 // Gecko.\r
 192                 if ( env.gecko )\r
 193                 {\r
 194                         var geckoRelease = agent.match( /rv:([\d\.]+)/ );\r
 195                         if ( geckoRelease )\r
 196                         {\r
 197                                 geckoRelease = geckoRelease[1].split( '.' );\r
 198                                 version = geckoRelease[0] * 10000 + ( geckoRelease[1] || 0 ) * 100 + ( geckoRelease[2] || 0 ) * 1;\r
 199                         }\r
 200                 }\r
 201 \r
 202                 // Opera 9.50+\r
 203                 if ( env.opera )\r
 204                         version = parseFloat( opera.version() );\r
 205 \r
 206                 // Adobe AIR 1.0+\r
 207                 // Checked before Safari because AIR have the WebKit rich text editor\r
 208                 // features from Safari 3.0.4, but the version reported is 420.\r
 209                 if ( env.air )\r
 210                         version = parseFloat( agent.match( / adobeair\/(\d+)/ )[1] );\r
 211 \r
 212                 // WebKit 522+ (Safari 3+)\r
 213                 if ( env.webkit )\r
 214                         version = parseFloat( agent.match( / applewebkit\/(\d+)/ )[1] );\r
 215 \r
 216                 /**\r
 217                  * Contains the browser version.<br />\r
 218                  * <br />\r
 219                  * For gecko based browsers (like Firefox) it contains the revision\r
 220                  * number with first three parts concatenated with a padding zero\r
 221                  * (e.g. for revision 1.9.0.2 we have 10900).<br />\r
 222                  * <br />\r
 223                  * For webkit based browser (like Safari and Chrome) it contains the\r
 224                  * WebKit build version (e.g. 522).\r
 225                  * @name CKEDITOR.env.version\r
 226                  * @type Boolean\r
 227                  * @example\r
 228                  * if ( CKEDITOR.env.ie && <b>CKEDITOR.env.version</b> <= 6 )\r
 229                  *     alert( "Ouch!" );\r
 230                  */\r
 231                 env.version = version;\r
 232 \r
 233                 /**\r
 234                  * Indicates that CKEditor is running on a compatible browser.\r
 235                  * @name CKEDITOR.env.isCompatible\r
 236                  * @type Boolean\r
 237                  * @example\r
 238                  * if ( CKEDITOR.env.isCompatible )\r
 239                  *     alert( "Your browser is pretty cool!" );\r
 240                  */\r
 241                 env.isCompatible =\r
 242                         !env.mobile && (\r
 243                         ( env.ie && version >= 6 ) ||\r
 244                         ( env.gecko && version >= 10801 ) ||\r
 245                         ( env.opera && version >= 9.5 ) ||\r
 246                         ( env.air && version >= 1 ) ||\r
 247                         ( env.webkit && version >= 522 ) ||\r
 248                         false );\r
 249 \r
 250                 /**\r
 251                  * The CSS class to be appended on the main UI containers, making it\r
 252                  * easy to apply browser specific styles to it.\r
 253                  * @name CKEDITOR.env.cssClass\r
 254                  * @type String\r
 255                  * @example\r
 256                  * myDiv.className = CKEDITOR.env.cssClass;\r
 257                  */\r
 258                 env.cssClass =\r
 259                         'cke_browser_' + (\r
 260                                 env.ie ? 'ie' :\r
 261                                 env.gecko ? 'gecko' :\r
 262                                 env.opera ? 'opera' :\r
 263                                 env.webkit ? 'webkit' :\r
 264                                 'unknown' );\r
 265 \r
 266                 if ( env.quirks )\r
 267                         env.cssClass += ' cke_browser_quirks';\r
 268 \r
 269                 if ( env.ie )\r
 270                 {\r
 271                         env.cssClass += ' cke_browser_ie' + (\r
 272                                 env.version < 7 ? '6' :\r
 273                                 env.version >= 8 ? document.documentMode:\r
 274                                 '7' );\r
 275 \r
 276                         if ( env.quirks )\r
 277                                 env.cssClass += ' cke_browser_iequirks';\r
 278                 }\r
 279 \r
 280                 if ( env.gecko && version < 10900 )\r
 281                         env.cssClass += ' cke_browser_gecko18';\r
 282 \r
 283                 if ( env.air )\r
 284                         env.cssClass += ' cke_browser_air';\r
 285 \r
 286                 return env;\r
 287         })();\r
 288 }\r
 289 \r
 290 // PACKAGER_RENAME( CKEDITOR.env )\r
 291 // PACKAGER_RENAME( CKEDITOR.env.ie )\r