JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
b289538a62adedfa0e6da2b93d65c70f2109a053
[ckeditor.git] / _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