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