TodoMVC中的Backbone+MarionetteJS+RequireJS例子源码分析之一
Marionette牵线木偶，Backbone是脊骨的意思，Marionette是基于Backbone做扩展库，可以理解为把脊骨骨架绑线扯着变成牵线木偶动起来哈哈，使backbone更易使用呵呵！
构建或者扩展了很多新的东西，如：Application,Region,ItemView,CollectionView,CompositeView,LayoutView,AppRoute,Controller等等，把很多重复性的工作变成配置，程序入口引入了集中处理器Application，貌似Marionette的module不怎么好用，还不如用requireJS来得直观。
一、文件目录
比较清晰，bower_components里面存放jQuery,underscore等等依赖js库及js框架，不用管它；css文件也不用理它。
一，主程序(/index.html-> js/main.js-> js/app.js ->js/routers/index.js & js/controllers/index.js)
/index.html
<!doctype html> <html lang="en" data-framework="marionettejs"> <head> <meta charset="utf-8"> <title>Backbone.Marionette & Requirejs • TodoMVC</title> <link rel="stylesheet" href="bower_components/todomvc-common/base.css"> <link rel="stylesheet" href="css/custom.css"> </head> <body> <section id="todoapp"> <header id="header"> </header> <section id="main"> </section> <footer id="footer"> </footer> </section> <footer id="info"> <p>Double-click to edit a todo</p> <p>Created by <a href="http://github.com/jsoverson">Jarrod Overson</a></p> </footer> <script src="bower_components/todomvc-common/base.js"></script> <script data-main="js/main" src="bower_components/requirejs/require.js"></script><!--requireJS开始加载js/main.js文件--> </body>
js/main.js
require.config({//requireJS配置
paths: {//路径配置
underscore: '../bower_components/underscore/underscore',
backbone: '../bower_components/backbone/backbone',
marionette: '../bower_components/backbone.marionette/lib/backbone.marionette',
jquery: '../bower_components/jquery/jquery',
localStorage: '../bower_components/backbone.localStorage/backbone.localStorage',
tpl: 'lib/tpl'
},
shim: {//非AMD规范库如backbone等库的配置,deps是依赖库
underscore: {
exports: '_'
},
backbone: {
exports: 'Backbone',
deps: ['jquery', 'underscore']
},
marionette: {
exports: 'Backbone.Marionette',
deps: ['backbone']
}
},
deps: ['jquery', 'underscore']
});
require([
'app',
'backbone',
'routers/index',
'controllers/index'
], function (app, Backbone, Router, Controller) { //requireJS标准写法
'use strict';
app.start();//应用启动－〉app.js
new Router({ controller: Controller });//指定了Controller（controllers/index）的Marionette.AppRouter（routers/index；监视url传值触发相应的事件
Backbone.history.start();//当你的所有路由创建并且设置完毕后，调用Backbone.history.start()来开始记录url的hash change，如果是html5还可以记录pushState等
});
js/app.js
/*global define */ define([ 'marionette', 'collections/TodoList', 'views/Header', 'views/TodoListCompositeView', 'views/Footer' ], function (Marionette, TodoList, Header, TodoListCompositeView, Footer) {//requireJS标准写法，其实就是用function里的变量去表示相应的库/模块的返回值（注意：根据requireJS规范，每个模块应该要有返回值,如app.js最后用了return window.app=app;） 'use strict'; var app = new Marionette.Application(); //创建APP, Marionette官方描述为：the hub of your composite //application. It organizes, initializes and coordinates the various pieces of your app. var todoList = new TodoList();//collections/TodoList, collections就是model集 var viewOptions = { collection: todoList }; var header = new Header(viewOptions); var main = new TodoListCompositeView(viewOptions); var footer = new Footer(viewOptions);//这三个view都是绑定collections/TodoList这个collection app.addRegions({//给app增加region，region是分区处理更加灵活 header: '#header', main: '#main', footer: '#footer' }); app.addInitializer(function () {//添加事件到Marionette的初始器 app启动时会被马上执行 //show 三个region app.header.show(header); app.main.show(main); app.footer.show(footer); todoList.fetch();//collection todoList获取localstorage的数据 }); app.listenTo(todoList, 'all', function () {//监听collection todoList 所有事件包括todoList.fetch(); app.main.$el.toggle(todoList.length > 0);//main view执行toggle 函数 app.footer.$el.toggle(todoList.length > 0);//footer view执行toggle 函数 }); app.vent.on('todoList:filter', function (filter) {//vent是用于定义供实例外部引用的函数，可以看见在controller里面trigger此函数 footer.updateFilterSelection(filter);//执行footer view里面的函数 document.getElementById('todoapp').className = 'filter-' + (filter === '' ? 'all' : filter);//纯js }); app.vent.on('todoList:clear:completed', function () {//vent是用于定义供实例外部引用的函数，可以看见在footer view里面trigger此函数 todoList.getCompleted().forEach(function (todo) { todo.destroy(); }); }); return window.app = app;//把app绑到window全局对象并返回 });
js/routers/index.js
/*global define */ define([ 'marionette' ], function (Marionette) { 'use strict'; return Marionette.AppRouter.extend({ appRoutes: { '*filter': 'setFilter'//*splat表示可以匹配任意数量的URL形式，如路由：file/*path -> file/a/b/c.txt，传递值为/a/b/c.txt;题外的如 :param将匹配斜杠/之间单一的一个URL变量，如路由：search/:query/p:page -> #search/obama/p2，传值为"obama"和"2" } }); });
js/controllers/index.js
/*global define */ define([ 'app' ], function (app) { 'use strict'; return { setFilter: function (param) { app.vent.trigger('todoList:filter', param && param.trim() || '');//根据URL中的传的值param触发app.js中定义的vent（todoList:filter）的函数 } }; });