使用 webpack 搭建多入口项目
闲来无事,学习一下怎么用 webpack 自定义多入口项目的打包
项目github地址:https://github.com/xiaoliwang2016/webpack-demo
先来看一下目录结构
/admin、/home:模块,可以根据需求分,也可以只需要一个模块
/htmlConfig:因为是多入口项目,因此需要一个配置文件来记录多个入口的路径,以及与模块之间的层级关系,单入口文件仅需要定义一个入口,webpack会自动追踪依赖关系,多入口需要定义多个,所以单独存起来会好一些
/webpack.config.js:webpack配置默认文件,可以根据在开发环境和生成坏境分开
/模块/html:放置页面文件
/模块/html/tpl:放置一些公用的模板
/模块/js:放置对应的js文件,名称与html页面一致
/模块/css:放置样式文件
然后来看一下打包后的目录
js文件统一放置在/dist/js目录,页面文件放在各自模块名称对应的目录下
看完最终效果我们来看一下webpack配置项
入口配置文件
首先看一下前面提到的 htmlConfig.js 文件
module.exports = { 'admin' : [ 'index', 'login' ], 'home' : [ 'index' ] }
很简单,就是记录了各个模块下的页面的名称,然后在webpack.config.js中拿去到这个配置项,遍历打包这些页面
webpack配置文件
webpack会默认读取根目录下webpack.config.js文件,通常可以将这个文件拆分成dev和pro,这里用作演示,没有分开
const path = require('path') const htmlConfig = require('./htmlConfig.js') //生成html插件 const htmlWebpackPlugin = require('html-webpack-plugin') //抽离css插件 const MiniCssExtractPlugin = require("mini-css-extract-plugin"); var htmlWebpackPlugins = [] var entrys = {} for(var key in htmlConfig){ htmlConfig[key].forEach(item => { //生成 entry 对象中的 key 例如 { admin-login: './admin/login.html' } var k = key + '-' + item htmlWebpackPlugins.push(new htmlWebpackPlugin({ //template设置根据那个模板生成 template: `./src/${key}/html/${item}.html`, //生成html名称 filename: `./${key}/${item}.html`, //chunks 设置需要引入的JS模块 chunks: [k], //自动引入js 可选:true(底部)/body/head inject: true, })) entrys[k] = `./src/${key}/js/${item}.js` }) } module.exports = { mode: 'production', entry: entrys, output: { path: path.resolve(__dirname, 'dist'), // name:对应entry的key ,chunkhash根据文件进行MD5自动计算 filename: 'js/[name]-[chunkhash].js', //上线时可以使用 publicPath替换根路径 // publicPath: 'http://cdn.com/' }, module:{ rules: [ { test: /\.js$/, //排除项 exclude: path.resolve(__dirname, 'node_modules'), //选择项 include: path.resolve(__dirname, 'src'), loader: "babel-loader", //babel需要配合 babel-preset-env 一起使用 query: { "presets": ["env"] } }, { test: /\.css$/, //同一个文件需要多个loader的情况下可以使用数组,执行顺序根据数组从后往前执行 use: [ //使用MiniCssExtractPlugin.loader代替style-loader抽离css成单独文件 MiniCssExtractPlugin.loader, // 'style-loader', //每个loader可以有自己的参数,options字段就是定义参数 { loader: 'css-loader', options: {importLoaders: 1}}, { loader: 'postcss-loader', options: { ident: 'postcss', //autoprefixer是postcss-loader的一个插件,需要安装,用于给css添加前缀 plugins: [ require('autoprefixer')({ cascade: false }) ] } } ] }, { test: /\.tpl$/, loader: 'ejs-loader' } ] }, plugins: [ new MiniCssExtractPlugin({ filename: "css/[name].css", chunkFilename: "[id].css" }), ...htmlWebpackPlugins ] }
注意:这里需要注意的是使用 loader 打包文件时调用 loader 的顺序时根据数组从后往前,因此这里处理css文件的顺序时:
postcss-loader --> css-loader --> style-loader
* postcss-loader是一个css后处理器,他提供很多插件可以处理css文件,例如css自动添加前缀,压缩等等
loader
js
webpack默认只会处理js文件,因此如果有需要处理不同文件时需要指定对应的loader
例如常用转换js语法的loader:babel-loader
安装:
npm install babel-loader --save-dev
npm install babel-preset-env --save-dev
然后需要在制定位置添加 presets 配置项
可以是 padkjson.js 或者 .babelrc 文件 或者webpack.config.js中
模板
多入口文件一般一个页面对应一个js文件,可以在js文件中再次引入其他的模板(页面),在通过loader解析最后插入到当前页面
例如这里的/admin/js/index.js对应的模板时/admin/html/index.html,然而还可以在index.js中引入一些其他的模板,例如引入admin/html/tpl/table.tpl,然后渲染插入到index.html中
在处理模板文件时可以根据不同的模板设置不同的loader处理,这里演示的是ejs的模板
<table class="table"> <tr> <th>brand</th> <th>name</th> <th>price</th> </tr> <% for(var i = 0; i < data.length; i++) { %> <tr> <td><%= data[i].brand %></td> <td><%= data[i].name %></td> <td><%= data[i].price %></td> </tr> <% } %> </table>
在webpack.config.js中配置loader
{ test: /\.tpl$/, loader: 'ejs-loader' }
在js文件中可以直接通过import的放置引入该模板文件
import table from '../html/layer/table.tpl'
ejs-loader处理完成后会返回一个函数(html-loader返回为字符串),函数的参数为模板的变量,例如在admin/js/index.js文件中引入模板然后插入到页面
import '../css/index.css' import table from '../html/layer/table.tpl' document.querySelector('#table').innerHTML = table({ data : [ {brand: 'MI', name: 'MI6', price: 2999}, {brand: 'iphone', name: 'iphoneX', price: 9999} ] })
生成后页面
样式
可以在js中直接通过import的方式引入
import '../css/index.css'
也可以在css中引入其他的css文件
@import './common.css';
css文件中分号一定要带上