Hello Dojo
作者：Sam Foster
译者：ZhuXiaoWen
原文：
http://dojotoolkit.org/documentation/tutorials/1.6/hello_dojo/
欢迎使用Dojo!
在本教程中，我们将从最基础的部分——一个简单的
HTML
页面开始。当本教程结束的时候，我们就已将
Dojo
加载到页面中，并且开始使用一些核心函数了。为了给您提供更为丰富的学习体验，我们还将简单介绍
Dojo
的模块化架构，并讨论如何载入依赖模块。
难度：初学者
Dojo版本：
1.6
让我们开始吧～
我们的起点是一个如下所示的简单HTML
页面。我们希望在这个页面里添加一些代码来证明
Dojo
已经成功加载。
这很简洁，不是么？我们在<head>
里放了一个加载
Dojo
的
<script>
标签（当然它也可以放在
<body>
的最后），其中的
src
属性包含了
dojo.js
文件所在的
URL
。
本教程中我们通过GoogleCDN
加载
Dojo
。如果你已经下载了一个
Dojo
的发布版，你就可以把这里的
URL
改为
dojo.js
文件在你自己服务器上的位置。如果
URL
是正确的，那么
Dojo
现在已经在后台安静地加载好了。接下来我们需要找个地方放一些代码，在一切都准备好的时候运行，这样我们就能做些更有趣的事情了。
dojo.ready
由于牵涉到HTML
页面和浏览器，要确定“万事俱备”的时机可不容易。在我们自己的
JavaScript
代码开始运行之前，首先
DOM
树需要准备好以供操作，而且
Dojo
库（以及声明的任何依赖模块）也需要全部加载完毕。因为“万事俱备”这个概念在不同的浏览器里是不同的，所以
Dojo
干脆为此提供了一个非常可靠的、跨浏览器的函数——
dojo.ready
。我们给它传一个函数作为参数，这个函数就会在“万事俱备”的时候执行。
我们传给dojo.ready
的这个函数应该会在页面加载好以后弹出一个
alert
对话框。必须承认，
Dojo
的
version
属性（包含版本信息）对于此类示例程序非常有用。当我们以后更为深入地学习
Dojo
时，这样的
alert
对话框就会变得越来越讨厌了。于是我们就会想要学习往浏览器控制台打印日志的方法。不过目前我们暂时略过。
能加载Dojo
的确不错，但您一定更希望操作这个刚刚载入了
Dojo
的页面。我们将会在其他教程中深入讲解这方面的内容。而现在，我们只是简单地获取我们的
<h1>
元素的引用然后更新其内容。
这次，在我们的“万事俱备”函数里使用了dojo.byId
来获取
DOM
树中含有给定
ID
的元素，然后给它的
innerHTML
属性添加
Dojo
的版本信息字符串。
需要特别注意的是，您可以对dojo.ready
做任意次调用。您每一次传入的这些函数会按照传入顺序依次执行。实际上，如果您有比较多的代码，常见的做法是定义一个具名函数（非匿名函数）然后把函数名传给
dojo.ready
：
请注意，当我们传入函数的时候，我们只是在传函数名，而不包括其后的任何参数。
如果您是冲着Dojo
的
Hello World
来的，那么本教程早已结束了。但之前我们曾提到过“声明依赖模块”——让我们来聊聊这个吧。
模块
可见的东西往往只是冰山一角。Dojo.js
到底给您带来了什么？
Dojo
是一个模块化的工具箱，它有一个“包系统”，能让您只加载您在页面中需要的代码，并使得代码之间的依赖管理变得非常简单。缺乏语言级别的用于加载代码的包系统（类似于
Java,PHP,Python
等语言中的
import
或
require
），是一个长久以来困扰
JavaScript
开发人员的问题。
Dojo
利用一种非常符合直觉的方法组织代码，并提供了一个简单的
API
（
dojo.require
）用于声明对某个特定模块的依赖。
这一点对于目前的意义，就是当我们加载dojo.js
时，并没有去加载整个
dojo
工具箱，而仅仅是一些基础（
base
）模块。我们加载
Dojo
的
<script>
标签实际载入的是一组核心功能，例如包系统、事件、
Ajax
、
DOM
工具函数、以及其他十分常用的功能。
试试一个酷模块
要是给<h1>
元素的
innerHTML
属性赋值对您来说太不给力了，那就加点酷的吧！
Dojo的“
base
”部分已经包含了一个动画框架，可用于实现各种绚丽的视觉效果。而且里面也集成了几个常见的特效（例如
dojo.fadeOut
（淡出）和
dojo.fadeIn
（淡入））。这很好，但不够，我们希望那个问候元素能够“滑”入页面。为此，我们使用
dojo.fx.slideTo
。这个
dojo.fx
模块并没有被包含在
dojo.js
中，因此我们需要加载它：
我们所需的“滑行”特效是dojo.fx
模块的一部分。
dojo.require
这行声明了这个依赖关系，请求加载器在该模块不可用时载入它。这里无需任何新的
<script>
标签，而且更关键的是，我们其余部分的初始化代码完全无需更改——我们仍旧使用
dojo.ready
并且我们的代码只有在
DOM
可用并且所有依赖模块都加载完成时才会被执行。
剩下的部分就是使用我们载入的功能。与Dojo
中所有的属性动画一样，我们传入一个对象，它包含一个
DOM
结点引用，以及其他用于配置动画的参数。我们将会在今后的教程中对
Dojo
动画做更详细的介绍。
结语
开始使用Dojo
工具箱就跟添加一个
<script>
标签一样简单，但箱子里有更为宽广的天地，在您需要的时候，任由您的指尖来发掘。在本教程里，我们已经在将
Dojo
用于您的网站或
Web
应用的道路上迈出了第一步。在本系列将来的教程中，我们将逐步探索Dojo的每一个主要功能群——从
DOM
工具函数到
Ajax
，动画特效，事件，以及更多。