SeaJs的使用方法

案例转载于 https://github.com/linwalker/seajs-demo

<script src="sea-module/sea.js"></script>
<!--<script src="sea-module/jquery/jquery.js"></script>-->
<!--<script src="sea-module/select2/select2.js"></script>-->
<script>
    seajs.config({
        alias:{
            'changeText':'../static/changeText.js',
            'jquery':'jquery/jquery',
            'main':'./static/main.js'
        },

    });
    seajs.use(['main','jquery'],function(main,$) {
        $('#title').after('<button id="show">showText</button>');
        $('#show').on('click',function() {
            main.showText()
        })
    });

</script>

main.js

/**
 * Created by linyuhua on 2017/1/14.
 */
define(function (require, exports, module) {
    var changeText = require('changeText');
    var $ = require('jquery');
    var showText = function () {
        $('#title').text(changeText.init());
    }
    exports.showText = showText;
})

changeText.js

/**
 * Created by linyuhua on 2017/1/14.
 */
define(function (require, exports, module) {
    var init= function() {
        var textContent = [
            'yes it works',
            'seajs demo',
            'it is a lucky day',
            'wish this help you',
            'thank you for reading'
        ];
        var index = Math.floor(Math.random()*textContent.length);
        return textContent[index];
    }
    module.exports = {
        init:init
    }
})

seajs是啥，可以看看这篇前端模块化（CommonJs,AMD和CMD）
点我点我--项目源码地址：https://github.com/linwalker/seajs-demo

本文所用例子的代码目录结构：

seajs example
|--sea-module //存在依赖文件
|--jquery
|--jqeury.js
|--sea.js
|--static //存放自定义模块js
|--main.js
|--index.html //调用页面

seajs页面引入

下面开始，首先看下index：

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>seajs example </title>
</head>
<body>
<h1 id="title">seajs demo </h1>
<script src="sea-module/sea.js"> </script>
<script>
seajs.use( './static/main.js' );
</script>
</body>
</html>

首先引入sea.js文件，然后通过seajs.use加载main.js文件。我们再来看看main.js:

define(function(require,exports,module) {
var title= document.getElementById('title');
title.innerHTML = "yes it works"
})

define()用来定义模块文件，具体参数等介绍可以参考文章开头介绍的文章。此处，页面会输出yes it works,是main.js修改了id为title的标签的文本内容，并没有引用其他模块文件。

模块文件引入

我们自定一个模块changeText.js:

define(function (require, exports, module) {
var textContent = 'yes it works';
exports.text = textContent;
//or
//module.exports = {
//text: textContent
//}
})

changeText模块输出了一个text变量，然后我们在main中引用它：

define(function (require, exports, module) {
var changeText = require('../static/changeText.js');
var title = document.getElementById('title');
title.innerHTML = changeText.text;
})

我们通过require将changText模块的输出对象赋值给changeText变量，然后将对象的text属性赋值给节点的文本值,此时页面输出效果是一样的。

别名设置

引入一个模块要写他的相对路径，我们可以给它取个别名，在seajs.use()上面加入这一段代码：

<script>
seajs.config({
alias:{
'changeText' : '../static/changeText.js'
}
});
seajs.use( './static/main.js' );
</script>

通过config中alias给'../static/changeText.js'设置了别名changeText，现在main中引用changeText模块就可以直接写成这样了var changeText = require('changeText')。

模块调用

下面试着引入一个模块的方法，将changeText改为：

define(function (require, exports, module) {
var init= function() {
var textContent = [
'yes it works',
'seajs demo',
'it is a lucky day',
'wish this help you',
'thank you for reading'
];
var index = Math.floor(Math.random()*textContent.length);
return textContent[index];
}
module.exports = {
init:init
}
})

模块中定义了一个init方法，它随机返回数组中的一条。然后我们将main修改下：

define(function (require, exports, module) {
var changeText = require('changeText');
var title = document.getElementById('title');
title.innerHTML = changeText.init();
})

这时候我们每次刷新页面都会随机出现一条文字。

第三方文件引用

下载一个jquery源文件，按如下修改：

define(function (require, exports, module) {
jquery 源码
})

使其模块化，能被外部调用。

然后再设置别名：

