2 Copyright (c) 2003-2011, CKSource - Frederico Knabben. All rights reserved.
3 For licensing, see LICENSE.html or http://ckeditor.com/license
7 * @fileOverview Defines the {@link CKEDITOR.env} object, which constains
8 * environment and browser information.
14 * @namespace Environment and browser information.
16 CKEDITOR.env = (function()
18 var agent = navigator.userAgent.toLowerCase();
19 var opera = window.opera;
22 /** @lends CKEDITOR.env */
25 * Indicates that CKEditor is running on Internet Explorer.
28 * if ( CKEDITOR.env.ie )
29 * alert( "I'm on IE!" );
31 ie : /*@cc_on!@*/false,
34 * Indicates that CKEditor is running on Opera.
37 * if ( CKEDITOR.env.opera )
38 * alert( "I'm on Opera!" );
40 opera : ( !!opera && opera.version ),
43 * Indicates that CKEditor is running on a WebKit based browser, like
47 * if ( CKEDITOR.env.webkit )
48 * alert( "I'm on WebKit!" );
50 webkit : ( agent.indexOf( ' applewebkit/' ) > -1 ),
53 * Indicates that CKEditor is running on Adobe AIR.
56 * if ( CKEDITOR.env.air )
57 * alert( "I'm on AIR!" );
59 air : ( agent.indexOf( ' adobeair/' ) > -1 ),
62 * Indicates that CKEditor is running on Macintosh.
65 * if ( CKEDITOR.env.mac )
66 * alert( "I love apples!" );
68 mac : ( agent.indexOf( 'macintosh' ) > -1 ),
71 * Indicates that CKEditor is running on a quirks mode environemnt.
74 * if ( CKEDITOR.env.quirks )
77 quirks : ( document.compatMode == 'BackCompat' ),
80 * Indicates that CKEditor is running on a mobile like environemnt.
83 * if ( CKEDITOR.env.mobile )
84 * alert( "I'm running with CKEditor today!" );
86 mobile : ( agent.indexOf( 'mobile' ) > -1 ),
89 * Indicates that CKEditor is running on Apple iPhone/iPad/iPod devices.
92 * if ( CKEDITOR.env.iOS )
93 * alert( "I like little apples!" );
95 iOS : /(ipad|iphone|ipod)/.test(agent),
98 * Indicates that the browser has a custom domain enabled. This has
99 * been set with "document.domain".
100 * @returns {Boolean} "true" if a custom domain is enabled.
102 * if ( CKEDITOR.env.isCustomDomain() )
103 * alert( "I'm in a custom domain!" );
105 isCustomDomain : function()
110 var domain = document.domain,
111 hostname = window.location.hostname;
113 return domain != hostname &&
114 domain != ( '[' + hostname + ']' ); // IPv6 IP support (#5434)
118 * Indicates that page is running under an encrypted connection.
119 * @returns {Boolean} "true" if the page has an encrypted connection.
121 * if ( CKEDITOR.env.secure )
122 * alert( "I'm in SSL!" );
124 secure : location.protocol == 'https:'
128 * Indicates that CKEditor is running on a Gecko based browser, like
130 * @name CKEDITOR.env.gecko
133 * if ( CKEDITOR.env.gecko )
134 * alert( "I'm riding a gecko!" );
136 env.gecko = ( navigator.product == 'Gecko' && !env.webkit && !env.opera );
140 // Internet Explorer 6.0+
143 version = parseFloat( agent.match( /msie (\d+)/ )[1] );
146 * Indicates that CKEditor is running on Internet Explorer 8.
147 * @name CKEDITOR.env.ie8
150 * if ( CKEDITOR.env.ie8 )
151 * alert( "I'm on IE8!" );
153 env.ie8 = !!document.documentMode;
156 * Indicates that CKEditor is running on Internet Explorer 8 on
158 * @name CKEDITOR.env.ie8Compat
161 * if ( CKEDITOR.env.ie8Compat )
162 * alert( "Now I'm on IE8, for real!" );
164 env.ie8Compat = document.documentMode == 8;
167 * Indicates that CKEditor is running on Internet Explorer 9's standards mode.
168 * @name CKEDITOR.env.ie9Compat
171 * if ( CKEDITOR.env.ie9Compat )
172 * alert( "IE9, the beauty of the web!" );
174 env.ie9Compat = document.documentMode == 9;
177 * Indicates that CKEditor is running on an IE7-like environment, which
178 * includes IE7 itself and IE8's IE7 document mode.
179 * @name CKEDITOR.env.ie7Compat
182 * if ( CKEDITOR.env.ie8Compat )
183 * alert( "I'm on IE7 or on an IE7 like IE8!" );
185 env.ie7Compat = ( ( version == 7 && !document.documentMode )
186 || document.documentMode == 7 );
189 * Indicates that CKEditor is running on an IE6-like environment, which
190 * includes IE6 itself and IE7 and IE8 quirks mode.
191 * @name CKEDITOR.env.ie6Compat
194 * if ( CKEDITOR.env.ie6Compat )
195 * alert( "I'm on IE6 or quirks mode!" );
197 env.ie6Compat = ( version < 7 || env.quirks );
203 var geckoRelease = agent.match( /rv:([\d\.]+)/ );
206 geckoRelease = geckoRelease[1].split( '.' );
207 version = geckoRelease[0] * 10000 + ( geckoRelease[1] || 0 ) * 100 + ( geckoRelease[2] || 0 ) * 1;
213 version = parseFloat( opera.version() );
216 // Checked before Safari because AIR have the WebKit rich text editor
217 // features from Safari 3.0.4, but the version reported is 420.
219 version = parseFloat( agent.match( / adobeair\/(\d+)/ )[1] );
221 // WebKit 522+ (Safari 3+)
223 version = parseFloat( agent.match( / applewebkit\/(\d+)/ )[1] );
226 * Contains the browser version.<br />
228 * For gecko based browsers (like Firefox) it contains the revision
229 * number with first three parts concatenated with a padding zero
230 * (e.g. for revision 1.9.0.2 we have 10900).<br />
232 * For webkit based browser (like Safari and Chrome) it contains the
233 * WebKit build version (e.g. 522).
234 * @name CKEDITOR.env.version
237 * if ( CKEDITOR.env.ie && <b>CKEDITOR.env.version</b> <= 6 )
240 env.version = version;
243 * Indicates that CKEditor is running on a compatible browser.
244 * @name CKEDITOR.env.isCompatible
247 * if ( CKEDITOR.env.isCompatible )
248 * alert( "Your browser is pretty cool!" );
252 // White list of mobile devices that supports.
253 env.iOS && version >= 534 ||
257 ( env.ie && version >= 6 ) ||
258 ( env.gecko && version >= 10801 ) ||
259 ( env.opera && version >= 9.5 ) ||
260 ( env.air && version >= 1 ) ||
261 ( env.webkit && version >= 522 ) ||
265 * The CSS class to be appended on the main UI containers, making it
266 * easy to apply browser specific styles to it.
267 * @name CKEDITOR.env.cssClass
270 * myDiv.className = CKEDITOR.env.cssClass;
275 env.gecko ? 'gecko' :
276 env.opera ? 'opera' :
277 env.webkit ? 'webkit' :
281 env.cssClass += ' cke_browser_quirks';
285 env.cssClass += ' cke_browser_ie' + (
286 env.version < 7 ? '6' :
287 env.version >= 8 ? document.documentMode:
291 env.cssClass += ' cke_browser_iequirks';
294 if ( env.gecko && version < 10900 )
295 env.cssClass += ' cke_browser_gecko18';
298 env.cssClass += ' cke_browser_air';
304 // PACKAGER_RENAME( CKEDITOR.env )
305 // PACKAGER_RENAME( CKEDITOR.env.ie )