前言
在理论开发要求中咱们可能无奈是应用单页面开发框架(例如 vue,react),这些要求次要是基于 SEO 角度登程(当然能够应用服务端渲染解决,这里咱们不思考),这时候咱们就须要进行传统模式的前端开发,传统模式下会有 css 兼容与压缩,icon 图片 base64 化缩小 http 申请,公共代码引入,js 模块化等根底问题。对于 wepack 多页面打包的材料文档很丰盛,理论遇到问题不要惊恐能够去网上查问或者去看看官网文档(webpack 文档 - 传送门)。本篇文章是基于最新版本的 webpack 来实现多页面打包的,不仅解决了上述根底问题还减少了本地服务,批改自更新,公共代码主动引入等实用功能。本文的 webpack 打包框架已开源至 githua 欢送大家的 start(git- 传送门)
上面咱们采纳已性能为导向的 webpack5 多页面打包配置介绍
性能配置篇
1、初始化 webpack
npm init
npm install webpack webpack-cli -g // -g 更换为 --save-dev 是本地装置
webpack-cli init
2、图片文件及其他文件解决,webpack5 集中到了 asset 模块, 之前应用 file-loader、url-loader、raw-loader 三个
asset/resource 将资源宰割为独自的文件,并导出 url,就是之前的 file-loader 的性能.
asset/inline 将资源导出为 dataURL(url(data:))的模式,之前的 url-loader 的性能.
asset/source 将资源导出为源码(source code). 之前的 raw-loader 性能.
asset 主动抉择导出为独自文件或者 dataURL 模式(默认为 8KB). 之前有 url-loader 设置 asset size limit 限度实现。
配置
webpack.config.js
module: {
rules: [
{test: /\.(eot|svg|ttf|woff|woff2|png|jpg|gif)$/i,
type: "asset",
generator: {
// 输入文件名
filename: 'static/[hash][ext][query]'
}
}
]
}
// 还能够限度解决的大小,这里应用了默认值
3、解决 html 文件,为了后盾敌人好绑定不进行压缩操作,解决 html 里 icon 与资源
webpack.config.js
module: {
rules: [
{
test: /\.html$/,
loader: 'html-loader',
options: {
minimize: false,
// html 不解决 link\script 标签(为了引入动态资源不 hash)
sources: {
list: [
'...',
{
tag: 'script',
attribute: 'src',
type: 'src',
filter : () => false,},
{
tag: 'link',
attribute: 'href',
type: 'src',
filter : () => false,}
]
}
}
}
]
}
4、解决 js、css 进行兼容与压缩
webpack.config.js
const CssMinimizerPlugin = require('css-minimizer-webpack-plugin');
const MiniCssExtractPlugin = require("mini-css-extract-plugin");
const stylesHandler = MiniCssExtractPlugin.loader;
plugins: [new CssMinimizerPlugin() // css 压缩
],
module: {
rules: [
{test: /\.(js|jsx)$/i,
loader: "babel-loader",
},
{
test: /\.css$/i,
use: [stylesHandler, "css-loader", "postcss-loader"],
}
]
}
5、公共代码解决,这里解决的是当多个页面(>=2)有独特引入的话做一次打包引入到多页面,从而节省开支缩小 http 申请。主动引入公共文件会在下边解说。
const MiniCssExtractPlugin = require("mini-css-extract-plugin");
plugins: [
// 合并文件内 css
new MiniCssExtractPlugin({filename: 'css/[name]/[name].[hash].css'
}),
// 复制动态资源库
new CopyPlugin({
patterns: [{ from: path.resolve(__dirname, 'static'), to: 'static' }
],
})
]
optimization: {
splitChunks: {
cacheGroups: {
// 打包公共模块
commons: {
//initial 示意提取入口文件的公共局部
chunks: 'initial',
// 示意提取公共局部起码的文件数
minChunks: 2,
// 示意提取公共局部最小的大小
minSize: 0,
// 提取进去的文件命名
name: 'commons'
}
}
}
}
6、工程化配置入口文件及入口模板
wepack.batch.entry.js(创立)
const path = require('path')
const glob = require('glob')
const HtmlWebpackPlugin = require("html-webpack-plugin");
const publicPath = './'
// 入口文件
const entry = {}
// 入口文件对应的模板
const entryTemplate = []
exports.entry = () => {seekAllFile()
setEntryTemplate()
return {entry, entryTemplate}
}
// 失去 pages 文件夹下所有入口文件(反对有限嵌套)
const seekAllFile = (parent = 'pages/*') => {const fileList = glob.sync(path.resolve(__dirname, parent))
if (fileList.length > 0) {
fileList.forEach(file => {const regJs = file.match(/.*\/(.*js)/i)
if (regJs !== null && regJs[1]) {const jsName = regJs[1]
const key = jsName.match(/(.*).js/i)[1]
entry[key] = publicPath + parent.replace(/\*/, '') + jsName
} else {const parentPath = parent.replace(/\*/, '')
const reg = new RegExp(parentPath + '(.*)', 'i')
const folder = file.match(reg)[1]
if (!file.match(/.*\/(.*?)\..*/)) {console.log(file)
seekAllFile(parentPath + folder + '/*')
}
}
})
} else {return}
}
// 设置入口文件的模板文件(附加性能)
const setEntryTemplate = () => {Object.keys(entry).forEach(key => {
entryTemplate.push(new HtmlWebpackPlugin({template: entry[key].replace(/\.js/, '.html'),
filename: key + '.html',
chunks: [key],
inject: 'body',
minify: false
}))
})
}
pages 下的所有文件会被主动设置问入口及入口文件(反对有限嵌套),然而要求构造如下
pages/index/index.js index.html js 文件名与 html 文件名同名且同级
这样入口文件为 js, 模板为 html
webpack.config.js
const batch = require('./wepack.batch.entry')['entry']();
{
entry: batch.entry,
plugins: [
// 入口文件对应的模板
...batch.entryTemplate,
]
}
7、主动引入公共文件,前提是在根目录创立 automation 文件夹,目录下 index.js 里的引入资源会被引入到个个模板中
webpack.automation.load.js(创立)
// 自动化引入公共文件(如 reset.css)
/**
* @desc: 主动引入公共文件 - 所有模板
* @param {Object} batch.entry 入口文件
* @param {Array} batch.entryTemplate 模板
*/
exports.automation = (batch) => {batch.entry['automations'] = './automation/index.js'
batch.entryTemplate.forEach(item => {item.userOptions.chunks.unshift('automations')
item.userOptions.chunksSortMode = 'manual'
})
}
webpack.config.js
const batch = require('./wepack.batch.entry')['entry']();
const autoLoad = require('./webpack.automation.load')
// 主动引入 automation/index.js 中的内容 - 可自在配置
autoLoad.automation(batch)
automation/index.js
import '../common/css/reset.css'
这样每个入口文件模板就会引入 reset.css,性能外围就是配置 HtmlWebpackPlugin 的 chunks
8、本机服务及批改自更新
webpack.config.js
const {CleanWebpackPlugin} = require('clean-webpack-plugin');
output: {path: path.resolve(__dirname, "dist"),
filename: 'js/[name]/[name].[hash].js'
},
devServer: {contentBase: path.resolve(__dirname, "dist"),
compress: true,
hot: false,
open: true,
port: 8080,
},
plugins: [
// 革除生成文件夹在 build
new CleanWebpackPlugin(),]
webpack5 的多页面打包根本配置就如上所述了,对于本文 demo 已开源至 github(git- 传送门),如果您有应用问题请您发问或者 git 上 issues 问题