1. 程式人生 > >腳手架vue-cli系列四:vue-cli工程webpack的基本用法

腳手架vue-cli系列四:vue-cli工程webpack的基本用法

webpack的打包依賴於它的一個重要配置檔案webpack.config.js,在這個配置檔案中就可以指定所有在原始碼編譯過程中的工作了,就一個配置就可以與冗長的Gruntfile或者Gulpfile說再見了。

一個完整的工程專案中的webpack的配置遠遠沒有這麼簡單,隨著工程的構建要求的增加,webpack.config.js內的配置專案也會隨之增加,webpack還有許許多多的選項提供給我們進行靈活配置,它只是一個構建工具,我們只需要瞭解在Vue專案中它基本能為我們做到的工作、最小化的配置是如何的就足夠了,在以後需要對它進行擴充套件與優化時,帶著問題去查官方文件也是非常容易的事。

●  樣式表引用

某些頁面或者元件可能具有特定的樣式定義,這些樣式對於其他頁面來說是冗餘的,我們只希望這些元件在應用時才自動載入這些特定的樣式,此時用webpack我們就能在原始碼中加入以下程式碼來動態載入CSS:

    import Vue from 'vue'
    // ... 省略
    // 引用指定的樣式原始檔
    import './app/assets/less/dark.less'
    
    export default {
      // ... 省略
    }
    

此時我們只需要在webpack的配置中加入less-loader,那麼webpack在打包的時候就會自動將less轉換為CSS,並將CSS的動態程式碼生成到JS檔案中。當Vue元件被載入到頁面並例項化後,將在DOM內插入這個特定的行內樣式<style>以實現動態樣式的應用。

對於*.css檔案同樣也是適用的,例如匯入某個第三方庫中必需的樣式表:

import 'uikit/dist/css/components/tabs.css'

●  字型的引用

假設在dark.less內加入對自定義字型檔案的樣式定義:

@font-face {
       font-family: 'Darkenstone';
       src: url('./Darkenstone.eot');
       src: url('./Darkenstone.eot?#iefix') format('embedded-opentype'),
           url('./Darkenstone.woff2') format('woff2'),
           url('./Darkenstone.woff') format('woff'),
           url('./Darkenstone.ttf') format('truetype'),
           url('./Darkenstone.svg#Darkenstone') format('svg');
           font-weight: normal;          
           font-style: normal;
}

.header{
       display: flex;
       flex-flow: row nowrap;

       & > h1 {
          font: 16pt 'Darkenstone';
       }
}

這裡.header>h1指定了一個Darkenstone的自定義字型,這個字型瀏覽器一定是不能識別的,以前我們在樣式表中先定義這個字型樣式並指定載入位置(如上文@font-face的定義),然後在頁面中引用這個樣式表,這是多麼麻煩的一件事,不是嗎?

如果用了webpack後,我們只是在配置檔案內加入了一個url-loader:

{
      test: /\.(woff2?|eot|ttf|otf)(\?.*)?$/,
      loader: 'url'
}

我們並不需要在原始碼中做任何改變,因為之前已經引用過樣式表dark.less,而字型是在樣式表中的,webpack將在打包的時候為我們識別並在程式碼中引入字型的動態載入。這樣一來極大地解決了我們對資源引用的依賴問題!

vue-cli的webpack模板已經為我們配置好了絕大多數常用的loader,在實際運用中我們只需要瞭解它們是怎麼來的,應該怎麼用,需要的時候如何修改就夠了。

●  用別名取代路徑引用

在專案開發過程中有可能有許多包是沒有放在npm上的,有一些較老的可能還依然只存在於bower上,某些甚至在bower與npm上都找不到,而不得不通過下載的方式在專案內引用,這樣一來我們的程式碼可能通過require就得在程式碼內引用一段很長的檔案路徑,如下所示

import Selector from '../../bower_components/bootstrap-select/dist/js/select'

