前言

一開始接觸webpack是因?yàn)槭褂肰ue的關(guān)系，因?yàn)閂ue的腳手架就是使用webpack構(gòu)建的。剛開始的時(shí)候覺得webpack就是為了打包單頁面而生的，后來想想，這么好的打包方案，只在單頁面上使用是否太浪費(fèi)資源了呢？如果能在傳統(tǒng)多頁面上使用webpack，開始效率是否會(huì)事半功倍呢？好在眾多優(yōu)秀的前端開發(fā)者已經(jīng)寫了許多demo和文章供人學(xué)習(xí)。我也寫了一個(gè)小項(xiàng)目，希望對大家學(xué)習(xí)webpack有幫助。

好吧其實(shí)上面說的都是廢話，接下來附上項(xiàng)目地址和干貨，配合食用更佳。

webpack-multi-page

項(xiàng)目解決的問題

• SPA好復(fù)雜，我還是喜歡傳統(tǒng)的多頁應(yīng)用怎么破？又或是，我司項(xiàng)目需要后端渲染，頁面模板怎么出？
• 每個(gè)頁面相同的UI布局好難維護(hù)，UI稍微改一點(diǎn)就要到每個(gè)頁面去改，好麻煩還容易漏，怎么破？
• 能不能整合進(jìn)ESLint來檢查語法？
• 能不能整合postcss來加強(qiáng)瀏覽器兼容性？
• 我可以使用在webpack中使用jquery嗎？
• 我可以使用在webpack中使用typescript嗎？

src目錄對應(yīng)dist目錄

當(dāng)我們使用webpack打包多頁面，我們希望src目錄對應(yīng)打包后dist目錄是如上圖這樣的，開發(fā)根據(jù)頁面模塊的思路搭建開發(fā)架構(gòu)，然后經(jīng)過webpack打包，生成傳統(tǒng)頁面的構(gòu)架。

/**
 * 創(chuàng)建打包路徑
 */
const createFiles = function() {
 const usePug = require('../config').usePug;
 const useTypeScript = require('../config').useTypeScript;
 const path = require('path');
 const glob = require('glob');
 const result = [];
 const type = usePug ? 'pug' : 'html';
 const scriptType = useTypeScript ? 'ts' : 'js';
 const files = glob.sync(path.join(__dirname, `../src/views/**/*.${type}`));
 for (file of files) {
  result.push({
   name: usePug ? file.match(/\w{0,}(?=\.pug)/)[0] : file.match(/\w{0,}(?=\.html)/)[0],
   templatePath: file,
   jsPath: file.replace(type, scriptType),
   stylePath: file.replace(type, 'stylus')
  });
 }
 return result;
};

利用這個(gè)方法，我們可以獲得需要打包的文件路徑(方法中獲取文件路徑的模塊也可使用fs模塊)，根據(jù)獲得打包的文件路徑，我們可以使用html-webpack-plugin來實(shí)現(xiàn)多頁面打包。

由于每一個(gè)html-webpack-plugin的對象實(shí)例都只針對/生成一個(gè)頁面，因此，我們做多頁應(yīng)用的話，就要配置多個(gè)html-webpack-plugin的對象實(shí)例：

const plugins = function() {
 const files = createFiles();
 const HtmlWebpackPlugin = require('html-webpack-plugin');
 const path = require('path');
 const ExtractTextPlugin = require('extract-text-webpack-plugin');

 let htmlPlugins = [];
 let Entries = {};
 files.map(file => {
  htmlPlugins.push(
   new HtmlWebpackPlugin({
    filename: `${file.name}.html`,
    template: file.templatePath,
    chunks: [file.name]
   })
  );
  Entries[file.name] = file.jsPath;
 });

 return {
  plugins: [
   ...htmlPlugins,
   new ExtractTextPlugin({
    filename: getPath => {
     return getPath('css/[name].css');
    }
   })
  ],
  Entries
 };
};

