require-context
去中心化模块加载插件,主要用于配置中心,路由配置等。如配置中心,通过该插件可以分拆成多个模块,便于管理和维护。在大型项目中非常实用,不用手动引用子模块,总模块导出文件不会产生代码冲突。 本插件是根据 wepy-plugin-requireall 修改,如需看原来的代码,可以搜索此插件 在 webpack 中可以使用 require context 来对文件进行自动合并,感觉挺方便的
wepy 框架下:
安装
yarn add wepy-plugin-require-context -D 或 npm install wepy-plugin-require-context -D
配置:
wepy.config.js
文件添加plugins
配置
plugins: {
'require-context': {
filter: new RegExp('index\\.js$')
}
}
一、效果
使用插件前:一个中心配置模块文件:config.js
如下代码,当配置非常多config.js
容易引起冲突,管理和维护也非常困难。
方式 1:
export default { testA: { "name": "testA" }, testB: { "name": "testB" }, testC: { "name": "testC" }, testD: { "name": "testD" } }
方式 2:
export { testA: { "name": "testA" }, testB: { "name": "testB" }, testC: { "name": "testC" }, testD: { "name": "testD" } }
使用插件后:
./config
├── index.js
└── sub_modules
├── testA.js
├── testB.js
├── testC.js
└── testD.js
大家可能说,这个手动拆成多个模块不就可以了。直接修改config/index.js
手动import
和export
。这样话,当sub_modules
每增加一个子模块,index.js
都要手动引入,而且容易冲突。require-context
引入后,只要sub_modules
有新增子模块,自动修改index.js
的包引用和导出。
二、使用方法
wepy.config.js
文件添加plugins
配置
1.配置 plugins: {
'require-context': {
filter: new RegExp('index\\.js$')
}
}
可配参数:
{
src: 'src', //源文件目录
dist: 'dist', //目标文件目录
sourceMap: true, //是否开启sourceMap
filter: new RegExp('\w$'), //文件过滤
rule: RegExp('\\$requireContext\\(.+\\)') //匹配规则
};
文件过滤建议严格一样,这样可以提高构建速度。如配置:new RegExp('index\\.js$')
仅index.js
的文件才需要使用本插件。
2. 项目总模块文件中添加方法调用
项目模块目录结构:
./config
├── index.js (在此文件添加$requireContext
└── sub_modules
├── testA.js
├── testB.js
├── testC.js
└── testD.js
项目总模块文件为config/index.js
,此文件只需要添加以下构建方法即可。为了防止开发工具报错,可以直接注释
// $requireContext('./sub_modules', 'js', 'true')
支持三个参数:
- @param path 子模块路径,为降低设计的复杂度,只支持一级目录,不支持多级目录
- @param fileType [选填]文件类型后缀,子模块文件类型过滤
- @param useDefault [选填]是否使用 default 的方式
3. 子模块导出要求:
方式1: // $requireContext('.', 'js', 'true')
export default {
name: 'B'
}
方式2:// $requireContext('.', 'js')
export {
name: 'B'
}
三、构建结果
'use strict';
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.testD = exports.testC = exports.testB = exports.testA = undefined;
var _testA = require('./sub_modules/testA.js');
var _testA2 = _interopRequireDefault(_testA);
var _testB = require('./sub_modules/testB.js');
var _testB2 = _interopRequireDefault(_testB);
var _testC = require('./sub_modules/testC.js');
var _testC2 = _interopRequireDefault(_testC);
var _testD = require('./sub_modules/testD.js');
var _testD2 = _interopRequireDefault(_testD);
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
方式1:
exports.testA = _testA2.default;
exports.testB = _testB2.default;
exports.testC = _testC2.default;
exports.testD = _testD2.default;
方式2:
exports.testA = _testA2;
exports.testB = _testB2;
exports.testC = _testC2;
exports.testD = _testD2;