打开APP
userphoto
未登录

开通VIP,畅享免费电子书等14项超值服

开通VIP
Durandal快速入门

因此,我们推出了一个Kickstarter来帮助我们在2014年完成一些神奇的事情,希望你能关注。但现在,我将向你展示如何开发一个简单的Durandal程序。

要开始使用Durandal,可以有多种方式,这取决于你的平台。因为Durandal是一个纯JavaScript库,独立于任何服务端平台,我们尝试用多种方式来打包,以满足各类Web开发人员。在本教程中,我们将直接使用HTML Starter Kit。你可以在官方网站上直接下载

下载完HTML Starter Kit后,解压缩,你就可以直接在Firefox各版本中打开index.html页面,运行其示例程序了。或者你也可以将其部署到Web服务器中,浏览其index页面。

Starter Kit演示了一个基本的导航架构,包括导航、页面历史、数据绑定、模态对话框等等。当然,我们不只是看看而已,我们要从头开始写一个小程序。首先打开app文件夹,删除里面的所有内容,然后删除index.html。这样我们就有了一个空项目,并且预配置了所有必须的scripts和css。

*注:IE, ChromeSafari可能无法从文件系统中直接打开这类文件。如果你仍希望使用这些浏览器,可以将其部署到你喜欢的Web服务器中。

Index.html
我们开始编写index.html文件,内容如下:

<!DOCTYPE html> <html>   <head>     <link rel="stylesheet" href="lib/bootstrap/css/bootstrap.css" />     <link rel="stylesheet" href="lib/font-awesome/css/font-awesome.css" />     <link rel="stylesheet" href="lib/durandal/css/durandal.css" />     <link rel="stylesheet" href="css/starterkit.css" />   </head>   <body>     <div id="applicationHost"></div>     <script src="lib/require/require.js" data-main="app/main"></script>   </body> </html>

我们看到,文件中只有一些css样式文件,一个id为applicationHost的简单的div, ,一个script标签。我们加上了BootstrapFontAwesome,使界面看起来美观一些,但它们并不是Durandal所必须的。我们要关注的关键代码是script标签。

Durandal采用RequireJS作为其核心构件之一,鼓励模块化的编程方式。在Durandal应用中,所有的JS代码都写在模块中。上文index.html中的script标签就是用于加载RequireJS来完成框架的模块策略。当模块加载器完成初始化后,它通过data-main属性的值来启动应用。就像C语言中的main函数一样,data-main属性指向的是主模块,是整个应用的入口。让我们进行下一步,创建这个模块。首先创建一个名为main.js的文件,把它放到app文件夹下。其代码如下:

main.js requirejs.config({   paths: {     'text': '../lib/require/text',     'durandal':'../lib/durandal/js',     'plugins' : '../lib/durandal/js/plugins',     'transitions' : '../lib/durandal/js/transitions',     'knockout': '../lib/knockout/knockout-2.3.0',     'jquery': '../lib/jquery/jquery-1.9.1'     }  }); define(function (require) {    var system = require('durandal/system'),        app = require('durandal/app');    system.debug(true);    app.title = 'Durandal Starter Kit';    app.configurePlugins({      router:true,      dialog: true    });    app.start().then(function() {      app.setRoot('shell');    }); });

这是一个非常标准的Durandal应用的样板配置。我们详细地看一下代码。

文件的最上面是requirejs.config代码。这部分代码用于配置模块系统,使其能够找到核心库。配置的都是一些相对路径,因此当我们引用“jQuery”时,模块系统就知道到哪里去加载它。我们可以看到,路径的配置包括requirejs的text插件(用于加载视图)、Durandal的核心模块、Knockout和jQuery。Durandal采用RequireJS来构建模块,Knockout用于数据绑定,而jQuery用于浏览器层的抽象。

完成RequireJS的配置后,定义应用的主模块。Durandal应用的所有代码都写在模块中,并且按照以下格式:

define(function (require) {   var someModule = require('some/module');   ...other modules required here...   return someValue; });

我们用define函数来创建一个模块。它的参数是另一个函数,这个函数是模块的工厂。也就是说,这个函数的返回值将是模块的一个实例。当函数返回一个对象时,你可以创建单例对象模块。或者返回一个函数,你可以创建一个类构造器模块。另外,你也可以声明该模块依赖于其他模块,此时你需要使用require函数来引入其他模块。

在上面的主模块代码中,你可以看到我们引入或者说require了两个Durandal模块:systemapp。然后通过system模块开启框架的调试功能,通过app模块设置应用的标题,加载两个可选的插件。最后,我们调用start方法启动应用。该方法是一个异步的动作,当它结束时,调用一个特殊的方法:setRoot

