公司使用 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.開發(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 // 這里模板文件名稱需要與文件夾名稱相同,方便
使用變量維護(hù)多入口
我們?cè)陧?xiàng)目目錄下的 build/utils.js 的最后 exports 一個(gè)指定多入口的對(duì)象。如下:
// 這里,每個(gè)屬性就是一個(gè)頁(yè)面配置,指定該頁(yè)面的入口文件 // 如果需要添加,只需多增加一個(gè)屬性 // 屬性名必和html模板文件名、目錄名稱相同 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)入。
開發(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, // 使用屬性名讀取模板文件 // 這就是上面“模板文件名稱需要與文件夾名稱相同”的原因 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)入口名稱,如果你的默認(rèn)入口不是'app' // 則這里需要替換 chunks: ['manifest', 'vendor', 'app'] }) ... ] ... // 在`devWebpackConfig`定義之后,緊接著添加多頁(yè)面
最后,添加多頁(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)簽 -->
到這里,開發(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' })) }
然后,開發(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ù)大家的!
聲明:本網(wǎng)頁(yè)內(nèi)容旨在傳播知識(shí),若有侵權(quán)等問(wèn)題請(qǐng)及時(shí)與本網(wǎng)聯(lián)系,我們將在第一時(shí)間刪除處理。TEL:177 7030 7066 E-MAIL:11247931@qq.com