seajs.config({
alias:{
'changeText': '../static/changeText.js',
'jquery': 'jquery/jquery',
'main': './static/main.js'
}
});
seajs.use( './static/main.js');

在main中引入jquery，并使用：

define(function (require, exports, module) {
var changeText = require('changeText');
var $ = require('jquery');
$('#title').text(changeText.init());
})

回调函数

seajs.use([module],callback),加载一个或多个模块，并执行回调函数。我们将main修改下：

define(function (require, exports, module) {
var changeText = require('changeText');
var $ = require('jquery');
var showText = function () {
$('#title').text(changeText.init());
}
exports.showText = showText;
})

然后增加回调函数：

seajs.use(['main','jquery'],function(main,$) {
$('#title').after('<button id="show">showText</button>');
$('#show').on('click',function() {
main.showText()
})
});

上述代码我们加载了两个模块，并把它们输出的对象传参给main和$变量,通过点击事件调用main中的showText方法，而showText方法调用了changeText中的init方法。

路径问题

我们先来搞清几个问题：

./是表示当前目录；../是上级目录；
seajs.config 里alias的别名设置只是给路径取个别名，减少书写；
seajs里主要两个用到路径的地方：一个是seajs.use()；一个是require()。
base路径是seajs文件所在目录，本例子为 （file:///Users/linyuhua/code/seajs/sea-module/）

先来讲seajs.use()路径

seajs.use()调用模块文件的路径默认是seajs文件的父文件夹目录；以本例子来解释：
首先来回看下我们的目录结构：

seajs example
|--seajs
|--sea-module //存在依赖文件
|--jquery
|--jqeury.js
|--sea.js
|--static //存放自定义模块js
|--main.js
|--changeText.js
|--index.html //调用页面

调用main可以通过以下路径：

seajs.config({
alias:{
'changeText':'../static/changeText.js',
'jquery':'jquery/jquery',
'main':'./static/main.js'
}
});
seajs.use(['main','jquery'],function(main,$) {
...
})
});
// ./表示当前路径,seajs.use的默认路径是seajs文件的父文件夹的目录；即file:///Users/linyuhua/code/seajs/；
// 因此，此时main的调用路径为file:///Users/linyuhua/code/seajs/static/main.js

在举个例子来证明，这次我们使用../来设置路径：

seajs.config({
alias:{
'changeText':'../static/changeText.js',
'jquery':'jquery/jquery',
'main':'../seajs/static/main.js'
}
});
seajs.use(['main','jquery'],function(main,$) {
...
})
});
// ../表示上级目录，seajs.use()的目录为file:///Users/linyuhua/code/seajs/；
// 他的上级目录为file:///Users/linyuhua/code/，因此此时main的别名设置为../seajs/static/main.js;
// 合并之后就是file:///Users/linyuhua/code/seajs/static/main.js

最后再来看看jquery的调用，直接以文件名开头，在seajs中直接以文件名开头的路径是相对于base路径，也就是说当把jquery别名设置为'jquery':'jquery/jquery',时，他的调用路径为
base+‘jquery/jquery’（.js可以省略）；即file:///Users/linyuhua/code/seajs/sea-module/+jquery/jquery;

require()调用路径

下面我们来看看require调用的路径

首先是./和../
在define(function (){ }), 则是相对于当前的js文件所在目录，还记得main中怎么调用changeText.js和jquery的吗：

//对照别名设置
seajs.config({
alias:{
'changeText':'../static/changeText.js',
'jquery':'jquery/jquery',
'main':'../seajs/static/main.js'
}
});
define(function (require, exports, module) {
var changeText = require('changeText');
var $ = require('jquery');
var showText = function () {
$('#title').text(changeText.init());
}
exports.showText = showText;
})

由于在define(function (){ }), 则是相对于当前的js文件所在目录，所以../表示changeText.js的上级目录即file:///Users/linyuhua/code/seajs，加上别名就是file:///Users/linyuhua/code/seajs/static/changText.js;

我们也可以直接require('./changeText.js')来调用，./表示当前目录，而changeText.js与main.js在同一个目录下;

如果路径以文件名开头则是相对base路径，与前面seajs.use()一样，jquery:jqeury/jquery就是相对base路径调用的。