Cross-browser Support

Authors:Yoshiroh Kamiyama supports not only webkit-based mobile browsers, but also non-CSS3 desktop PC browsers such as IE and (older) Firefox. A CSS3 compatibility module ( is provided to support non-CSS3 browsers. is not necessary for webkit-based browsers, hence, it does not degrade performance of mobile browsers.

Typical Use

As of Dojo 1.7, with AMD loading you can now simply require dojox/mobile/compat as follows:

require(["dojox/mobile", "dojox/mobile/compat"], function(mobile, compat){
    // Do something with dojo mobile...

In previous versions, typical usage would be to do conditional loading with dojo.requireIf() as follows. The code below is an alternative way to loads only when dojo.isWebKit is true and using the pre 1.7-style synchronous loader.

dojo.requireIf(!dojo.isWebKit, "");

Once dojox/mobile/compat is loaded, it directly replaces some of the methods of the widgets instead of subclassing. This way your applications do not need to be changed, and html pages remains the same regardless of whether this compatibility module is used or not.

dojox/mobile/compat simply uses traditional HTML/CSS techniques, rather than modern approaches using CSS3. For example, images are used for buttons, gradient colors, rounded corners, etc. For transition animations, dojo/fx (JavaScript animation package) is used.

dojox/mobile/compat automatically loads the compatibility CSS files. It searches the current page for <link> elements or @import directives in a <style> element, and tries to load corresponding -compat.css files. For example, if it finds .../themes/iphone/iphone.css, it loads .../themes/iphone/iphone-compat.css. (Note: in dojo-1.5 searches only for <link> elements, but the one in dojo-1.6 or later searches for @import as well.)

Error in the documentation? Can’t find what you are looking for? Let us know!