這種包的引用方式明顯違反了CommonJS的程式設計規範,對於這些長路徑,甚至還具有“../..”這些相對路徑搜尋的定義,我們可以通過webpack的resolve配置項來解決。就以select這個元件為例,在webpack.base.config.js中加入以下的這個別名的定義:

    module.exports = {
       entry:{ ... },
       output: { ... },
       module:{ ... },
       resolve: {
          extensions:['','.js'],
          alias:{ // 別名
             'bs-select':'bower_components/bootstrap-select/dist/js/select.js'
          }
       }
    }

有了這個定義以後,我們就可以將上面那個長引用改為下面的寫法:

 import Selector from 'bs-select';

絕對不要讓路徑引用進入到我們的程式碼,因為這是程式碼的“癌症”,一旦開始植入並生長起來,以前的程式碼將難以維護!

●  配置多入口程式

多數情況下我們的程式入口不單單隻有一個,舉一個最簡單的例子,前臺提供給終端使用者使用(http://www.domain.com/index),後臺提供給登入使用者使用(http://www.domain.com/admin/),那麼自然需要多個與main.js類似的程式入口了。

首先在build/webpack.base.conf.js配置檔案中的entry配置屬性上加上新的入口檔案:

    module.exports = {
      entry: {
        app: './src/main.js',
        admin : './src/admin-main.js'
      },
      // ... 省略
    }

這是用於告訴webpack哪幾個是入口檔案,這些檔案需要被生成到啟動頁的<script>內。

vue-cli的webpack模板使用HtmlWebpackPlugin外掛,生成HTML入口頁面並自動將生成後的JS檔案和CSS檔案的引用地址寫入到頁內的<script>中。

這裡就需要在build/webpack.dev.config.js檔案內的plugins配置項內多配置一個HtmlWebpackPlugin外掛,用於生成admin.html入口頁。

     plugins:[
      // ... 省略

      // 這是原有的配置項,用於匹配注入app.js的輸出指令碼
      new HtmlWebpackPlugin({
        filename: process.env.NODE_ENV === 'testing'
          ? 'index.html'
          : config.build.index,
        template: 'index.html',
        chunks: ['app'], // 與原配置的不同的是要用chunks指定對應的entry
        inject: true,
        minify: {
          removeComments: true,
          collapseWhitespace: true,
          removeAttributeQuotes: true
        },
        chunksSortMode: 'dependency'
      }),

      // 這是新增項,用於匹配注入admin.js的輸出指令碼
      new HtmlWebpackPlugin({
        filename: process.env.NODE_ENV === 'testing'
          ? 'admin.html'
          : config.build.admin,
        template: 'index.html',
        chunks: ['admin'],
        inject: true,
        minify: {
          removeComments: true,
          collapseWhitespace: true,
          removeAttributeQuotes: true
        },
        chunksSortMode: 'dependency'
      }),
    ]

需要強調一點的是,這裡的HtmlWebpackPlugin配置必須用chunks指定在上文entry內對應的入口檔案的別名。

關於HtmlWebpackPlugin更多配置內容可以參考:https://github.com/kangax/html-minifier#options-quick-reference。

還有就是得將同樣的配置加入到生產環境專用的webpack配置檔案webpack.prod.conf.js中,否則當我們執行npm run build時是不會輸出admin.js和admin.html這兩個入口檔案的(由於配置內容相同這裡就不再重複了)。

最後,如果使用了vue-router就得對connect-history-api-fallback外掛的配置進行修改,否則原有的預設配置只會將所有的請求轉發給index.html,這樣就會導致History API沒有辦法正確地將請求指向admin.html,導致熱載入失敗,具體做法如下所述。

開啟dev-server.js檔案,將app.use(require('connect-history-api-fallback')())配置改為以下的方式:

    // handle fallback for HTML5 history API
    var history = require('connect-history-api-fallback')
    // app.use(require('connect-history-api-fallback')())

    app.use(history({
      rewrites: [
        { from: /^\/admin\/.*$/, to: '/admin.html' }
      ]
    }));

新入口需要有明確區分的路由規則,否則還是會產生熱載入失敗的情況,這樣就非常不便於開發了。