_source/core/env.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.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                         mobile : ( agent.indexOf( 'mobile' ) > -1 ),\r
  75 \r
  76                         isCustomDomain : function()\r
  77                         {\r
  78                                 return this.ie && document.domain != window.location.hostname;\r
  79                         }\r
  80                 };\r
  81 \r
  82                 /**\r
  83                  * Indicates that CKEditor is running on a Gecko based browser, like\r
  84                  * Firefox.\r
  85                  * @name CKEDITOR.env.gecko\r
  86                  * @type Boolean\r
  87                  * @example\r
  88                  * if ( CKEDITOR.env.gecko )\r
  89                  *     alert( "I'm riding a gecko!" );\r
  90                  */\r
  91                 env.gecko = ( navigator.product == 'Gecko' && !env.webkit && !env.opera );\r
  92 \r
  93                 var version = 0;\r
  94 \r
  95                 // Internet Explorer 6.0+\r
  96                 if ( env.ie )\r
  97                 {\r
  98                         version = parseFloat( agent.match( /msie (\d+)/ )[1] );\r
  99 \r
 100                         /**\r
 101                          *  Indicate IE8 browser.\r
 102                          */\r
 103                         env.ie8 = !!document.documentMode;\r
 104 \r
 105                         /**\r
 106                          * Indicte IE8 document mode.\r
 107                          */\r
 108                         env.ie8Compat = document.documentMode == 8;\r
 109 \r
 110                         /**\r
 111                          * Indicates that CKEditor is running on an IE7-like environment, which\r
 112                          * includes IE7 itself and IE8's IE7 document mode.\r
 113                          * @type Boolean\r
 114                          */\r
 115                         env.ie7Compat = ( ( version == 7 && !document.documentMode )\r
 116                                         || document.documentMode == 7 );\r
 117 \r
 118                         /**\r
 119                          * Indicates that CKEditor is running on an IE6-like environment, which\r
 120                          * includes IE6 itself and IE7 and IE8 quirks mode.\r
 121                          * @type Boolean\r
 122                          * @example\r
 123                          * if ( CKEDITOR.env.ie6Compat )\r
 124                          *     alert( "I'm on IE6 or quirks mode!" );\r
 125                          */\r
 126                         env.ie6Compat = ( version < 7 || env.quirks );\r
 127 \r
 128                 }\r
 129 \r
 130                 // Gecko.\r
 131                 if ( env.gecko )\r
 132                 {\r
 133                         var geckoRelease = agent.match( /rv:([\d\.]+)/ );\r
 134                         if ( geckoRelease )\r
 135                         {\r
 136                                 geckoRelease = geckoRelease[1].split( '.' );\r
 137                                 version = geckoRelease[0] * 10000 + ( geckoRelease[1] || 0 ) * 100 + ( geckoRelease[2] || 0 ) * 1;\r
 138                         }\r
 139                 }\r
 140 \r
 141                 // Opera 9.50+\r
 142                 if ( env.opera )\r
 143                         version = parseFloat( opera.version() );\r
 144 \r
 145                 // Adobe AIR 1.0+\r
 146                 // Checked before Safari because AIR have the WebKit rich text editor\r
 147                 // features from Safari 3.0.4, but the version reported is 420.\r
 148                 if ( env.air )\r
 149                         version = parseFloat( agent.match( / adobeair\/(\d+)/ )[1] );\r
 150 \r
 151                 // WebKit 522+ (Safari 3+)\r
 152                 if ( env.webkit )\r
 153                         version = parseFloat( agent.match( / applewebkit\/(\d+)/ )[1] );\r
 154 \r
 155                 /**\r
 156                  * Contains the browser version.\r
 157                  *\r
 158                  * For gecko based browsers (like Firefox) it contains the revision\r
 159                  * number with first three parts concatenated with a padding zero\r
 160                  * (e.g. for revision 1.9.0.2 we have 10900).\r
 161                  *\r
 162                  * For webkit based browser (like Safari and Chrome) it contains the\r
 163                  * WebKit build version (e.g. 522).\r
 164                  * @name CKEDITOR.env.version\r
 165                  * @type Boolean\r
 166                  * @example\r
 167                  * if ( CKEDITOR.env.ie && <b>CKEDITOR.env.version</b> <= 6 )\r
 168                  *     alert( "Ouch!" );\r
 169                  */\r
 170                 env.version = version;\r
 171 \r
 172                 /**\r
 173                  * Indicates that CKEditor is running on a compatible browser.\r
 174                  * @name CKEDITOR.env.isCompatible\r
 175                  * @type Boolean\r
 176                  * @example\r
 177                  * if ( CKEDITOR.env.isCompatible )\r
 178                  *     alert( "Your browser is pretty cool!" );\r
 179                  */\r
 180                 env.isCompatible =\r
 181                         !env.mobile && (\r
 182                         ( env.ie && version >= 6 ) ||\r
 183                         ( env.gecko && version >= 10801 ) ||\r
 184                         ( env.opera && version >= 9.5 ) ||\r
 185                         ( env.air && version >= 1 ) ||\r
 186                         ( env.webkit && version >= 522 ) ||\r
 187                         false );\r
 188 \r
 189                 // The CSS class to be appended on the main UI containers, making it\r
 190                 // easy to apply browser specific styles to it.\r
 191                 env.cssClass =\r
 192                         'cke_browser_' + (\r
 193                                 env.ie ? 'ie' :\r
 194                                 env.gecko ? 'gecko' :\r
 195                                 env.opera ? 'opera' :\r
 196                                 env.air ? 'air' :\r
 197                                 env.webkit ? 'webkit' :\r
 198                                 'unknown' );\r
 199 \r
 200                 if ( env.quirks )\r
 201                         env.cssClass += ' cke_browser_quirks';\r
 202 \r
 203                 if ( env.ie )\r
 204                 {\r
 205                         env.cssClass += ' cke_browser_ie' + (\r
 206                                 env.version < 7 ? '6' :\r
 207                                 env.version >= 8 ? '8' :\r
 208                                 '7' );\r
 209 \r
 210                         if ( env.quirks )\r
 211                                 env.cssClass += ' cke_browser_iequirks';\r
 212                 }\r
 213 \r
 214                 if ( env.gecko && version < 10900 )\r
 215                         env.cssClass += ' cke_browser_gecko18';\r
 216 \r
 217                 return env;\r
 218         })();\r
 219 }\r
 220 \r
 221 // PACKAGER_RENAME( CKEDITOR.env )\r
 222 // PACKAGER_RENAME( CKEDITOR.env.ie )\r