setRoot方法被调用时,才会真正去展示页面。你可以将root视为应用的主窗口、主布局或者应用的shell。该方法的参数指向一个包含shell的行为的模块。现在唯一的问题是,嗯,它还不存在。好吧,我们开始创建它。

Shell

Durandal的大部组件都同时包含行为(behavior)和展现(presentation)。你的应用的shell毫无疑问也遵循这个规则。我们将通过两个文件来展示这两个不同的概念:一个是用于行为的JavaScript文件,另一个是用于展现的HTML文件。在app文件夹下创建:shell.jsshell.html两个文件的代码如下所示,我们来看看它们是如何工作的。

shell.js define(function (require) {   var app = require('durandal/app'),       ko = require('knockout');   return {      name: ko.observable(),      sayHello: function() {        app.showMessage('Hello ' + this.name() + '! Nice to meet you.', 'Greetings');      }    }; }); shell.html <section>   <h2>Hello! What is your name?</h2>   <form class="form-inline">     <fieldset>        <label>Name</label>        <input type="text" data-bind="value: name, valueUpdate: 'afterkeydown'"/>        <button type="submit" class="btn" data-bind="click: sayHello, enable: name">Click Me</button>     </fieldset>   </form> </section>

首先看看shell.js,正如我们之前讲到的,它定义了一个模块。同时它还依赖两个别的模块:appknockout。从代码可以看出,模块返回了一个对象。这个对象有一个name属性和一个sayHello方法。属性name看起来有点特别,它是我们使用Knockout创建的一个可被观察的(observable)属性。可被观察的(observable)属性支持数据到html的双向绑定,变更通知和一些其它特性。注意看sayHello中调用了app模块的方法来显示一个包含name属性值的消息对话框。

要完全理解这些代码,你应该将它与HTML代码放到一起来看。注意观察HTML中的data-bind属性。该属性将HTML与模块中的属性和方法联系起来。例如input标签通过data-bind属性将它的值与name属性连接起来的。它同时还指定,当key down事件发生时,属性name的值将被更新(如果不指定事件,则默认光标离开时会进行更新)。同样地,按钮的click事件绑定了sayHello方法,而且仅当name属性的值为真时,按钮才是有效状态。看起来是不是很酷?现在就把应用运行起来,你可以用Firefox打开index.html,或者如果你使用其他浏览器的话,可以部署到Web服务器下然后浏览index.html。当页面打开时,会经历以下这些步骤:

  1. 加载RequireJS。
  2. RequireJS将加载main.js,然后配置框架。
  3. main.js调用setRoot展示整个应用。
  4. 加载shell.jsshell.html,绑定数据,然后注入到页面的applicationHost div中。

当页面加载完成后,在输入框中试着输入一些内容,观察按钮的有效性是如何变化的,然后点击按钮看看发生了什么。

导航

上面的例子看起来不错,但大多数应用都不只有一页。所以,我们开始下一步,将它扩展成具有页面导航的应用。首先,把shell.js改名为home.jsshell.html改名为home.html。然后创建两个新文件shell.jshome.js用于导航。以下是两个新文件的代码:

shell.js define(function (require) {   var router = require('plugins/router');      return {      router: router,      activate: function () {        router.map([          { route: '', title:'Home', moduleId: 'home', nav: true }        ]).buildNavigationModel();        return router.activate();      }    }; }); shell.html <div>  <div class="navbar navbar-fixed-top">   <div class="navbar-inner">    <ul class="nav" data-bind="foreach: router.navigationModel">     <li data-bind="css: { active: isActive }">      <a data-bind="attr: { href: hash }, html: title"></a>     </li>    </ul>    <div class="loader pull-right" data-bind="css: { active: router.isNavigating }">      <i class="icon-spinner icon-2x icon-spin"></i>    </div>   </div>  </div>  <div class="container-fluid page-host" data-bind="router: { transition:'entrance' }"></div> </div>

可以看到,shell.js仍然是模块的标准定义方式。首先require了一个router插件,利用它创建对象。我们配置了一个route指向home模块。router配置中指定了每个route匹配的模式、显示的标题、对应加载的moduleId,以及route匹配时,是否应该将此route显示到导航栏中(nav:true)。配置完成后,调用buildNavigationModel。该方法利用route信息,构建一个特殊的集合,这个集合通过数据绑定,可以用来显示页面顶部的导航栏。最后,我们激活这个router。所有这些都发生在activate方法中。每次Durandal向屏幕展现一个组件时,它都会查找可选的activate回调方法。如果找到,就会在数据绑定前调用此方法。因此这种方式允许你执行自定义的激活代码,例如上面的例子在activate方法中配置应用程序的router。

