Hello Dojo

前端之家收集整理的这篇文章主要介绍了Hello Dojo前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。

原文:http://dojotoolkit.org/documentation/tutorials/1.6/hello_dojo/


欢迎使用Dojo!在本教程中,我们将从最基础的部分——一个简单的HTML页面开始。当本教程结束的时候,我们就已将Dojo加载到页面中,并且开始使用一些核心函数了。为了给您提供更为丰富的学习体验,我们还将简单介绍Dojo的模块化架构,并讨论如何载入依赖模块。


难度:初学者

Dojo版本:1.6


让我们开始吧~

我们的起点是一个如下所示的简单HTML页面。我们希望在这个页面添加一些代码来证明Dojo已经成功加载。

  1. <!DOCTYPEhtml>
  2. <html>
  3. <head>
  4. <Metacharset="utf-8">
  5. <title>Tutorial:HelloDojo!</title>
  6. <!--loadDojo-->
  7. <scriptsrc="http://ajax.googleapis.com/ajax/libs/dojo/1.6/dojo/dojo.xd.js"></script>
  8. </head>
  9. <body>
  10. <h1id="greeting">Hello</h1>
  11. </body>
  12. </html>

这很简洁,不是么?我们在<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。我们给它传一个函数作为参数,这个函数就会在“万事俱备”的时候执行。

<script>
  • dojo.ready(function(){
  • alert("Dojoversion"+dojo.version+"isloaded");
  • });
  • </script>
  • </head>
  • <body>
  • <h1id="greeting">Hello</h1>
  • </body>
  • </html>
  • 我们传给dojo.ready的这个函数应该会在页面加载好以后弹出一个alert对话框。必须承认,Dojoversion属性(包含版本信息)对于此类示例程序非常有用。当我们以后更为深入地学习Dojo时,这样的alert对话框就会变得越来越讨厌了。于是我们就会想要学习往浏览器控制台打印日志的方法。不过目前我们暂时略过。

    能加载Dojo的确不错,但您一定更希望操作这个刚刚载入了Dojo页面。我们将会在其他教程中深入讲解这方面的内容。而现在,我们只是简单地获取我们的<h1>元素的引用然后更新其内容

    dojo.byId("greeting").innerHTML+=",from"+dojo.version;
  • </html>
  • 这次,在我们的“万事俱备”函数里使用了dojo.byId获取DOM树中含有给定ID的元素,然后给它的innerHTML属性添加Dojo的版本信息字符串。

    需要特别注意的是,您可以对dojo.ready做任意次调用。您每一次传入的这些函数会按照传入顺序依次执行。实际上,如果您有比较多的代码,常见的做法是定义一个具名函数(非匿名函数)然后把函数名传给dojo.ready

    view plain
      functioninit(){
    1. alert("Dojoready,version:"+dojo.version);
    2. //Moreinitializationhere
    3. }
    4. dojo.ready(init);

    请注意,当我们传入函数的时候,我们只是在传函数名,而不包括其后的任何参数。

    如果您是冲着DojoHelloWorld来的,那么本教程早已结束了。但之前我们曾提到过“声明依赖模块”——让我们来聊聊这个吧。

    模块

    可见的东西往往只是冰山一角。Dojo.js到底给您带来了什么?Dojo是一个模块化的工具箱,它有一个“包系统”,能让您只加载您在页面中需要的代码,并使得代码之间的依赖管理变得非常简单。缺乏语言级别的用于加载代码的包系统(类似于Java,PHP,Python等语言中的importrequire),是一个长久以来困扰JavaScript开发人员的问题。Dojo利用一种非常符合直觉的方法组织代码,并提供了一个简单的APIdojo.require)用于声明对某个特定模块的依赖。

    这一点对于目前的意义,就是当我们加载dojo.js时,并没有去加载整个dojo工具箱,而仅仅是一些基础(base)模块。我们加载Dojo<script>标签实际载入的是一组核心功能,例如包系统、事件、AjaxDOM工具函数、以及其他十分常用的功能

    试试一个酷模块

    要是给<h1>元素的innerHTML属性赋值对您来说太不给力了,那就加点酷的吧!

    Dojo的“base”部分已经包含了一个动画框架,可用于实现各种绚丽的视觉效果。而且里面也集成了几个常见的特效(例如dojo.fadeOut(淡出)和dojo.fadeIn(淡入))。这很好,但不够,我们希望那个问候元素能够“滑”入页面。为此,我们使用dojo.fx.slideTo。这个dojo.fx模块并没有被包含在dojo.js中,因此我们需要加载它:

    //新代码:加载“dojo.fx”模块
  • dojo.require("dojo.fx");
  • //记住,dojo.ready会等到DOM树和所有依赖都可用时才被调用
  • Remember,dojo.readywaitsforboththeDOMandalldependencies
  • dojo.ready(function(){
  • //我们原有的代码——改变innerHTML
  • dojo.byId("greeting").innerHTML+=",from"+dojo.version;
  • //现在,“滑入”问候语
  • dojo.fx.slideTo({
  • top:100,
  • left:200,
  • node:dojo.byId("greeting")
  • }).play();
  • });
  • 我们所需的“滑行”特效是dojo.fx模块的一部分。dojo.require这行声明了这个依赖关系,请求加载器在该模块不可用时载入它。这里无需任何新的<script>标签,而且更关键的是,我们其余部分的初始化代码完全无需更改——我们仍旧使用dojo.ready并且我们的代码只有在DOM可用并且所有依赖模块都加载完成时才会被执行。

    剩下的部分就是使用我们载入的功能。与Dojo中所有的属性动画一样,我们传入一个对象,它包含一个DOM结点引用,以及其他用于配置动画的参数。我们将会在今后的教程中对Dojo动画做更详细的介绍。

    结语

    开始使用Dojo工具箱就跟添加一个<script>标签一样简单,但箱子里有更为宽广的天地,在您需要的时候,任由您的指尖来发掘。在本教程里,我们已经在将Dojo用于您的网站或Web应用的道路上迈出了第一步。在本系列将来的教程中,我们将逐步探索Dojo的每一个主要功能群——从DOM工具函数Ajax,动画特效,事件,以及更多。

    猜你在找的Dojo相关文章