Webpack多页面应用配置详解：入口、HTML与CSS抽取

Webpack多页面应用构建概述

前言

此前曾基于vue2.x与webpack3.x开发过一个Vue单页应用（SPA）脚手架项目。

该Vue版SPA脚手架项目

有兴趣的读者可以查阅，项目内附有详细注释，非常适合初学者学习Webpack的基础用法。

此外还有React版的SPA脚手架项目

然而在某些业务场景下，单页应用往往难以满足需求，因此衍生出了

mulXc-cli

接下来直接切入主题。

项目文件结构与核心思路

文件结构


├── build            构建服务和webpack配置
 ├──── build.js         构建全量压缩包 (打包项目)
 ├──── setting.js        多页面入口配置
 ├──── style.js         页面1对1抽取生成css文件
 ├──── utils.js         工具类
 ├──── webpack.base.conf.js   webpack通用配置
 ├──── webpack.dev.conf.js    webpack开发环境配置
 ├──── webpack.prod.conf.js   webpack生产环境配置
├── config           webpack开发/生产环境部分配置
├── dist            项目打包目录
├── package.json        项目配置文件
├── src             项目目录
├──── common          多页面公用方法与css
├──── about           about页面
├──── home           home页面

核心思路

多页面应用（MPA）的定义即包含多个独立页面。

从Webpack的配置视角来看，主要涉及以下三点：

首先，配置多个入口（entry），每个页面对应一个独立的JS资源入口。

其次，生成多个HTML实例，通过html-webpack-plugin插件为每个页面生成对应的HTML文件。

最后，确保每个页面拥有独立的CSS文件，利用extract-text-webpack-plugin插件将CSS从JS中抽取出来。

完成上述配置后，多页面应用的基本要素即已具备，开始具体实现。

入口配置与HTML生成实现

入口配置与HTML页面生成

根据前述文件结构，多页面入口配置及HTML生成逻辑位于build/setting.js文件中。

setting.js文件内容


//node 文件操作模块
const fs = require('fs');

//node 路径模块
const path = require('path');

//使用node.js 的文件操作模块来获取src文件夹下的文件夹名称 ->[about,common,home]
const entryFiles = fs.readdirSync(path.resolve(__dirname, '../src'));

//生成html文件插件
const HtmlWebpackPlugin = require('html-webpack-plugin');

//工具类提取_resolve方法
const { _resolve } = require('./utils');

//入口文件过滤common文件夹(因为common文件夹我们用来存放多页面之间公用的方法与css,所以不放入入口进行构建!)
const rFiles = entryFiles.filter(v => v != 'common');

module.exports = {
 //构建webpack入口
 entryList: () => {
  const entryList = {};
  rFiles.map(v => {
   entryList[v] = _resolve(`../src/${v}/index.js`);
  });
  return entryList;
 },
 //src文件夹下的文件夹名称 ->[about,common,home]
 entryFiles: entryFiles,
 //使用html-webpack-plugin生成多个html页面.=>[home.html,about.html]
 pageList: () => {
  const pageList = [];
  rFiles.map(v => {
   pageList.push(
    new HtmlWebpackPlugin({
     template: _resolve(`../src/${v}/index.html`),
     filename: _resolve(`../dist/${v}.html`),
     chunks: ['common', v],
     //压缩配置
     minify: {
      //删除Html注释
      removeComments: true,
      //去除空格
      collapseWhitespace: true,
      //去除属性引号
      removeAttributeQuotes: true
     },
     chunksSortMode: 'dependency'
    })
   );
  });
  return pageList;
 }
};

webpack.base.conf.js基础配置


//引入setting.js 入口配置方法,与html生成配置
const { entryList, pageList } = require('./setting.js');

const baseConf = {
 entry: entryList(),
 plugins: [...pageList()]
};

CSS独立抽取与生产配置

CSS文件生成逻辑

根据文件结构，CSS文件的生成逻辑位于build/style.js文件中。

style.js文件内容


const path = require('path');
//抽取css文件插件
const ExtractTextPlugin = require('extract-text-webpack-plugin');
//引入入口配置
const { entryList, entryFiles } = require('./setting.js');
//多个ExtractTextPlugin实例
const plugins = [];
entryFiles.map(v => {
 plugins.push(
  new ExtractTextPlugin({
   filename: `css/${v}.[contenthash].css`,
   allChunks: false
  })
 );
});

module.exports = {
 //使用正则匹配到每个页面对应style文件夹下的css/less文件,并配置loader来进行解析.从而实现html<->css 1对1
 rulesList: () => {
  const rules = [];
  entryFiles.map((v, k) => {
   rules.push({
    test: new RegExp(`src(\\\\|\/)${v}(\\\\|\/)style(\\\\|\/).*\.(css|less)$`),
    use: plugins[k].extract({
     fallback: 'style-loader',
     use: ['css-loader', 'postcss-loader', 'less-loader']
    })
   });
  });
  return rules;
 },
 //插件实例
 stylePlugins: plugins
};

webpack.prod.conf.js生产环境配置


//引入方法
const { rulesList, stylePlugins } = require('./style.js');

const prodConf = {
 module: {
  rules: [...rulesList()]
 },
 plugins: [...stylePlugins]
};

以上内容即为本文的全部介绍，希望对读者有所帮助，欢迎继续支持本站。

基于Webpack 3.x的多页面应用构建实践

Webpack多页面应用构建概述

项目文件结构与核心思路

入口配置与HTML生成实现

CSS独立抽取与生产配置

实用工具推荐