如果把模块和视图的代码放到一起,这次你应该很容易理解它们是如何工作的了。首先绑定navigationModel属性,生成一个导航栏navbar。每一个可导航的route被转换成一个li标签,其中包含一个链接。链接的标题对应title,地址对应hash。同时,在navbar中还包含了一个spinner动画图标,并将其与router.isNavigating属性进行绑定。当应用从一个页面导航到另一页面时,我们就能看到一个spinner动画图标。

在html文件的最下方有一个特殊的router绑定,也就是连接模块中的router。它扮演占位符的角色,用于显示当前页面。属性transition表示当页面发生变化时,Durandal要使用“entrance”过渡动画。

现在将它运行起来。它看起来跟之前差不多,除了在顶端多了个导航栏。因为现在仍然只有一个页面,因此没有什么令人印象深刻的东西。我们开始创建第二个页面,以便能够在页面间前进或后退。

第二页:雷尼尔峰

我们创建的第二个页面将调用Flickr,获取一组雷尼尔峰的照片并进行展示。首先修改shell的router配置,增加另一个route,这样它就有了两个route:

{ route:'', title:'Home', moduleId:'home', nav:true }, { route:'rainier', title:'Mount Rainier', moduleId:'rainier', nav:true }

第一个是我们之前的home route,第二个是新的route用于即将创建的新页面。这时候,希望你已经知道应该怎么做了。我们为新页面创建一个模块(module)和一个视图(view)。

rainier.js define(function (require) {   var http = require('plugins/http'),       ko = require('knockout');   var url = 'http://api.flickr.com/services/feeds/photos_public.gne';   var qs = {      tags: 'mount ranier',      tagmode: 'any',      format: 'json'    };   return {      images: ko.observableArray([]),      activate: function () {        var that = this;        if (this.images().length > 0) {            return;        }              return http.jsonp(url, qs, 'jsoncallback').then(function(response) {           that.images(response.items);        });      }    }; }); rainier.html <section>   <h2>Mount Rainier</h2>   <div class="row-fluid">     <ul class="thumbnails" data-bind="foreach: images">       <li>          <img style="width: 260px; height: 180px;" data-bind="attr: { src: media.m }"/>       </li>     </ul>   </div> </section>

我想你已经能够看出来它是怎么工作的了。新模块在activate回调方法中使用http插件调用Flickr的api去获取图片。然后将数据保存到images属性中。Images是一个可被观察的(observable)数组,页面绑定这个数组并展示图片。

将应用运行起来,可以看到在导航栏中出现了两项,你能在两者间进行前进和后退操作。你也可以使用浏览器的返回按钮。Durandal能做的事情远不止这些。也许你该下载Starter Kit并仔细研究,就会发现一些更有趣的东西。又或者你应该将官方的示例程序下载下来,看看各种功能是如何工作的,例如发布/订阅消息、自定义模态对话框、组件、高级的视图组合等等。如果你想看一些更酷的东西,可以看看Kickstarter资助的系列培训中我们将构建的应用。

Durandal通过模块化的方法,使得构建富客户端,动态的JavaScript应用更加简单。因此理所当然地,我们的社区发展得非常快。我们的计划才刚刚开始,希望你也能加入我们的奇妙旅程。请浏览一下我们的Kickstarter。2014年我们已经有了一些很酷的目标,同时,也有一些非常棒的奖励给你。Web正在发生改变,光明的未来指日可待,希望我们在那里相逢。

关于作者

Rob Eisenberg是一个JavaScript专家和.NET架构师,工作在佛罗里达州的塔拉哈西,同时他还是Blue Spire 咨询公司的总裁。Rob在9岁时开始计算机编程,那时他彻底地爱上了家里的新Commodore 64。他痴迷于编程,从Commodore Basic语言到Q Basic和QuickBasic开始,很快转到C, C++, C#和JavaScript。Rob定期在devlicio.us上发表技术文章,并经常在区域性的专业活动中和相关公司做演讲和报告,主要涉及Web和.NET技术,敏捷软件开发实践和UI工程。他是Sam出版的《Teach Yourself WPF in 24 Hours》一书的联合作者,也是Durandal和Caliburn.Micro框架的架构师和首席开发人员。

本站仅提供存储服务,所有内容均由用户发布,如发现有害或侵权内容,请点击举报
打开APP,阅读全文并永久保存 查看更多类似文章
猜你喜欢
类似文章
【热】打开小程序,算一算2024你的财运
node.js操作文件实现增、删、改、查
ionic入门之AngularJS扩展
node.js 个人博客系统
单页WEB应用(一),结构和布局
Node.js基础入门第九天
web前端教程:新手应该怎么学习webpack
更多类似文章 >>
生活服务
热点新闻
分享 收藏 导长图 关注 下载文章
绑定账号成功
后续可登录账号畅享VIP特权!
如果VIP功能使用有故障,
可点击这里联系客服!

联系客服