dojo.js的官方描述

Dojo

Dojo is divided into two parts: dojo.js , and the rest of Dojo Core. Typically, if a function or Class exists within the dojo namespace directly (eg: dojo.require() , dojo.addOnLoad() ) it is provided directly by dojo.js . If the function or Class exists beneath the dojo namespace (eg: dojo.dnd.Mover ), you will need to require the appropriate module (eg: dojo.require("dojo.dnd.Mover"); )

These pages cover both cases, and indicate how they are provided.

Base Dojo: dojo.js

Dojo Base is the functionality you get by just including a stock built dojo.js or dojo.xd.js in your page.

Configuring Dojo

• djConfig

  Possibility to override certain global settings that control how the framework operates

Array utilities

Details on dojo.every, dojo.filter, dojo.forEach, dojo.indexOf, dojo.lastIndexOf, dojo.map, and dojo.some. See the Array QuickStart for an overview.

• dojo.forEach

  Invokes a callback function for every item in array

• dojo.map

  Applies a callback to each element of arr and returns an Array with the results

• dojo.some

  Iterate over an array, escaping when the callback returns true for some logic check.

• dojo.every

  Iterate over an array, escaping when the callback returns false for some logic check.

• dojo.filter

  Iterate over an array, reducing the array based on the callback return.

• dojo.indexOf

  Find the index of some element in an Array.

• NodeList array methods

  • NodeList.indexOf, NodeList.lastIndexOf, NodeList.forEach, NodeList.every, NodeList.some, NodeList.concat, NodeList.map, NodeList.filter, NodeList.at

Language Utilities

• dojo.Deferred

  Communication between threads

• dojo.hitch

  Function that generates a wrapper function that ensures a function that will only ever execute in a defined scope.

• dojo.partial

  Function that generates a wrapper function that ensures a function will only ever execute globally.

• dojo.delegate

  Returns a new object which “looks” to obj for properties which it does not have a value for.

• dojo.isString

  Checks if the parameter is a String

• dojo.isArray

  Checks if the parameter is an Array

• dojo.isFunction

  Checks if the parameter is a Function

• dojo.isObject

  Checks if the parameter is an Object

• dojo.isArrayLike

  Checks if the parameter is like an Array

• dojo.isAlien

  Checks if the parameter is a built-in function

String Utilities

• dojo.trim

  Trim whitespace from a String

• dojo.replace

  Simple templates with parameterized substitutions.

DOM

• dojo.query

  The swiss army knife of DOM node manipulation in Dojo.

• dojo.NodeList

  A class to handle a list of DOM nodes. Most commonly returned from a dojo.query call.

• dojo.doc

  Alias for the current document

• dojo.body

  Return the body element of the document

• dojo.byId

  Select a DOM node by ‘id’

• Manipulation

  • dojo.create

    Creates a dom node with optional values and placement

  • dojo.place

    Place DOM nodes relative to others

  • NodeList.place

    Place DOM nodes in list relative to others

  • NodeList.orphan

  • NodeList.adopt

  • NodeList.clone

  • NodeList.addContent

  • dojo.destroy

    Destroy a DOM element

  • dojo.empty

    Empty the contents of a DOM element

  • NodeList.empty

• Attributes

  • dojo.formToJson

    Create an object from an form node

  • dojo.attr

    Modifying DOM node attributes

  • dojo.NodeList.attr

    Set/Get attributes for nodes in the list

  • dojo.hasAttr

  • dojo.removeAttr

  • dojo.getNodeProp

  • dojo.formToObject

  • dojo.formToQuery

  • dojo.isDescendant

  • dojo.setSelectable

