dojo/_base/kernel.config (version 1.10)

Summary

This module defines the user configuration during bootstrap.

By defining user configuration as a module value, an entire configuration can be specified in a build, thereby eliminating the need for sniffing and or explicitly setting in the global variable dojoConfig. Also, when multiple instances of dojo exist in a single application, each will necessarily be located at an unique absolute module identifier as given by the package configuration. Implementing configuration as a module allows for specifying unique, per-instance configurations.

Examples

Example 1

Create a second instance of dojo with a different, instance-unique configuration (assume the loader and dojo.js are already loaded).

// specify a configuration that creates a new instance of dojo at the absolute module identifier "myDojo"
require({
    packages:[{
        name:"myDojo",
        location:".", //assume baseUrl points to dojo.js
    }]
});

// specify a configuration for the myDojo instance
define("myDojo/config", {
    // normal configuration variables go here, e.g.,
    locale:"fr-ca"
});

// load and use the new instance of dojo
require(["myDojo"], function(dojo){
    // dojo is the new instance of dojo
    // use as required
});

Property Summary

  • addOnLoadAdds a callback via dojo/ready.
  • afterOnLoad
  • baseUrl
  • callbackDefines a callback to be used when dependencies are defined before the loader has been loaded.
  • debugContainerId
  • debugHeight
  • defaultDurationDefault duration, in milliseconds, for wipe and fade animations within dijits.
  • deferredInstrumentationWhether deferred instrumentation should be loaded or included in builds.
  • depsDefines dependencies to be used before the loader has been loaded.
  • dojoBlankHtmlUrlUsed by some modules to configure an empty iframe.
  • extraLocaleNo default value.
  • ioPublishSet this to true to enable publishing of topics for the different phases of IO operations.
  • isDebugDefaults to false.
  • localeThe locale to assume for loading localized resources in this page, specified according to RFC 3066.
  • modulePathsA map of module names to paths relative to dojo.baseUrl.
  • parseOnLoadRun the parser after the page is loaded
  • requireAn array of module names to be loaded immediately after dojo.js has been included in a page.
  • transparentColorArray containing the r, g, b components used as transparent color in dojo.Color; if undefined, [255,255,255] (white) will be used.
  • urchinUsed by dojox.analytics.Urchin as the default UA-123456-7 account number used when being created.
  • useCustomLoggerIf set to a value that evaluates to true such as a string or array and isDebug is true and Firebug is not available or running, then it bypasses the creation of Firebug Lite allowing you to define your own console object.
  • useDeferredInstrumentationWhether the deferred instrumentation should be used. "report-rejections": report each rejection as it occurs. true or 1 or "report-unhandled-rejections": wait 1 second in an attempt to detect unhandled rejections.

Properties

addOnLoad
Defined by: dojo/_base/config

Adds a callback via dojo/ready. Useful when Dojo is added after the page loads and djConfig.afterOnLoad is true. Supports the same arguments as dojo/ready. When using a function reference, use djConfig.addOnLoad = function(){};. For object with function name use djConfig.addOnLoad = [myObject, "functionName"]; and for object with function reference use djConfig.addOnLoad = [myObject, function(){}];

afterOnLoad
Defined by: dojo/ready
baseUrl
Defined by: dojo/_base/kernel
callback
Defined by: dojo/_base/config

Defines a callback to be used when dependencies are defined before the loader has been loaded. When provided, they cause the loader to execute require(deps, callback) once it has finished loading. Should be used with deps.

debugContainerId
Defined by: dojo/_firebug/firebug
debugHeight
Defined by: dojo/robotx
defaultDuration
Defined by: dojo/_base/config

Default duration, in milliseconds, for wipe and fade animations within dijits. Assigned to dijit.defaultDuration.

deferredInstrumentation
Defined by: dojo/_base/config

Whether deferred instrumentation should be loaded or included in builds.

deps
Defined by: dojo/_base/config

Defines dependencies to be used before the loader has been loaded. When provided, they cause the loader to execute require(deps, callback) once it has finished loading. Should be used with callback.

dojoBlankHtmlUrl
Defined by: dojo/_base/config

Used by some modules to configure an empty iframe. Used by dojo/io/iframe and dojo/back, and dijit/popup support in IE where an iframe is needed to make sure native controls do not bleed through the popups. Normally this configuration variable does not need to be set, except when using cross-domain/CDN Dojo builds. Save dojo/resources/blank.html to your domain and set djConfig.dojoBlankHtmlUrl to the path on your domain your copy of blank.html.

extraLocale
Defined by: dojo/_base/config

No default value. Specifies additional locales whose resources should also be loaded alongside the default locale when calls to dojo.requireLocalization() are processed.

ioPublish
Defined by: dojo/_base/config

Set this to true to enable publishing of topics for the different phases of IO operations. Publishing is done via dojo/topic.publish(). See dojo/main.__IoPublish for a list of topics that are published.

isDebug
Defined by: dojo/_base/config

Defaults to false. If set to true, ensures that Dojo provides extended debugging feedback via Firebug. If Firebug is not available on your platform, setting isDebug to true will force Dojo to pull in (and display) the version of Firebug Lite which is integrated into the Dojo distribution, thereby always providing a debugging/logging console when isDebug is enabled. Note that Firebug's console.* methods are ALWAYS defined by Dojo. If isDebug is false and you are on a platform without Firebug, these methods will be defined as no-ops.

locale
Defined by: dojo/_base/config

The locale to assume for loading localized resources in this page, specified according to RFC 3066. Must be specified entirely in lowercase, e.g. en-us and zh-cn. See the documentation for dojo.i18n and dojo.requireLocalization for details on loading localized resources. If no locale is specified, Dojo assumes the locale of the user agent, according to navigator.userLanguage or navigator.language properties.

modulePaths
Defined by: dojo/_base/config

A map of module names to paths relative to dojo.baseUrl. The key/value pairs correspond directly to the arguments which dojo.registerModulePath accepts. Specifying djConfig.modulePaths = { "foo": "../../bar" } is the equivalent of calling dojo.registerModulePath("foo", "../../bar");. Multiple modules may be configured via djConfig.modulePaths.

parseOnLoad
Defined by: dojo/_base/config

Run the parser after the page is loaded

require
Defined by: dojo/_base/config

An array of module names to be loaded immediately after dojo.js has been included in a page.

transparentColor
Defined by: dojo/_base/config

Array containing the r, g, b components used as transparent color in dojo.Color; if undefined, [255,255,255] (white) will be used.

urchin

Used by dojox.analytics.Urchin as the default UA-123456-7 account number used when being created. Alternately, you can pass an acct:"" parameter to the constructor a la: new dojox.analytics.Urchin({ acct:"UA-123456-7" });

useCustomLogger
Defined by: dojo/_base/config

If set to a value that evaluates to true such as a string or array and isDebug is true and Firebug is not available or running, then it bypasses the creation of Firebug Lite allowing you to define your own console object.

useDeferredInstrumentation
Defined by: dojo/_base/config

Whether the deferred instrumentation should be used.

  • "report-rejections": report each rejection as it occurs.
  • true or 1 or "report-unhandled-rejections": wait 1 second in an attempt to detect unhandled rejections.
Error in the documentation? Can’t find what you are looking for? Let us know!