企业级标准加载器 ESL的配置

原文链接：http://www.oschina.net/p/esl

配置你的Loader

通过require.config( Object )，可以对esl进行配置。通常我们在使用前都需要进行esl的配置。

require.config( {    baseUrl: './src',    paths: {        css: './src/plugin/css'    }} );require( [ 'common/main' ] );

ESL的配置项

baseUrl

string

AMD 标准配置项。指定模块的根路径。

paths

Object

AMD 标准配置项。为特殊模块指定查找路径。

配置项中，每项的key为模块id，value为指定路径。key的模块id为前缀匹配。

require.config( {    baseUrl: './src',    paths: {        lib: 'http://lib.com/libpath', // 引用外部模块可以用paths配置        plugin: './plugin' // 前缀匹配，plugin/css和plugin/js等模块都将到 "./plugin"下查找    }} );

packages

Array

AMD 标准配置项。package是一个功能集合的抽象，通过packages配置可以引入一个符合CommonJS规范的包。

配置项中，数组中的每项可以是：

• Object，其中包含name、location、main。
• string，其中第一个segment作为name，整个字符串的值作为location，main采用默认值main。

require.config( {    // ...    packages: [        {            name: 'er',            location: '../dep/er/3.0.2'        },        {            name: 'echarts',            location: '../dep/echarts/1.1.0',            main: 'echarts'        }    ]} );

map

Object

AMD 标准配置项。map项允许用户对依赖的模块进行映射。

和paths配置项一样，key的模块id为前缀匹配。

require.config( {    // ...    // some/newmodule模块中，require('foo')实际引用到的是foo2模块    // some/newmodule为前缀匹配，some/newmodule/index对foo的引用行为也将引用foo2    'some/newmodule': {        'foo': 'foo2',        'foo/bar': 'foo1.2/bar3'    }} );

config

Object

AMD 标准配置项。通过config配置可以为模块传递需要动态变更的参数，比如功能开关。

require.config( {    // ...    config: {        sidebar: {            displayMode: 'autohide'        }    }} );

模块可以通过module.config()获得其自身配置。

define( function ( require, exports, module ) {    var conf = module.config();} );

waitSeconds

Interger

非AMD标准配置项，指定等待的秒数。超过等待时间后，如果有模块未成功加载或初始化，将抛出 MODULE_TIMEOUT 异常错误信息。

require.config( {    // ...    waitSeconds: 5} );require( [ 'noexist' ] );

urlArgs

string | Object

非AMD标准配置项，在模块路径后添加参数字符串。

• string: 默认参数字符串。
• Object: 为相应模块指定参数字符串。与paths、map配置项相同，key为前缀匹配。

require.config( {    // ...    urlArgs: 'v=2.0.0' // 指定所有模块的路径后参数} );

require.config( {    // ...    urlArgs: {        common: '1.2.0' // 为common和common下的子模块指定路径后参数    }} );

更改urlArgs将导致相关模块的缓存全部失效。除非系统升级时对用户更新时效性要求非常高，不建议使用urlArgs配置项。

noRequests

Object

非AMD标准配置项，指定哪些模块不需要发送网络请求。通常用于在生产环境下，为优化网络连接进行模块合并。

• key为string。和map配置项一样，key的模块id为前缀匹配。
• value为Array | string，可指定一个或多个模块id，完整匹配，支持*表示所有模块。

在同一个异步require的调用中，如果存在value指定的模块，则认为被key匹配的模块的声明被合并在value指定的模块中，被key匹配的模块不发送网络请求。

require.config( {    // ...    noRequests: {        'report': 'main',        'zrender/shape': 'zrender'    }} );// report/daily 将发送请求require(     [ 'report/daily' ],     function ( daily ) {        // ......    });// report/weekly 将不发送请求require(     [ 'report/weekly', 'main' ],     function ( weekly, main ) {        // ......    });// zrender/shape/Text 将不发送请求require(     [ 'zrender', 'zrender/shape/Text' ],     function ( zrender, TextShape ) {        // ......    });