X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/c930e9176a5a85509c5b0230e2bff5c22a591432..7a654f8d43fdb43d78b63d90528bed6e86b608cc:/docs/source/Browser.html
diff --git a/docs/source/Browser.html b/docs/source/Browser.html
new file mode 100644
index 00000000..f3dddc1f
--- /dev/null
+++ b/docs/source/Browser.html
@@ -0,0 +1,176 @@
+Sencha Documentation Project/**
+ * @class Ext.env.Browser
+ * @extends Ext.Base
+ * Provide useful information about the current browser.
+ * Should not be manually instantiated unless for unit-testing; access the global instance stored in Ext.browser instead. Example:
+ * <pre><code>
+ * if (Ext.browser.is.IE) {
+ * // IE specific code here
+ * }
+ *
+ * if (Ext.browser.is.WebKit) {
+ * // WebKit specific code here
+ * }
+ *
+ * console.log("Version " + Ext.browser.version);
+ * </code></pre>
+ *
+ * For a full list of supported values, refer to: {@link Ext.env.Browser#is}
+ *
+ * @borrows Ext.Base.extend
+ */
+Ext.define('Ext.env.Browser', {
+ statics: {
+ browserNames: {
+ ie: 'IE',
+ firefox: 'Firefox',
+ safari: 'Safari',
+ chrome: 'Chrome',
+ opera: 'Opera',
+ other: 'Other'
+ },
+ engineNames: {
+ webkit: 'WebKit',
+ gecko: 'Gecko',
+ presto: 'Presto',
+ trident: 'Trident',
+ other: 'Other'
+ },
+ enginePrefixes: {
+ webkit: 'AppleWebKit/',
+ gecko: 'Gecko/',
+ presto: 'Presto/',
+ trident: 'Trident/'
+ },
+ browserPrefixes: {
+ ie: 'MSIE ',
+ firefox: 'Firefox/',
+ chrome: 'Chrome/',
+ safari: 'Version/',
+ opera: 'Opera/'
+ }
+ },
+
+ /**
+ * True if the page is running over SSL
+ * @type Boolean
+ */
+ isSecure: false,
+
+ /**
+ * True if the document is in strict mode
+ * @type Boolean
+ */
+ isStrict: false,
+
+ /**
+ * A "hybrid" property, can be either accessed as a method call, i.e:
+ * <pre><code>
+ * if (Ext.browser.is('IE')) { ... }
+ * </code></pre>
+ *
+ * or as an object with boolean properties, i.e:
+ * <pre><code>
+ * if (Ext.browser.is.IE) { ... }
+ * </code></pre>
+ *
+ * Versions can be conveniently checked as well. For example:
+ * <pre><code>
+ * if (Ext.browser.is.IE6) { ... } // Equivalent to (Ext.browser.is.IE && Ext.browser.version.equals(6))
+ * </code></pre>
+ *
+ * Note that only {@link Ext.Version#getMajor major component} and {@link Ext.Version#getShortVersion shortVersion}
+ * value of the version are available via direct property checking.
+ *
+ * Supported values are: IE, Firefox, Safari, Chrome, Opera, WebKit, Gecko, Presto, Trident and Other
+ *
+ * @param {String} value The OS name to check
+ * @return {Boolean}
+ */
+ is: Ext.emptyFn,
+
+ /**
+ * Read-only - the full name of the current browser
+ * Possible values are: IE, Firefox, Safari, Chrome, Opera and Other
+ * @type String
+ */
+ name: null,
+
+ /**
+ * Read-only, refer to {@link Ext.Version}
+ * @type Ext.Version
+ */
+ version: null,
+
+ /**
+ * Read-only - the full name of the current browser's engine
+ * Possible values are: WebKit, Gecko, Presto, Trident and Other
+ * @type String
+ */
+ engineName: null,
+
+ /**
+ * Read-only, refer to {@link Ext.Version}
+ * @type Ext.Version
+ */
+ engineVersion: null,
+
+ constructor: function() {
+ var userAgent = this.userAgent = Ext.global.navigator.userAgent,
+ selfClass = this.statics(),
+ browserMatch = userAgent.match(new RegExp('((?:' + Ext.Object.getValues(selfClass.browserPrefixes).join(')|(?:') + '))([\\d\\._]+)')),
+ engineMatch = userAgent.match(new RegExp('((?:' + Ext.Object.getValues(selfClass.enginePrefixes).join(')|(?:') + '))([\\d\\._]+)')),
+ browserName = selfClass.browserNames.other,
+ browserVersion = '',
+ engineName = selfClass.engineNames.other,
+ engineVersion = '';
+
+ this.is = function(name) {
+ return this.is[name] === true;
+ };
+
+ if (browserMatch) {
+ browserName = selfClass.browserNames[Ext.Object.getKey(selfClass.browserPrefixes, browserMatch[1])];
+ browserVersion = browserMatch[2];
+ }
+
+ if (engineMatch) {
+ engineName = selfClass.engineNames[Ext.Object.getKey(selfClass.enginePrefixes, engineMatch[1])];
+ engineVersion = engineMatch[2];
+ }
+
+ Ext.apply(this, {
+ engineName: engineName,
+ engineVersion: new Ext.Version(engineVersion),
+ name: browserName,
+ version: new Ext.Version(browserVersion)
+ });
+
+ this.is[this.name] = true;
+ this.is[this.name + (this.version.getMajor() || '')] = true;
+ this.is[this.name + this.version.getShortVersion()] = true;
+ Ext.Object.each(selfClass.browserNames, function(key, name) {
+ this.is[name] = (this.name === name);
+ }, this);
+
+ this.is[this.name] = true;
+ this.is[this.engineName + (this.engineVersion.getMajor() || '')] = true;
+ this.is[this.engineName + this.engineVersion.getShortVersion()] = true;
+ Ext.Object.each(selfClass.engineNames, function(key, name) {
+ this.is[name] = (this.engineName === name);
+ }, this);
+
+
+ this.isSecure = /^https/i.test(Ext.global.location.protocol);
+
+ this.isStrict = Ext.global.document.compatMode === "CSS1Compat";
+
+ return this;
+ }
+
+}, function() {
+
+ Ext.browser = new Ext.env.Browser();
+
+});
+
\ No newline at end of file