溫馨提示×

溫馨提示×

您好,登錄后才能下訂單哦!

密碼登錄×
登錄注冊×
其他方式登錄
點擊 登錄注冊 即表示同意《億速云用戶服務條款》

怎么在Vue+ElementUI項目中使用webpack輸出MPA

發(fā)布時間:2021-03-11 17:13:44 來源:億速云 閱讀:132 作者:Leah 欄目:web開發(fā)

怎么在Vue+ElementUI項目中使用webpack輸出MPA?很多新手對此不是很清楚,為了幫助大家解決這個難題,下面小編將為大家詳細講解,有這方面需求的人可以來學習下,希望你能有所收獲。

一. 需求分析

為另一個項目提供可嵌入的功能單頁,大部分頁面使用時都是獨立功能頁,個別頁面帶有左側(cè)邊欄(相當于3-4個頁面的整合形態(tài)),由于資源定位地址的限定,每個頁面打包為單頁后,入口html文件需要定制命名,且腳本和樣式文件需要放在指定的路徑下,公共資源地址也必須替換成特殊字符以適配母系統(tǒng)的調(diào)用邏輯(比如下面結(jié)構(gòu)中應用jquery.min.js的路徑可能是{{publicRoot}}/{{publicLib}}/jquery.minjs)。假設原工程中擁有AB這2個舊頁面,現(xiàn)在需要開發(fā)CDE這3個頁面,目錄結(jié)構(gòu)要求如下:

怎么在Vue+ElementUI項目中使用webpack輸出MPA

藍色部分為舊資源,綠色部分為新開發(fā)需求。

二. 原方案分析

原方案采用Vue+ElementUI進行開發(fā),構(gòu)建過程基本是零配置的,開發(fā)效率非常高,頁面風格也統(tǒng)一,但零配置的構(gòu)建過程只能生成SPA模式的應用,所以原方案的做法是:

將構(gòu)建過程中需要定制的量提取到config.js文件中進行統(tǒng)一管理,大致形式如下:

//config.js
module.exports = {
  A:{
    publicPath:'{{publicRoot}}/{{publicLib}}'
    prodFileName:'A.html',
    entryKey:'public/A',
    entryPath:'public/A/A.js'
  },
  B:{
    //...
  }
  //...
}

開發(fā)過程中使用統(tǒng)一的路由文件router.js,打包過程中在main.js中引用對應頁面的XX.router.spa.js作為路由,而將其他頁面注釋掉,打包時傳入命令行參數(shù)--key=XXX,key值在打包腳本中被解析后從config.js中取出打包需要的設置參數(shù),然后將目標頁面打包為獨立頁面,其他頁面雖然也在工程中,但并不參與打包。

// 入口文件src/main.js
import router from './pages/C/router.spa';
//import router from './pages/D/router.spa';
//import router from './pages/E/router.spa';

上述打包過程在使用中出現(xiàn)了很多問題:

  • 公共依賴沒有剝離,vueElementUI會被打包進每一個單頁面,使得每個打包出的index.js幾乎有1.2MB大小,這種空間浪費是沒必要的。

  • 公共樣式?jīng)]有形成獨立文件,這使得每當有樣式細節(jié)發(fā)生變更,就需要手動將每個頁面逐一進行重新出包。

  • 頁面增多后在main.js中會有很多獨立路由,如果開發(fā)中進行了跨頁面修改,很可能在main.js中激活的路由為C頁面路由時,打包時--key參數(shù)的值卻傳成了D,這種情況并不會引起報錯,但事實上構(gòu)建結(jié)果確實錯誤的。

  • 由于入口文件保持main.js沒有變化,所以在不同頁面打包時,結(jié)果都輸出在dist目錄下,需要手動與母工程中的地址去匹配,操作繁瑣。

三. 多頁面改造3步走

上面的問題實際上都是因為原方案將一個多頁面開發(fā)需求按照單頁面應用來實現(xiàn)而造成的,需要對自動化構(gòu)建工程進行一些定制。

1.分離webpack配置

本例中開發(fā)環(huán)境和最終打包的主要差異在于路由上,開發(fā)中由于可能需要進行跨頁面開發(fā),可以使用單入口和獨立路由,而進行生產(chǎn)環(huán)境構(gòu)建時則需要輸出多頁面應用,所以首先要做的就是將原本的webpack.config.js文件拆分為webpack.base.js,webpack.dev.js,webpack.prod.js三個文件,webpack.base.js為環(huán)境無差別的配置,然后依據(jù)構(gòu)建模式的不同,使用webpack-merge插件將環(huán)境相關的配置與基本配置進行合并:

/*webpack.base.js示例*/
const argv = require('yargs-parser')(process.argv.slice(2));
const env_short = argv.env.all ? 'all' : argv.p ? 'prod':'dev';
const webpackConfig = require(`./config/webpack.${env_short}`);//根據(jù)-p屬性加載webpack的dev配置或prod配置
const merge = require('webpack-merge');

//基本配置
const baseConfig = {
  //....
}

//輸出合并后的配置
module.exports = merge(baseConfig, webpackConfig);

webpack.dev.js保持原本的SPA開發(fā)的設置即可滿足需求。

2. 抽離外部引用

本例中較大的外部應用是vue和ElementUI,很多開發(fā)者一直使用自動化腳手架工具,并沒有意識到這兩個庫作為外部依賴該如何引入工程。公共庫的抽離需要在webpack配置中將其填寫在external配置項中:

module.exports = {
 //...
 externals:{
   vue:'Vue',
   'element-ui':'ELEMENT'
 },
 //...
}

key為引用的模塊名,value為這個模塊引入后對應的全局命名,external配置項的含義是:請不要將這個模塊注入編譯后的JS文件里,對于源代碼里出現(xiàn)的任何import/require這個模塊的語句,請將它保留并根據(jù)模塊化標準進行依賴方式適配 。

Tips:

Vue做為外部依賴時有很多構(gòu)建包,本例中因為使用webpack進行了構(gòu)建,沒有在線編譯模板的需求,所以不需要引入完整的Vue,而只需要引入壓縮后的只包含運行時的版本vue.runtime.min.js即可。外部引入庫時需要注意命名,比如上例中的ELEMENT,開發(fā)者通常會填寫為自己在代碼中使用的ElementUI而引起報錯,當不確定名稱時,有個簡單的辦法就是找一個CDN的資源看一下,通常代碼最開始都是UMD規(guī)范的固定結(jié)構(gòu),很容易看到關鍵詞(如下圖所示)。

怎么在Vue+ElementUI項目中使用webpack輸出MPA

然后將資源的CDN地址或是本地公共庫地址加入到index.html中,你可以使用模板語法,然后從html-webpack-plugin插件實例化時傳入定制參數(shù):

<!--html文件模板-->
<body>
 <div id="app"></div>
 <script src="<%= htmlWebpackPlugin.options.vue_path %>"></script>
 <script src="<%= htmlWebpackPlugin.options.elementUI_path %>"></script>
 <script src="<%= htmlWebpackPlugin.options.tpl_entryPath %>/index.js"></script>
</body>
//webpack.prod.js
module.exports = {
  //...
 plugins: [
  new HtmlWebpackPlugin({
   template: 'src/index.html',//生成index.html時依據(jù)的模板
   filename: '.....',
   inject:false,
   tpl_entryPath:'....',
   vue_path:'.....',
   elementUI_path:'.....',
  }),
  //new BundleAnalyzerPlugin()
 ],
}

最終打包后生成的index.html文件大致如下:

<body>
 <div id="app"></div>
 <script src="{{publicRoot}}/{{publicLib}}/vue.min.js"></script>
 <script src="{{publicRoot}}/{{publicLib}}/element-ui.js"></script>
 <script src="public/A/A.js"></script>
</body>

如果第三方庫從本地加載,則需要將/node_modules/element-ui/lib/index.js和/node_modules/vue/dist/vue.runtime.min.js兩個依賴文件拷貝到lib文件夾中的對應地址,這樣訪問index.html時就可以以外部依賴的形式將其加載進來。樣式文件的剝離直接使用插件完成即可,webpack4以前的版本使用extract-text-webpack-plugin,從4.0版本后統(tǒng)一使用mini-css-extract-plugin。

3. 為webpack定制多入口

多入口的配置是多頁面應用打包的關鍵,由于打包結(jié)果存在嵌套目錄,所以需要對entry對象的鍵值進行一些定制,打包后的路徑信息是直接通過key值來定制的,同時需要實例化多個HtmlWebpackPlugin來為每一個入口文件生成一個對應的index.html訪問入口,定制參數(shù)可以在實例化時傳入:

//webpack.prod.js
module.exports = {
  entry:{
    'C/index':'./src/pages/C/C.entry.js',
    'DESK/D/index':'./src/pages/D/D.entry.js',
    'DESK/E/index':'./src/pages/E/E.entry.js'
  }
  //...
  plugins:[
    new HtmlWebpackPlugin({...paramsC}),
    new HtmlWebpackPlugin({...paramsD}),
    new HtmlWebpackPlugin({...paramsE}),
  ]
}

當然你可以將entry或plugins數(shù)組的組裝過程剝離到其他文件中,然后直接引用:

怎么在Vue+ElementUI項目中使用webpack輸出MPA

當然,每個頁面的入口文件X.entry.js相當于舊方案中main.js文件中移除被注釋掉的未啟用路由信息后剩余的部分,它足以支撐每個單頁獨立被訪問。

看完上述內(nèi)容是否對您有幫助呢?如果還想對相關知識有進一步的了解或閱讀更多相關文章,請關注億速云行業(yè)資訊頻道,感謝您對億速云的支持。

向AI問一下細節(jié)

免責聲明:本站發(fā)布的內(nèi)容(圖片、視頻和文字)以原創(chuàng)、轉(zhuǎn)載和分享為主,文章觀點不代表本網(wǎng)站立場,如果涉及侵權請聯(lián)系站長郵箱:is@yisu.com進行舉報,并提供相關證據(jù),一經(jīng)查實,將立刻刪除涉嫌侵權內(nèi)容。

AI