由于我使用了ExtractTextPlugin，因此這些CSS代碼最終都會(huì)生成到所屬chunk的目錄里成為一個(gè)CSS文件。

模版引擎

每個(gè)頁面相同的UI布局好難維護(hù)，UI稍微改一點(diǎn)就要到每個(gè)頁面去改，好麻煩還容易漏，怎么破？

考慮到這個(gè)問題，項(xiàng)目引進(jìn)并使用了pug模版引擎。

現(xiàn)在，我們可以利用pug的特性，創(chuàng)建一個(gè)共用組件：

demo.pug

p 這是一個(gè)共用組件

然后，當(dāng)你需要使用這個(gè)公用組件時(shí)可以引入進(jìn)來：

include 'demo.pug'

除此之外，你還可以使用一切pug特供的特性。

webpack中配置pug也很簡單，先安裝：

npm i --save-dev pug pug-html-loader

然后將所有.html后綴的改為.pug后綴，并且使用pug語法。

然后在規(guī)則中再增加一條配置

{
  test: /\.pug$/,
  use: 'pug-html-loader'
}

同時(shí)把plugins對象中的用到index.html的HtmlWebpackPlugin中的template，也要改成index.pug。

webpack整合eslint

先放出配置代碼:

if (useEslint) {
 loaders.push({
  test: /\.js$/,
  loader: 'eslint-loader',
  enforce: 'pre',
  include: [path.resolve(__dirname, 'src')],
  options: {
   formatter: require('stylish')
  }
 });
}

通過webpack整合ESLint，我們可以保證編譯生成的代碼都是沒有語法錯(cuò)誤且符合編碼規(guī)范的；但在開發(fā)過程中，等到編譯的時(shí)候才察覺到問題可能也是太慢了點(diǎn)兒。

因此我建議可以把ESLint整合進(jìn)編輯器或IDE里，像我本人在用vs code，就可以使用一個(gè)名為Eslint的插件，一寫了有問題的代碼，就馬上會(huì)標(biāo)識出來。

dev環(huán)境與prod環(huán)境

首先，閱讀webpacl項(xiàng)目的時(shí)候通常要先看package.json這個(gè)文件。因?yàn)楫?dāng)你在命令行敲下一句命令

npm run dev

webpack就會(huì)找到package.json文件中的script屬性并依次分析命令,可見,這句命令相應(yīng)的會(huì)執(zhí)行

同樣的，當(dāng)寫下命令

npm run build

script就會(huì)執(zhí)行

ross-env NODE_ENV=production webpack --config build/webpack.prod.js

這樣就能區(qū)分開發(fā)環(huán)境，或是生產(chǎn)環(huán)境了。

雖然我們會(huì)為環(huán)境做區(qū)分,但是基于不重復(fù)原則,項(xiàng)目為兩個(gè)環(huán)境公用的配置整合到了(build/webpack.base.js)文件中。然后利用webpack-merge插件將配置整合在一起

webpack中使用jquery

在webpack中使用jquery也很簡單，我們可以在loaders中增加一條配置：

if (useJquery) {
 loaders.push({
  // 通過require('jquery')來引入
  test: require.resolve('jquery'),
  use: [
   {
    loader: 'expose-loader',
    // 暴露出去的全局變量的名稱 隨便你自定義
    options: 'jQuery'
   },
   {
    // 同上
    loader: 'expose-loader',
    options: '$'
   }
  ]
 });
}

然后當(dāng)你需要在某個(gè)js文件使用jq時(shí)，引用暴露出來的變量名即可：

import $ from 'jQuery';

webpack中使用typescript

在webpack中使用jquery也很簡單，我們可以在loaders中增加一條配置：

if (useTs) {
 loaders.push({
  test: /\.tsx?$/,
  use: 'ts-loader',
  exclude: /node_modules/
 });
}

然后將js文件改為ts即可。

以上就是本文的全部內(nèi)容，希望對大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評論