使用 webpack 搭建多入口项目

时间:2021-10-27 08:44:21

闲来无事,学习一下怎么用 webpack 自定义多入口项目的打包

项目github地址:https://github.com/xiaoliwang2016/webpack-demo

先来看一下目录结构

使用 webpack 搭建多入口项目

/admin、/home:模块,可以根据需求分,也可以只需要一个模块

/htmlConfig:因为是多入口项目,因此需要一个配置文件来记录多个入口的路径,以及与模块之间的层级关系,单入口文件仅需要定义一个入口,webpack会自动追踪依赖关系,多入口需要定义多个,所以单独存起来会好一些

/webpack.config.js:webpack配置默认文件,可以根据在开发环境和生成坏境分开

/模块/html:放置页面文件

/模块/html/tpl:放置一些公用的模板

/模块/js:放置对应的js文件,名称与html页面一致

/模块/css:放置样式文件

然后来看一下打包后的目录

使用 webpack 搭建多入口项目

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解析最后插入到当前页面

使用 webpack 搭建多入口项目

例如这里的/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}
]
})

生成后页面

使用 webpack 搭建多入口项目

样式

可以在js中直接通过import的方式引入

import '../css/index.css'

也可以在css中引入其他的css文件

@import './common.css';

css文件中分号一定要带上