Dojo 0.4.2rc1 XDomain Web Build Tool
There are two ways to use this xdomain build:
- Use the XDomain Ajax Build directly
from this web server. To see what modules are included in the Ajax
build, go to the web build tool and select the "ajax" standard profile.
You can build that profile and look at the output at the bottom of the
page to see all of the files/modules in the build.
-
Create a custom dojo.js build using the web build tool, and use the
xdomain build on this server to load all other modules and associated
files.
XDomain Ajax Build
To use 0.4.2rc1 XDomain Ajax build, just include this script tag in
your page:
<script
type="text/javascript"
src="http://build.dojotoolkit.org/0.4.2rc1/dojo.js"></script>
There are some modules that require some special setup to use in the
xdomain build:
Widget automatic loading
- xdomain loading does not support automatic loading
of Dojo or custom widgets. You must explicitly include widgets you want
to use by using dojo.require() statements for widgets you want to use.
dojo.debugDeep()
- Save src/debug/deep.html to your local server and set djConfig.dojoDebugDeepHtmlUrl to the location of that file.
dojo.flash
- This module uses document.write(), so you must do a custom web build that includes the following modules to use it:
dojo.io.createIFrame()
- Save iframe_history.html
to your local server and set djConfig.dojoIframeHistoryUrl
to the location of that file.
dojo.rpc.YahooService
- Save yahoo.smd to your local server and set djConfig.yahooServiceSmdUrl to the location of that file.
dojo.storage
- This module uses document.write(), so you must do a custom web build that includes the following modules to use it:
- dojo.event.*
- dojo.storage
dojo.undo.browser
- Save iframe_history.html
to your local server and set djConfig.dojoIframeHistoryUrl
to the location of that file.
- If you do a custom build using the web tool and want to use
dojo.undo.browser, be sure to include it in dojo.js. Do not load it
after dojo.js loads, otherwise it will not work.
dojo.widget.GoogleMap
- Does not seem to work even if you include dojo.widget.GoogleMap in a custom build.
dojo.widget.Editor2, dojo.widget.Editor, dojo.widget.RichText
- Save richtextframe.html
to your local server and set djConfig.dojoRichTextFrameUrl to
the location of that file.
More information on XDomain builds: Cross
Domain Resource Loading. If you use the dojo.js URL above for
the xdomain ajax build, you do not need to set any djConfig parameters
for it to work. You also do not need a local dojo installation on your
server.
Web Build Tool
To build a custom dojo.js with the modules you use the most, use the
Web Build Tool
(still experimental).
Save the dojo.js generated from the web build to your server, and for
any modules that are not in that dojo.js, the xdomain ajax build
mentioned above will be used to load them. The special setup for
specific modules mentioned the XDomain
Ajax Build section still apply, even if those modules are
in your dojo.js file.