RequireJS学习笔记(转)

前言

进入移动前端是很不错的选择,这块也是我希望的道路,但是不熟悉啊。。。

现在项目用的是require+backbone,整个框架被封装了一次,今天看了代码搞不清楚,觉得应该先从源头抓起,所以再看看require了。

上午是到处搜集的资料,下午我们来看原生的API吧:

http://www.requirejs.org/docs/api.html#config

PS:我英语很烂,各位将就着看吧,看到红色就说明老夫拿不准......

加载javascript文件

RequireJS采用不同的方法来加载脚本,他鼓励模块化编程,使用RequireJS编程不但可以模块化编程而且他依旧可以运行的很快。

RequireJS鼓励使用模块ID,而不是像原来那样使用script标签使用url引入。

RequireJS加载代码时候,其相对路径为baseUrl,baseUrl通常被设置为data-main指定文件的目录:

<!--这里讲baseUrl设置为script的话,scripts/main.js便可以写成main了--> <script data-main="scripts/main.js" src="scripts/require.js"></script>

BaseUrl也可以通过设置进行手动配置(通过RequireJS 的 config进行配置),若是没在config中进行配置,并且script标签没有指定data-main的话,那么默认目录为引入requireJS的HTML页面目录。

默认情况下不要在模块id上加上.js后缀,requireJS会在运行时自己加上。

通过设置config中的paths(对象字面量)属性,你能设置一组脚本的位置,如此便能减少我们的js总体配置。

这里我们来举个例子,且看我们的文档目录:

我们index代码:

<script data-main="js/app.js" src="js/require.js"></script>

app.js为入口函数,其代码为:

