Mobile theme system

You can use the Dojo mobile theme in EGL mobile web application. When you preview an RUI handler that contains mobile widgets, manually appending a theme parameter to the query parameter in the location bar of the browser switches the RUI handler to the associated theme. For more information about the theme parameters, see http://dojotoolkit.org/reference-guide/1.9/dojox/mobile/deviceTheme.html.

For example, normally an EGL RUI handler preview URL looks like: http://localhost:5590/pkg/myHandler.html?contextKey=16. The following are two different themes that are applied to the same EGL RUI handler.

When append theme=Android is added to the query parameter list, the RUI handler loads specified Android theme. The resulting URL looks like: http://localhost:5590/pkg/myHandler.html?contextKey=16&theme=Android.
When append theme=iPad is added to the parameter list, the RUI handler loads the specified iPad theme. The resulting URL looks like: http://localhost:5590/pkg/myHandler.html?contextKey=16&theme=iPad.

Currently there are Android, Holodark, BlackBerry, Custom, iPhone and iPad themes that are defined by Dojo mobile framework. If you leave it empty, the Dojo mobile framework automatically loads themes based on the device it detects.

Tip: Sometimes you do not want the theme parameter to be displayed in the query URL’s parameter list and want to permanently apply a theme. Besides, it is also not possible to manually add the theme parameter to the request URL in the location bar inside of the visual editor’s EGL preview panel. Under such circumstances, you can open file: com.ibm.egl.rui.Dojo.mobile.widgets_x.x.x/WebContents/includeDojo.html and locate the following code snippet in the editor:

...	
var DojoConfig = {
// Below theme options are available for Dojo mobile widgets(Case-sensitive):
// Android, Holodark, BlackBerry, Custom, iPhone, iPad
// Leave it empty will let Dojo mobile automatically load 
// device associated theme
			mblUserAgent: '', 
...

Assign the mblUserAgent property to the theme you want to be used. Then, the whole EGL mobile web application will switch to this theme permanently during and after deployment.