• Styles

  • dojo.coords

    Getter for the coordinates (relative to parent and absolute) of a DOM node. Deprecated in Dojo 1.4.

  • NodeList.coords

    Getter for the coordinates of each node in the list. Deprecated in Dojo 1.4.

  • dojo.position

    Getter for the border-box x/y coordinates and size of a DOM node.

  • NodeList.position

    Calls dojo.position for each node in the list and returns those objects as an Array.

  • dojo.style

    A getter/setter for styles on a DOM node

  • dojo.getComputedStyle

    Return a cachable object of all computed styles for a node

  • Class Utilities

    • dojo.hasClass

      Returns a boolean depending on whether or not a node has a passed class string.

    • dojo.addClass

      Adds a CSS class to a node.

    • dojo.removeClass

      Removes a class from a Node.

    • dojo.toggleClass

      Toggles a className (or now in 1.4 an array of classNames).

  • dojo.marginBox

    Getter/setter for the margin-box of node

  • dojo.contentBox

    Getter/setter for the content-box of node

Effects

• dojo.animateProperty

  The workhorse of most dojo.fx animations. Used for animating CSS properties

• dojo.Animation

  1.4+ previously dojo._Animation, the class behind all dojo.fx

• dojo.anim

  Shorthand version of animateProperty using positional arguments

• dojo.fadeOut

• dojo.fadeIn

Events

• dojo.connect

  Connects events to methods

• NodeList.connect

  Connects events to every node in the list, like dojo.connect

• NodeList.events

  Common event names mapped as functions on a NodeList - eg: .onclick(function(){})

• dojo.disconnect

  Disconnects methods from linked topics

• dojo.subscribe

  Linked a listener to a named topic

• dojo.unsubscribe

  Remove a topic listener

• dojo.publish

  Publish an event to all subscribers of a topic

• dojo.connectPublisher

  Ensure that everytime an event is called, a message is published on the topic.

• dojo.stopEvent

  Stop an event’s bubbling and propagation.

Document Lifecycle

• dojo.addOnLoad

  Call functions after the DOM has finished loading and widgets declared in markup have been instantiated

• dojo.ready

  1.4+ Alias for dojo.addOnLoad

• dojo.addOnUnload

  Call functions when the page unloads

• dojo.addOnWindowUnload

  Call functions when window.onunload fires

• dojo.windowUnloaded

  Signal fired by impending window destruction

Ajax / IO

• IO Pipeline Topics

• dojo.contentHandlers

  1.4+ Pre-defined XHR content handlers, and an extension point to add your own custom handling.

• dojo.xhr

  Core for all xhr* verbs, eg: xhrPost, getGet

• dojo.xhrDelete

• dojo.xhrGet

• dojo.xhrPost

• dojo.xhrPut

• dojo.rawXhrPost

• dojo.rawXhrPut

Package System

• dojo.registerModulePath

  Maps module name to a path

• dojo.require

  Loads a Javascript module from the appropriate URI

• dojo.provide

• dojo.moduleUrl

JSON Tools

• dojo.fromJson

  Parses a JSON string to return a JavaScript object

• dojo.toJson

  Returns a JSON serialization of an object

Objects / OO Tools

• dojo.mixin

  Mixes one object into another. Can be used as a shallow copy

• dojo.declare

  Creates a constructor using a compact notation for inheritance and prototype extension

• dojo.extend

• dojo.exists

  Determine if an object supports a given method

• dojo.delegate

  Delegate an Object (beget)

• dojo.getObject

  Get a property from a dot-separated string, such as “A.B.C”

• dojo.setObject

  Set a property from a dot-separated string, such as “A.B.C”

• dojo.objectToQuery

• dojo.queryToObject

• NodeList.instantiate

  Create classes out of each node in the list

Colors

• dojo._base.Color

  Color object and utility functions to handle colors. Details on

• dojo.colorFromArray

• dojo.colorFromHex

• dojo.colorFromString

• dojo.colorFromRgb.

Miscellaneous Base

• dojo.deprecated

  Log a debug message to indicate that a behavior has been deprecated

• dojo.eval

  Evaluate some string of JavaScript

• dojo.global

  Alias for the global scope

• dojo.keys

  A collection of key constants.

