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-08
vue 函數(shù)調(diào)用加括號與不加括號的區(qū)別
這篇文章主要介紹了vue 函數(shù)調(diào)用加括號與不加括號的區(qū)別,幫助大家更好的理解和使用vue,感興趣的朋友可以了解下2020-10-10
vue element 生成無線級左側(cè)菜單的實現(xiàn)代碼
這篇文章主要介紹了vue element 生成無線級左側(cè)菜單的實現(xiàn)代碼,代碼簡單易懂,非常不錯,具有一定的參考借鑒價值,需要的朋友可以參考下2019-08-08
vue數(shù)據(jù)初始化initState的實例詳解
Vue 實例在建立的時候會運行一系列的初始化操作,而在這些初始化操作里面,和數(shù)據(jù)綁定關(guān)聯(lián)最大的是 initState。這篇文章主要介紹了vue數(shù)據(jù)初始化--initState,需要的朋友可以參考下2019-04-04

