sea.js快速上手

Posted 2023-05-07

参考技术A 一、seajs.config配置说明：

1.base说明：

base是字符串类型，表示基础或叫做根路径（最好绝对地址）

备注：

（1）base如果不写的话是根据你引用sea.js的地址目录

（2）base如果写了’.’或者 ‘/’或者’ ’这些，会默认从服务根目录开始

（3）base如果写了’js/’之类的相对路径，会默认根据你引用sea.js的地址目录

例如：

seajs.config(

base: 'http://example.com/path/to/base/'

);

2.alias说明

例如：

seajs.config(

base: 'http://example.com/path/to/base/',

// 别名配置

alias:

'es5-safe': 'gallery/es5-safe/0.9.3/es5-safe',

'jquery': 'jquery/jquery/1.10.1/jquery'



);

引入的时候:加载模块(seajs.use("es5-safe"))  引入模块 :(require("jquery"));

3.paths说明：

当目录比较深，或需要跨目录调用模块时，可以使用paths来简化书写。

例如：

seajs.config(

base:'http://example.com/path/to/base/',

//表示路径配置

paths:

'cwd':'static/common/js'

,

alias:

'es5-safe': 'gallery/es5-safe/0.9.3/es5-safe',

'jquery': 'jquery/jquery/1.10.1/jquery',

'jquery':'cwd/common/jquery-1.11.3'//alias中使用 static/common/js/common/jquery-1.11.3



)

seajs.use('cwd/project/AA');//static/common/js/project/AA

var index = require(cwd/index)//  static/common/js/index.js

4.map说明：

map是Array类型，表示配置可对模块路径进行映射修改，可用于路径转换、在线调试等。

例如：

seajs.config(

map: [

//[ '.js' ,  '-debug.js' ]

['.js' , '.js?_t='+(new Date).getTime()]

]

);

define(function(require, exports, module)

var a = require('./a');

//=> 加载的是 path/to/a-debug.js

);

5.preload说明：（备注该属性在V2.3版本时候去除了）

preload是Array或String类型，表示预加载项，可以在普通模块加载前，提前加载并初始化好指定模块。

备注：preload中的空字符串会被忽略掉。使用时需要等到 use 才加载

例如：

seajs.config(

preload: ["jquery"]

);

6.debugBoolean 调试使用

值为 true 时，加载器不会删除动态插入的 script 标签。插件也可以根据 debug 配置，来决策 log 等信息的输出。

seajs.config(

debug:true

);

7.vars变量配置

有些场景下，模块路径在运行时才能确定，这时可以使用vars变量来配置。

seajs.config(

vars:

'locale': 'zh-cn'



);

define(function(require, exports, module)

var lang = require('./i18n/locale.js');

//=> 加载的是 path/to/i18n/zh-cn.js

);

vars配置的是模块标识中的变量值，在模块标识中用key来表示变量。

二、 define

1.所有模块都通过 define 来定义

define(function(require, exports, module)

(1). // 通过require.async引入依赖(引入模块);

require.async是异步加载的在引入后，的回调函数中才能使用，函数返回值就是require对象

require.async("jquery",fun) 异步加载模块  jquery(别名)  fun回调函数(可选参数)

require.async(['lib/common/common.js','lib/common/index.js'],function()

Echo.init(

offset: 150,  //离可视区域多少像素的图片可以被加载

throttle: 10  //图片延迟多少毫秒加载

);

);  //调用多个模块    fun回调函数可选()

(2).require引入依赖(引入模块);

Require引入就可以使用

var Spinning = require('lib/common/common.js');  基础地址/lib/common/common.js

Spinning.tostring();      调用Spinning里面的tostring方法

require直接引入整个文件

require.async(["swiper"], function()

require('module/Mycenter/mycenter');

)

2.对外暴露接口

// 通过exports对外提供接口

exports.tonumber = function() var  a = 0;

// 或者通过module.exports提供整个接口  (推荐使用)

module.exports.tonumber = function() var  a = 0;

);

三 、use()

seajs.use 用来在页面中加载模块。通过 use 方法，可以在页面中加载任意模块。use 的模块路径相对于当前页面

语法：seajs.use(id, callback?)

// 加载模块 main，并在加载完成时，执行指定回调

seajs.use(‘./main’)加载模块

seajs.use(‘./main’, function(main)

main.init();

);

use 方法还可以一次加载多个模块：

// 并发加载模块 a 和模块 b，并在都加载完成时，执行指定回调

seajs.use(['./a', './b'], function(a, b)         加载多个模块  fun回调函数(可选参数);

a.init();

b.init();

);

四、注意

引入 sea.js 时，可以把 sea.js 与其他文件打包在一起，可提前合并好，或利用 combo 服务动态合并。无论哪一种方式，为了让 sea.js内部能快速获取到自身路径，推荐手动加上 id 属性：

Sea.js学习2——Sea.js的API 快速参考

（7 个接口是最常用的）

一、seajs.config：用来对 Sea.js 进行配置。

seajs.config({

  // 设置路径，方便跨目录调用
  paths: {
    ‘arale‘: ‘https://a.alipayobjects.com/arale‘,
    ‘jquery‘: ‘https://a.alipayobjects.com/jquery‘
  },

  // 设置别名，方便调用
  alias: {
    ‘class‘: ‘arale/class/1.0.0/class‘,
    ‘jquery‘: ‘jquery/jquery/1.10.1/jquery‘
  }

});

二、seajs.use：用来在页面中加载一个或多个模块。

// 加载一个模块
seajs.use(‘./a‘);

// 加载一个模块，在加载完成时，执行回调
seajs.use(‘./a‘, function(a) {
  a.doSomething();
});

// 加载多个模块，在加载完成时，执行回调
seajs.use([‘./a‘, ‘./b‘], function(a, b) {
  a.doSomething();
  b.doSomething();
});

三、define：用来定义模块。Sea.js 推崇一个模块一个文件，遵循统一的写法：

define(function(require, exports, module) {

  // 模块代码

});

也可以手动指定模块 id 和依赖。
require, exports 和 module 三个参数可酌情省略，具体用法如下：

1）require：require 用来获取指定模块的接口。

define(function(require) {

  // 获取模块 a 的接口
  var a = require(‘./a‘);

  // 调用模块 a 的方法
  a.doSomething();
});

注意，require 只接受字符串直接量作为参数，

2）require.async：用来在模块内部异步加载一个或多个模块。

define(function(require) {

  // 异步加载一个模块，在加载完成时，执行回调
  require.async(‘./b‘, function(b) {
    b.doSomething();
  });

  // 异步加载多个模块，在加载完成时，执行回调
  require.async([‘./c‘, ‘./d‘], function(c, d) {
    c.doSomething();
    d.doSomething();
  });

});

3）exports：用来在模块内部对外提供接口。

define(function(require, exports) {

  // 对外提供 foo 属性
  exports.foo = ‘bar‘;

  // 对外提供 doSomething 方法
  exports.doSomething = function() {};

});

4）module.exports：与 exports 类似，用来在模块内部对外提供接口。

define(function(require, exports, module) {

  // 对外提供接口
  module.exports = {
    name: ‘a‘,
    doSomething: function() {};
  };

});

module.exports 与 exports 的区别。