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