_source/core/env.js

   1 /*\r
   2 Copyright (c) 2003-2009, 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          * Environment and browser information.\r
  15          * @namespace\r
  16          * @example\r
  17          */\r
  18         CKEDITOR.env = (function()\r
  19         {\r
  20                 var agent = navigator.userAgent.toLowerCase();\r
  21                 var opera = window.opera;\r
  22 \r
  23                 var env =\r
  24                 /** @lends CKEDITOR.env */\r
  25                 {\r
  26                         /**\r
  27                          * Indicates that CKEditor is running on Internet Explorer.\r
  28                          * @type Boolean\r
  29                          * @example\r
  30                          * if ( CKEDITOR.env.ie )\r
  31                          *     alert( "I'm on IE!" );\r
  32                          */\r
  33                         ie              : /*@cc_on!@*/false,\r
  34 \r
  35                         /**\r
  36                          * Indicates that CKEditor is running on Opera.\r
  37                          * @type Boolean\r
  38                          * @example\r
  39                          * if ( CKEDITOR.env.opera )\r
  40                          *     alert( "I'm on Opera!" );\r
  41                          */\r
  42                         opera   : ( !!opera && opera.version ),\r
  43 \r
  44                         /**\r
  45                          * Indicates that CKEditor is running on a WebKit based browser, like\r
  46                          * Safari.\r
  47                          * @type Boolean\r
  48                          * @example\r
  49                          * if ( CKEDITOR.env.webkit )\r
  50                          *     alert( "I'm on WebKit!" );\r
  51                          */\r
  52                         webkit  : ( agent.indexOf( ' applewebkit/' ) > -1 ),\r
  53 \r
  54                         /**\r
  55                          * Indicates that CKEditor is running on Adobe AIR.\r
  56                          * @type Boolean\r
  57                          * @example\r
  58                          * if ( CKEDITOR.env.air )\r
  59                          *     alert( "I'm on AIR!" );\r
  60                          */\r
  61                         air             : ( agent.indexOf( ' adobeair/' ) > -1 ),\r
  62 \r
  63                         /**\r
  64                          * Indicates that CKEditor is running on Macintosh.\r
  65                          * @type Boolean\r
  66                          * @example\r
  67                          * if ( CKEDITOR.env.mac )\r
  68                          *     alert( "I love apples!" );\r
  69                          */\r
  70                         mac     : ( agent.indexOf( 'macintosh' ) > -1 ),\r
  71 \r
  72                         quirks : ( document.compatMode == 'BackCompat' ),\r
  73 \r
  74                         isCustomDomain : function()\r
  75                         {\r
  76                                 return this.ie && document.domain != window.location.hostname;\r
  77                         }\r
  78                 };\r
  79 \r
  80                 /**\r
  81                  * Indicates that CKEditor is running on a Gecko based browser, like\r
  82                  * Firefox.\r
  83                  * @name CKEDITOR.env.gecko\r
  84                  * @type Boolean\r
  85                  * @example\r
  86                  * if ( CKEDITOR.env.gecko )\r
  87                  *     alert( "I'm riding a gecko!" );\r
  88                  */\r
  89                 env.gecko = ( navigator.product == 'Gecko' && !env.webkit && !env.opera );\r
  90 \r
  91                 var version = 0;\r
  92 \r
  93                 // Internet Explorer 6.0+\r
  94                 if ( env.ie )\r
  95                 {\r
  96                         version = parseFloat( agent.match( /msie (\d+)/ )[1] );\r
  97 \r
  98                         /**\r
  99                          *  Indicate IE8 browser.\r
 100                          */\r
 101                         env.ie8 = !!document.documentMode;\r
 102 \r
 103                         /**\r
 104                          * Indicte IE8 document mode.\r
 105                          */\r
 106                         env.ie8Compat = document.documentMode == 8;\r
 107 \r
 108                         /**\r
 109                          * Indicates that CKEditor is running on an IE7-like environment, which\r
 110                          * includes IE7 itself and IE8's IE7 document mode.\r
 111                          * @type Boolean\r
 112                          */\r
 113                         env.ie7Compat = ( ( version == 7 && !document.documentMode )\r
 114                                         || document.documentMode == 7 );\r
 115 \r
 116                         /**\r
 117                          * Indicates that CKEditor is running on an IE6-like environment, which\r
 118                          * includes IE6 itself and IE7 and IE8 quirks mode.\r
 119                          * @type Boolean\r
 120                          * @example\r
 121                          * if ( CKEDITOR.env.ie6Compat )\r
 122                          *     alert( "I'm on IE6 or quirks mode!" );\r
 123                          */\r
 124                         env.ie6Compat = ( version < 7 || env.quirks );\r
 125 \r
 126                 }\r
 127 \r
 128                 // Gecko.\r
 129                 if ( env.gecko )\r
 130                 {\r
 131                         var geckoRelease = agent.match( /rv:([\d\.]+)/ );\r
 132                         if ( geckoRelease )\r
 133                         {\r
 134                                 geckoRelease = geckoRelease[1].split( '.' );\r
 135                                 version = geckoRelease[0] * 10000 + ( geckoRelease[1] || 0 ) * 100 + ( geckoRelease[2] || 0 ) * 1;\r
 136                         }\r
 137                 }\r
 138 \r
 139                 // Opera 9.50+\r
 140                 if ( env.opera )\r
 141                         version = parseFloat( opera.version() );\r
 142 \r
 143                 // Adobe AIR 1.0+\r
 144                 // Checked before Safari because AIR have the WebKit rich text editor\r
 145                 // features from Safari 3.0.4, but the version reported is 420.\r
 146                 if ( env.air )\r
 147                         version = parseFloat( agent.match( / adobeair\/(\d+)/ )[1] );\r
 148 \r
 149                 // WebKit 522+ (Safari 3+)\r
 150                 if ( env.webkit )\r
 151                         version = parseFloat( agent.match( / applewebkit\/(\d+)/ )[1] );\r
 152 \r
 153                 /**\r
 154                  * Contains the browser version.\r
 155                  *\r
 156                  * For gecko based browsers (like Firefox) it contains the revision\r
 157                  * number with first three parts concatenated with a padding zero\r
 158                  * (e.g. for revision 1.9.0.2 we have 10900).\r
 159                  *\r
 160                  * For webkit based browser (like Safari and Chrome) it contains the\r
 161                  * WebKit build version (e.g. 522).\r
 162                  * @name CKEDITOR.env.version\r
 163                  * @type Boolean\r
 164                  * @example\r
 165                  * if ( CKEDITOR.env.ie && <b>CKEDITOR.env.version</b> <= 6 )\r
 166                  *     alert( "Ouch!" );\r
 167                  */\r
 168                 env.version = version;\r
 169 \r
 170                 /**\r
 171                  * Indicates that CKEditor is running on a compatible browser.\r
 172                  * @name CKEDITOR.env.isCompatible\r
 173                  * @type Boolean\r
 174                  * @example\r
 175                  * if ( CKEDITOR.env.isCompatible )\r
 176                  *     alert( "Your browser is pretty cool!" );\r
 177                  */\r
 178                 env.isCompatible =\r
 179                         ( env.ie && version >= 6 ) ||\r
 180                         ( env.gecko && version >= 10801 ) ||\r
 181                         ( env.opera && version >= 9.5 ) ||\r
 182                         ( env.air && version >= 1 ) ||\r
 183                         ( env.webkit && version >= 522 ) ||\r
 184                         false;\r
 185 \r
 186                 // The CSS class to be appended on the main UI containers, making it\r
 187                 // easy to apply browser specific styles to it.\r
 188                 env.cssClass =\r
 189                         'cke_browser_' + (\r
 190                                 env.ie ? 'ie' :\r
 191                                 env.gecko ? 'gecko' :\r
 192                                 env.opera ? 'opera' :\r
 193                                 env.air ? 'air' :\r
 194                                 env.webkit ? 'webkit' :\r
 195                                 'unknown' );\r
 196 \r
 197                 if ( env.quirks )\r
 198                         env.cssClass += ' cke_browser_quirks';\r
 199 \r
 200                 if ( env.ie )\r
 201                 {\r
 202                         env.cssClass += ' cke_browser_ie' + (\r
 203                                 env.version < 7 ? '6' :\r
 204                                 env.version >= 8 ? '8' :\r
 205                                 '7' );\r
 206 \r
 207                         if ( env.quirks )\r
 208                                 env.cssClass += ' cke_browser_iequirks';\r
 209                 }\r
 210 \r
 211                 if ( env.gecko && version < 10900 )\r
 212                         env.cssClass += ' cke_browser_gecko18';\r
 213 \r
 214                 return env;\r
 215         })();\r
 216 }\r
 217 \r
 218 // PACKAGER_RENAME( CKEDITOR.env )\r
 219 // PACKAGER_RENAME( CKEDITOR.env.ie )\r