天天看點

webpack多個Html,使用webpack建構多頁面應用

關于webpack的配置和使用,網上已經有許多文章了,大多是在講單頁應用,當我們需要打包多個html時,事情就變得麻煩起來。怎麼在webpack-dev-server裡使用路由?怎麼打包多個html和js chunk并自動更新md5?本文講的就是如何解決這些問題。

這裡假設你對Webpack已經有最基礎的了解

需求

來看下我們的需求:

使用webpack-dev-server做開發時的伺服器

在webpack-dev-server裡使用路由,通路/a時候顯示a.html,/b顯示b.html

打包成多個html,給其中引用到資源加md5戳

主要目錄結構

├── src

│ └── views # 每一個檔案夾對應一個頁面

│ └── a

│ └── index.js

│ └── b

│ └── index.js

├── output # 打包輸出的目錄

| └── ...

└── template.html # 将根據這個模版,生成各個頁面的html

└── webpack.config.js

└── dev-server.js # webpack-dev-server + express

隻列出了主要的目錄,這裡我們根據一個template.html來生成多個頁面的html,他們之間隻有引用的資源路徑不同。當然,你也可以每個頁面單獨使用一個html模版。

Webpack 配置

這裡主要解決兩個小問題。

1. 打包多個頁面的js檔案

讀取src/views下的目錄,約定每一個目錄當成一個頁面,打包成一個js chunk。

2. 打包多個html

循環生成多個HtmlWebpackPlugin插件,把每一個插件的chunks各自指向上面打包的js chunk。

// webpack.config.js

var glob = require('glob');

var webpackConfig = {

};

// 擷取指定路徑下的入口檔案

function getEntries(globPath) {

var files = glob.sync(globPath),

entries = {};

files.forEach(function(filepath) {

// 取倒數第二層(view下面的檔案夾)做包名

var split = filepath.split('/');

var name = split[split.length - 2];

entries[name] = './' + filepath;

});

return entries;

}

var entries = getEntries('src/viewindex.js');

Object.keys(entries).forEach(function(name) {

// 每個頁面生成一個entry,如果需要HotUpdate,在這裡修改entry

webpackConfig.entry[name] = entries[name];

// 每個頁面生成一個html

var plugin = new HtmlWebpackPlugin({

// 生成出來的html檔案名

filename: name + '.html',

// 每個html的模版,這裡多個頁面使用同一個模版

template: './template.html',

// 自動将引用插入html

inject: true,

// 每個html引用的js子產品,也可以在這裡加上vendor等公用子產品

chunks: [name]

});

webpackConfig.plugins.push(plugin);

})

路由配置

在多頁應用下,我們希望通路的是localhost:8080/a,而不是localhost:8080/a.html。

由于webpack-dev-server隻是将檔案打包在記憶體裡,是以你沒法在express裡直接sendfile('output/views/a.html'),因為這個檔案實際上還不存在。還好webpack提供了一個outputFileStream,用來輸出其記憶體裡的檔案,我們可以利用它來做路由。

注意,為了自定義路由,你可能需要引進express或koa之類的庫,然後将webpack-dev-server作為中間件處理。

// dev-server.js

var express = require('express')

var webpack = require('webpack')

var webpackConfig = require('./webpack.config')

var app = express();

// webpack編譯器

var compiler = webpack(webpackConfig);

// webpack-dev-server中間件

var devMiddleware = require('webpack-dev-middleware')(compiler, {

publicPath: webpackConfig.output.publicPath,

stats: {

colors: true,

chunks: false

}

});

app.use(devMiddleware)

// 路由

app.get('/:viewname?', function(req, res, next) {

var viewname = req.params.viewname

? req.params.viewname + '.html'

: 'index.html';

var filepath = path.join(compiler.outputPath, viewname);

// 使用webpack提供的outputFileSystem

compiler.outputFileSystem.readFile(filepath, function(err, result) {

if (err) {

// something error

return next(err);

}

res.set('content-type', 'text/html');

res.send(result);

res.end();

});

});

module.exports = app.listen(8080, function(err) {

if (err) {

// do something

return;

}

console.log('Listening at http://localhost:' + port + '\n')

})

最後,在package.json裡定義下啟動指令:

// package.json

{

scripts: {

"dev": "node ./dev-server.js"

}

}

運作 npm run dev,然後在浏覽器通路localhost:8080/各個頁面,你應該可以看到想要的結果。