• dojo.locale

  A string containing the current locale as defined by Dojo

• dojo.setContext

  Changes the behavior of many core Dojo functions that deal with namespace and DOM lookup

• dojo.version

  The current version number of Dojo

• dojo.withDoc

  Call callback with documentObject as dojo.doc

• dojo.withGlobal

  Call callback with globalObject as dojo.global and globalObject.document as dojo.doc

Dojo Core

• dojo.AdapterRegistry

  A registry to make contextual calling/searching easier

• dojo.back

  Browser history management resources (Back button functionality)

• dojo.behavior

  Utility for unobtrusive/progressive event binding, DOM traversal, and manipulation

• dojo.cldr

  A Common Locale Data Repository (CLDR) implementation

• dojo.cache

  1.4+ A mechanism to cache inline text.

• dojo.colors

  CSS color manipulation functions

• dojo.cookie

  Simple HTTP cookie manipulation

• dojo.currency

  Localized formatting and parsing routines for currency data

• dojo.data

  A uniform data access layer

  • dojo.data.api
  • dojo.data.api.Read
  • dojo.data.api.Write
  • dojo.data.api.Identity
  • dojo.data.api.Notification
  • dojo.data.ItemFileReadStore
  • dojo.data.ItemFileWriteStore

• dojo.date

  Date manipulation utilities

  • dojo.date.locale

    Offers a library of localization methods to format and parse dates and times

    • dojo.date.locale.addCustomFormats

      Adds a reference to a bundle containing localized custom formats to be used by date/time formatting and parsing routines.

    • dojo.date.locale.format

      Formats a Date object as a String, using locale-specific settings or custom patterns.

    • dojo.date.locale.getNames

      Used to get localized strings from dojo.cldr for day or month names.

    • dojo.date.locale.isWeekend

      Determines if the date falls on a weekend, according to local custom.

    • dojo.date.locale.parse

      Converts a properly formatted string to a primitive Date object, using locale-specific settings.

    • dojo.date.locale.regexp

      Builds the regular needed to parse a localized date

• dojo.DeferredList

  Event handling for a group of Deferred objects

• dojo.dnd

  Drag and Drop

  • dojo.dnd.Moveable

• dojo.fx

  Effects library on top of Base animations

• dojo.gears

  Google Gears

• dojo.hash

  Normalized onhashchange module

• dojo.html

  Inserting contents in HTML nodes

• dojo.i18n

  Utility classes to enable loading of resources for internationalization

• Additional AJAX I/O transports (dojo.io)

  • dojo.io.iframe

    Sends an AJAX I/O call using an IFrame

  • dojo.io.script

    Sends a JSONP request using a script tag

• dojo.jaxer

• dojo.NodeList-data

  Adds a .data() and .removeData() API to dojo.query operations

• dojo.NodeList-fx

  Adds dojo.fx animation support to dojo.query()

• dojo.NodeList-html

  Adds a chainable html method to dojo.query()

• dojo.NodeList-manipulate

  1.4+ Method extensions to dojo.NodeList/dojo.query() that manipulate HTML.

• dojo.NodeList-traverse

  1.4+ Method extensions to dojo.NodeList/dojo.query() for traversing the DOM.

• dojo.number

  Localized formatting and parsing methods for number data

• dojo.parser

  The Dom/Widget parsing package

• dojo.regexp

  Regular expressions and Builder resources

• dojo.robot

  experimental module for DOH users

• dojo.robotx

  experimental module for DOH users

• dojo.rpc

  Communicate via Remote Procedure Calls (RPC) with Backend Servers

  • dojo.rpc.JsonpService

    Generic JSONP service

  • dojo.rpc.JsonService

    JSON RPC service

  • dojo.rpc.RpcService

    RPC service class

• dojo.string

  String utilities for Dojo

See also

• Dijit

  The widget system layered on top of Dojo

• DojoX

  An area for development of extensions to the Dojo toolkit