requirejs.config({     //默认情况下模块所在目录为js/lib     baseUrl: ‘js/lib‘,     //当模块id前缀为app时,他便由js/app加载模块文件    //这里设置的路径是相对与baseUrl的,不要包含.js     paths: {         app: ‘../app‘     } });  // 开始逻辑. requirejs([‘jquery‘, ‘canvas‘, ‘app/sub‘], function   ($, canvas, sub) {     //jQuery, canvas and the app/sub module are all     //loaded and can be used here now. });

各位请注意,这里的jquery并没有在他们的文件名上加上其版本号,这里推荐加上。

PS:原因我就不说了,说也不一定说得清楚......

理想情况下我们加载的脚步都会通过define()函数定义,但是我们有些脚步会依赖与当前版本不同的版本,你能使用shim配置,来表达其依赖。

PS:这里有点模糊,我们再来看看snandy道友是怎么说的:

shim参数解决了使用非AMD方式定义的模块(如jQuery插件)及其载入顺序。 使用shim参数来取代1.0版本的order插件。其实在1.0版本中就曾经有人开发过use和wrap插件来解决此类问题。 考虑到很多开发者有此类需求(比如某些JS模块是较早时候其他人开发的,非AMD方式)此次2.0版本直接将其内置其中。

这里是一个使用jQuery插件形式配置的参数,我们知道jQuery插件本质是将命名空间挂在全局jQuery或jQuery.fn上,而非使用define定义的模块。

jQuery插件皆依赖于jQuery,即在require插件时得保证jQuery先下载:

1 require.config({ 2     shim: { 3         ‘jquery-slide‘: [‘jquery‘] 4     } 5 }); 6 require([‘jquery-slide‘]);

这里便会保证先加载jquery再加载插件。

PS:对照着园友的解释看看吧,应该会清晰一点,这块后面还会有我们等下再看。

模块定义

requireJS定义模块与传统一个很大的不同是他可以保证其定义的变量处于某个范围内,从而避免了全局命名污染。

他能明确的罗列出其依赖,并且在那些依赖上找到处理办法,而不是必须对那些依赖指定全局变量。

requireJS的模块扩展不需要全局变量与其他模块产生依赖(理解的狗屁不通啊)

PS:文字读不懂,来一个简单的键值对例子吧:

define({     color: "black",     size: "unisize" });

若是这个模块没有任何依赖,并且他仅仅是一组键值对,那么就传递一个对象就好。

定义函数

//my/shirt.js now does setup work //before returning its module definition. define(function () {     //Do setup work here      return {         color: "black",         size: "unisize"     } });

若是模块没有依赖,但是需要用一个函数做一些初始化工作,然后定义自己通过define的匿名函数。

有依赖的模块

//my/shirt.js now has some dependencies, a cart and inventory //module in the same directory as shirt.js define(["./cart", "./inventory"], function(cart, inventory) {         //return an object to define the "my/shirt" module.         return {             color: "blue",             size: "large",             addToCart: function() {                 inventory.decrement(this);                 cart.add(this);             }         }     } );

若是模块具有依赖关系,第一个参数应该是一个数组,其项目为依赖名字,第二个参数是匿名函数

匿名函数在依赖项加载结束后会立即加载,函数会返回一个对象用以定义这个模块。

前面的依赖项将以参数的形式传递给函数,顺序与之前一致。

再看我们的例子,一个球衣模块被创建了(我们返回的是一个衣服模块)

PS:这里文件命名为shirt.js,所以返回的就是衣服模块了

最后我们得到的结构式这样的:

  • my/cart.js
  • my/inventory.js
  • my/shirt.js

参数调用时的参数与前面依赖项一一对应,

定义函数模块

//A module definition inside foo/title.js. It uses //my/cart and my/inventory modules from before, //but since foo/bar.js is in a different directory than //the "my" modules, it uses the "my" in the module dependency //name to find them. The "my" part of the name can be mapped //to any directory, but by default, it is assumed to be a //sibling to the "foo" directory. define(["my/cart", "my/inventory"],     function(cart, inventory) {         //return a function to define "foo/title".         //It gets or sets the window title.         return function(title) {             return title ? (window.title = title) :                    inventory.storeName + ‘ ‘ + cart.name;         }     } );

模块也可以不必返回对象,任何有效的返回都是可以的,比如上面的例子,返回一个函数作为其模块定义。

带名字的模块

//Explicitly defines the "foo/title" module:     define("foo/title",         ["my/cart", "my/inventory"],         function(cart, inventory) {             //Define foo/title object in here.        }     );

(???)这里明确的定义了foo/title模块,这里其实是一种优化手段,我们这里可以明确的命名模块,但是若是文件目录变化我们就要更改名称了。

其他说明

一个js文件应该只定义一个模块,并与文件目录一致,因为最后有个神马优化工具可以优化。。。

在定义模块时将各个模块关联起来,

相对模块生产url,你可能需要使用一个相对模块的url:

define(["require"], function(require) {     var cssUrl = require.toUrl("./style.css"); });

PS:尼玛,我今天才知道我英语有多差。。。

循环依赖

我们有时候会定于循环依赖的模块,比如a需要b并且b需要a,在这个情况下当b模块调用时他将会从a获得一个undefined值,b可以通过require方法取得一个比较晚的模块。

//Inside b.js: define(["require", "a"],     function(require, a) {         //"a" in this case will be null if a also asked for b,         //a circular dependency.         return function(title) {             return require("a").doSomething();         }     } );

你通常不需要使用require方法获取一个模块,在循环依赖时候需要用到(读不懂了。。。)

exports

//Inside b.js: define(function(require, exports, module) {     //If "a" has used exports, then we have a real     //object reference here. However, we cannot use     //any of a‘s properties until after b returns a value.     var a = require("a");      exports.foo = function () {         return a.bar();     }; });

//Inside b.js: define([‘a‘, ‘exports‘], function(a, exports) {     //If "a" has used exports, then we have a real     //object reference here. However, we cannot use     //any of a‘s properties until after b returns a value.      exports.foo = function () {         return a.bar();     }; });

配置选项

我们可以通过以下方法,对require进行配置:

<script src="scripts/require.js"></script> <script>   require.config({     baseUrl: "/another/path",     paths: {         "some": "some/v1.0"     },     waitSeconds: 15   });   require( ["some/module", "my/module", "a.js", "b.js"],     function(someModule,    myModule) {         //This function will be called when all the dependencies         //listed above are loaded. Note that this function could         //be called before the page is loaded.         //This callback is optional.     }   ); </script>

baseUrl

模块查找的根目录,默认情况与data-main所赋值处于同一目录

paths

该项用于配置那些不在baseUrl下的模块,这个指定的path假定是baseUrl的相对路径,若是以/开头的话就不是了。

这里的id会自动加上.js,我们要获取一个路径时,一般这个样子干:

 require.toUrl() 

shim

传统浏览器的全局脚本不使用define去声明依赖关系和模块设置值的依赖。

Ps:读不懂,还是看代码算了:

requirejs.config({     shim: {         ‘backbone‘: {             deps: [‘underscore‘, ‘jquery‘],             exports: ‘Backbone‘         },         ‘underscore‘: {             exports: ‘_‘         },         ‘foo‘: {             deps: [‘bar‘],             exports: ‘Foo‘,             init: function (bar) {                 return this.Foo.noConflict();             }         }     } });  define([‘backbone‘], function (Backbone) {     return Backbone.Model.extend({}); });

这个例子假定backbone等依赖库已经在baseUrl中,若是没有就需要配置。

requirejs.config({     shim: {         ‘jquery.colorize‘: {             deps: [‘jquery‘],             exports: ‘jQuery.fn.colorize‘         },         ‘jquery.scroll‘: {             deps: [‘jquery‘],             exports: ‘jQuery.fn.scroll‘         },         ‘backbone.layoutmanager‘: {             deps: [‘backbone‘]             exports: ‘Backbone.LayoutManager‘         }     } });

时间: 2024-10-25 10:36:07

RequireJS学习笔记(转)的相关文章

requireJS学习笔记

main.js requirejs.config({ baseUrl: 'scripts/lib',     paths: { app: '../app',             style:'../../style',             resources:'../../resources',             css:'require-css/css',             jquery: 'jquery', formBootstrap:'formValidation/di

requireJS学习笔记一

requireJS简介 requireJS是一个非常小巧的javascript模块载入框架,很好的实现了AMD规范. requireJS解决了以下问题: 1.异步加载js,防止js加载阻塞页面渲染: 2.管理js模块之间的相互依赖关系,便于代码维护. data-main入口 requireJS在加载过程中会检测script标签的data-main属性: 1 <script data-main="js/app" src="js/require.js">&l

WeX5学习笔记

目录 WeX5学习笔记... 1 1.轻松看透WeX5产品能力和技术... 1 2.WeX5可以怎么玩?... 3 一.纯本地App. 3 二.关联一个网站,希望默认就打开某页... 4 三.UI设计器... 4 四.打包神器... 4 五.标准玩法... 4 3.WeX5 App与服务端交互原理... 4 4.Account示例程序... 5 5.Takeout示例程序... 7 5.1Index.w.. 7 5.2mapActivity.w.. 13 问题... 13 6.页面间交互视频..

Wojilu学习笔记 (02)

使用RequireJS (1)整个页面,应该只有一个 <script src="" > 标签,并且放在页面底部,用来引入 RequireJS 和 main.js 文件 <script data-main="~js/main" src="~js/lib/require-jquery-wojilu.js?v=#{jsVersion}"></script> (2)在页面头部的 <head> 部分,增加一行

AMD规范学习笔记

背景 NodeJS的一套比较简洁 Moudles 规范, 使得在服务器端的模块化变得更加简单.很长一段时间,很多公司或者项目都有自己的一套模块化机制, 却未能形成一套统一的标准, NodeJS的Moudles规范如果运用在浏览器端会存在一些问题,如 服务器端JS模块文件就在本地,浏览器端则需要通过网络请求 服务器端可以很容易的实现同步或异步请求模块,浏览器端代价会比较大 采用XHR的方式实现同步请求模块,存在明显的跨域缺陷,而使用script的方式,默认是异步的. 在这样的背景下, Common

axios学习笔记

axios学习笔记axios文档源地址:https://github.com/axios/axios0.概念axios 在NPM上的描述是:Promise based HTTP client for the browser and node.js.axios是通过promise实现对ajax技术的一种封装,就像jQuery实现ajax封装一样.简单来说: ajax技术实现了网页的局部数据刷新,axios实现了对ajax的封装.1.Installing $ npm install axios2.E

vector 学习笔记

vector 使用练习: /**************************************** * File Name: vector.cpp * Author: sky0917 * Created Time: 2014年04月27日 11:07:33 ****************************************/ #include <iostream> #include <vector> using namespace std; int main

Caliburn.Micro学习笔记(一)----引导类和命名匹配规则

Caliburn.Micro学习笔记(一)----引导类和命名匹配规则 用了几天时间看了一下开源框架Caliburn.Micro 这是他源码的地址http://caliburnmicro.codeplex.com/ 文档也写的很详细,自己在看它的文档和代码时写了一些demo和笔记,还有它实现的原理记录一下 学习Caliburn.Micro要有MEF和MVVM的基础 先说一下他的命名规则和引导类 以后我会把Caliburn.Micro的 Actions IResult,IHandle ICondu

jQuery学习笔记(一):入门

jQuery学习笔记(一):入门 一.JQuery是什么 JQuery是什么?始终是萦绕在我心中的一个问题: 借鉴网上同学们的总结,可以从以下几个方面观察. 不使用JQuery时获取DOM文本的操作如下: 1 document.getElementById('info').value = 'Hello World!'; 使用JQuery时获取DOM文本操作如下: 1 $('#info').val('Hello World!'); 嗯,可以看出,使用JQuery的优势之一是可以使代码更加简练,使开