fis3-hook-commonjs v0.1.34
fis3-hook-commonjs
fis3 已经默认不自带模块化开发支持,那么如果需要采用 commonjs 规范作为模块化开发,请使用此插件。
请配合 mod.js 一起使用。
注意:需要对目标文件设置 isMod
属性,说明这些文件是模块化代码。
fis.match('/modules/**.js', {
isMod: true
})
这样才会被自动包装成 amd
,才能在浏览器里面运行(当然还得依靠 mod.js)。
另外,所有 isMod
为 true
的文件都会被包裹成 AMD, 如果不想包裹,请设置 wrap
属性为 false
。
设置了 isMod
为 true 的文件可以在 js 里面直接通过 require('文件路径')
的方式来使用,支持相对路径和绝对路径。
var $ = require('/static/lib/jquery.js');
require('./index.js');
如果存在部分模块化文件不是以 commonjs 规范编写的,该插件可以通过配置文件属性 umd2commonjs
尝试兼容。
fis.match('/node_modules/echarts/**.js', {
umd2commonjs: true
})
同时某些 js 内部有很多 require 的用法,如果希望 fis 忽略这部分依赖,可以设置 ignoreDependencies
如:
fis.match('/node_modules/echarts/**.js', {
ignoreDependencies: true
})
自定义模块ID
插件默认使用资源的绝对路径作为模块ID,如果希望更改模块ID,需要对目标文件设置 moduleId
属性
fis.match('/modules/(**).js', {
isMod: true,
moduleId: '$1'
})
通过上述配置,我们可以将 /modules/A.js
的模块ID由 modules/A
改变为 A
安装
全局安装或者本地安装都可以。
npm install -g fis3-hook-commonjs
或者
npm install fis3-hook-commonjs
用法
在 fis-conf.js 中加入以下代码。
fis.hook('commonjs', {
// 配置项
});
注意
虽然支持 paths 和 packages 设置,目的主要是为了迁移代码用的,从零开发,推荐直接使用 require('文件路径')
的方式,更简单明了。
配置项
以下所有配置都是可选配置。简单使用可以跳过。
baseUrl
默认为.
即项目根目录。用来配置模块查找根目录。paths
用来设置别名,路径基于baseUrl
设置。fis.hook('commonjs', { paths: { $: '/modules/jquery/jquery-1.11.2.js' } });
packages
用来配置包信息,方便项目中引用。fis.hook('commonjs', { packages: [ { name: 'foo', location: './modules/foo', main: 'index.js' } ] });
- 当
require('foo')
的时候等价于require('/modules/foo/index.js')
. - 当
require('foo/a.js')
的时候,等价于require('/modules/foo/a.js')
.
- 当
forwardDeclaration
默认为false
, 用来设置是否开启依赖前置,根据前端加载器来定,mod.js 是不需要的。skipBuiltinModules
默认为true
, 只有在forwardDeclaration
启动的时候才有效,用来设置前置依赖列表中是否跳过内置模块如:require
,module
,exports
。extList
默认为['.js', '.coffee', '.jsx', '.es6']
,当引用模块时没有指定后缀,该插件会尝试这些后缀。tab
默认为2
, 用来设置包裹时,内容缩进的空格数。ignoreDependencies
默认为 空,用来忽略掉对某些资源require
,一般用来忽略掉内部实现的require
资源。fis.hook('commonjs', { // 忽略 angular2 的依赖。我自己负责加载需要资源。 ignoreDependencies: [ 'angular2/**', ] });
3 years ago
3 years ago
5 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
8 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago