vue項(xiàng)目添加多頁(yè)面配置的步驟詳解
公司使用 vue-cli 創(chuàng)建的 vue項(xiàng)目 在初始化時(shí)并沒(méi)有做多頁(yè)面配置,隨著需求的不斷增加,發(fā)現(xiàn)有必要使用多頁(yè)面配置??戳撕芏?vue多頁(yè)面配置 的文章,基本都是在初始化時(shí)就配置了多頁(yè)面。而且如果使用這些實(shí)現(xiàn),需要調(diào)整當(dāng)前項(xiàng)目的目錄結(jié)構(gòu),這點(diǎn)也是不能接受的。
最后,參考這些文章,在不調(diào)整當(dāng)前項(xiàng)目目錄結(jié)構(gòu)實(shí)現(xiàn)了多頁(yè)面的配置的添加。這里做下記錄、總結(jié),方便以后復(fù)用。如果還能有幸?guī)椭接型瑯有枨蟮耐脑?,那就更好了?/p>
實(shí)現(xiàn)步驟
1.添加新增入口相關(guān)文件;
2.使用變量維護(hù)多入口;
3.開(kāi)發(fā)環(huán)境讀取多入口配置;
4.生產(chǎn)環(huán)境讀取多入口配置;
新增入口相關(guān)文件
在 src 目錄下新增一個(gè) page1 文件夾,新建新頁(yè)面的所需的相關(guān)文件(入口文件、HTML模板文件等)。我這邊直接 vue-cli 初始化創(chuàng)建相關(guān)文件復(fù)制了一份到 page1 文件夾下。如下:
├─App.vue ├─main.js ├─page1.html // 這里模板文件名稱(chēng)需要與文件夾名稱(chēng)相同,方便輸出模板讀取 ├─router | └index.js ├─components | └HelloWorld.vue ├─assets | └logo.png page1/router/index.js 需要對(duì)該頁(yè)面的所有路由添加同文件夾名的公共路徑,用于解析: import Vue from 'vue' import Router from 'vue-router' import HelloWorld from '@/page1/components/HelloWorld' // 這里也需要留意 Vue.use(Router) export default new Router({ mode: 'history', base: '/', routes: [ { path: '/page1/', redirect: '/page1/index' }, { path: '/page1/index', name: 'HelloWorld', component: HelloWorld } ] })
使用變量維護(hù)多入口
我們?cè)陧?xiàng)目目錄下的 build/utils.js 的最后 exports 一個(gè)指定多入口的對(duì)象。如下:
// 這里,每個(gè)屬性就是一個(gè)頁(yè)面配置,指定該頁(yè)面的入口文件 // 如果需要添加,只需多增加一個(gè)屬性 // 屬性名必和html模板文件名、目錄名稱(chēng)相同 exports.multipleEntrys = { page1: './src/page1/main.js' }
之所以使用 build/utils.js ,是因?yàn)樵撐募?webpack.base.conf.js
、 webpack.prod.conf.js 、 webpack.dev.conf.js 都用導(dǎo)入。
開(kāi)發(fā)環(huán)境讀取多入口配置
首先,在 build/webpack.base.conf.js
中,我們把上面定義的入口添加進(jìn) entry 配置:
entry: { app: './src/main.js', ...utils.multipleEntrys // entry添加該行 }
然后,在 build/webpack.dev.conf.js
添加路徑解析和多頁(yè)面輸出:
// 添加解析,將historyApiFallback的屬性修改如下: historyApiFallback: { rewrites: [ // 將所有多入口遍歷成路徑解析項(xiàng) ...((()=>{ let writes = [] for(let prop in utils.multipleEntrys){ // 使用屬性名匹配為正則 // 這就是上面“需要對(duì)該頁(yè)面的所有路由添加同文件夾名的公共路徑”的原因 let reg = new RegExp(`^/${prop}/`) writes.push({ from: reg, // 使用屬性名讀取模板文件 // 這就是上面“模板文件名稱(chēng)需要與文件夾名稱(chēng)相同”的原因 to: path.posix.join(config.dev.assetsPublicPath, `${prop}.html`) }) } return writes })()), // 匹配所有路徑一定要在最后,否則該匹配之后的項(xiàng),不會(huì)被執(zhí)行 { from: /.*/, to: path.posix.join(config.dev.assetsPublicPath, 'index.html') } ], } // 在已經(jīng)的HtmlWebpackPlugin中添加chunks配置,否則默認(rèn)頁(yè)面會(huì)注入所有頁(yè)面的js文件 ... plugins: [ ... new HtmlWebpackPlugin({ filename: 'index.html', template: 'index.html', inject: true, // 增加此行, // 'app'為默認(rèn)入口名稱(chēng),如果你的默認(rèn)入口不是'app' // 則這里需要替換 chunks: ['manifest', 'vendor', 'app'] }) ... ] ... // 在`devWebpackConfig`定義之后,緊接著添加多頁(yè)面輸出: for(let prop in utils.multipleEntrys){ devWebpackConfig.plugins.push(new HtmlWebpackPlugin({ filename: `${prop}.html`, // html模板路徑,使用屬性名作為文件夾名稱(chēng) // 這是新頁(yè)面文件夾名稱(chēng)需要和多入口配置變量屬性名相同的原因 template: `./src/${prop}/${prop}.html`, inject: true, chunks: ['manifest', 'vendor', prop], })) }
最后,添加多頁(yè)面相互跳轉(zhuǎn)鏈接:
<!-- src/components/HelloWorld.vue --> ... <a href="/page1/index" rel="external nofollow" >to page B</a> ... <!-- src/page1/components/HelloWorld.vue --> ... <a href="/" rel="external nofollow" >to page A</a> ... <!-- 這里由于是多個(gè)頁(yè)面的跳轉(zhuǎn),所以不能再使用router-link標(biāo)簽,需要使用a標(biāo)簽 -->
到這里,開(kāi)發(fā)環(huán)境的多頁(yè)面配置已經(jīng)完成,重新 npm run dev
一下,即可多頁(yè)面跳轉(zhuǎn)。
生產(chǎn)環(huán)境讀取多入口配置
首先,在 webapck.prod.config.js
中添加多頁(yè)面輸出。
// 在已經(jīng)的HtmlWebpackPlugin中添加chunks配置,否則默認(rèn)頁(yè)面會(huì)注入所有頁(yè)面的js文件 ... plugins: [ ... new HtmlWebpackPlugin({ ... chunks: ['manifest', 'vendor', 'app'] // 增加此行 ... }) ... ] ... // build/webapck.prod.config.js的webpackConfig定義后緊接著添加 for(let prop in utils.multipleEntrys){ webpackConfig.plugins.push(new HtmlWebpackPlugin({ filename: `${prop}.html`, template: `./src/${prop}/${prop}.html`, inject: true, chunks: ['manifest', 'vendor', prop], minify: { removeComments: true, collapseWhitespace: true, removeAttributeQuotes: true }, chunksSortMode: 'dependency' })) }
然后,開(kāi)發(fā)環(huán)境不同路徑指向不同輸出文件是由 historyApiFallback
來(lái)處理的,生產(chǎn)就需要在 web服務(wù) 中將不同路徑指向打包后的不同文件。這里以 nginx 為例,配置如下:
server { listen 92 default_server; listen [::]:92 default_server; server_name _; root D:\vue-multi-entry\dist; location / { try_files $uri $uri/ /index.html; } location /page1/ { try_files $uri $uri/ /page1.html; } }
以上,整個(gè)多頁(yè)面的配置就已經(jīng)完成。這里是 完整demo
關(guān)于webpack4.x版本的差異
如果你使用的是 webpack4.x 版本,關(guān)于 webapck.prod.config.js
中 chunks 配置的順序就是這樣的: [prop, 'manifest', 'vendor']
。
總結(jié)
以上所述是小編給大家介紹的vue項(xiàng)目添加多頁(yè)面配置的步驟詳解,希望對(duì)大家有所幫助,如果大家有任何疑問(wèn)歡迎給我留言,小編會(huì)及時(shí)回復(fù)大家的!
相關(guān)文章
vue搭建本地JSON靜態(tài)數(shù)據(jù)服務(wù)器全過(guò)程
這篇文章主要介紹了vue搭建本地JSON靜態(tài)數(shù)據(jù)服務(wù)器全過(guò)程,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2024-07-07Vue3狀態(tài)管理之Pinia的入門(mén)使用教程
Pinia是Vue.js的輕量級(jí)狀態(tài)管理庫(kù),比起vue3中的Vuex狀態(tài)管理,pinia更輕量,更容易使用,下面這篇文章主要給大家介紹了關(guān)于Vue3狀態(tài)管理之Pinia的入門(mén)使用教程,需要的朋友可以參考下2022-04-04解決element ui el-row el-col里面高度不一致問(wèn)題
這篇文章主要介紹了解決element ui el-row el-col里面高度不一致問(wèn)題,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2024-08-08vue 函數(shù)調(diào)用加括號(hào)與不加括號(hào)的區(qū)別
這篇文章主要介紹了vue 函數(shù)調(diào)用加括號(hào)與不加括號(hào)的區(qū)別,幫助大家更好的理解和使用vue,感興趣的朋友可以了解下2020-10-10vue element 生成無(wú)線級(jí)左側(cè)菜單的實(shí)現(xiàn)代碼
這篇文章主要介紹了vue element 生成無(wú)線級(jí)左側(cè)菜單的實(shí)現(xiàn)代碼,代碼簡(jiǎn)單易懂,非常不錯(cuò),具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2019-08-08vue數(shù)據(jù)初始化initState的實(shí)例詳解
Vue 實(shí)例在建立的時(shí)候會(huì)運(yùn)行一系列的初始化操作,而在這些初始化操作里面,和數(shù)據(jù)綁定關(guān)聯(lián)最大的是 initState。這篇文章主要介紹了vue數(shù)據(jù)初始化--initState,需要的朋友可以參考下2019-04-04