構(gòu)建Vue大型應(yīng)用的10個最佳實(shí)踐(小結(jié))
這些是我構(gòu)建大型Vue項(xiàng)目得出的最佳實(shí)踐,這些技巧將幫助你更高效的編碼,并且使其更容易維護(hù)和協(xié)作。
在我今年的自由職業(yè)生涯中我有幸開發(fā)了一些大型Vue程序。我所說的這些項(xiàng)目使用了大量Vuex stores 😰 ,很多Vue組件(有數(shù)百個)和很多視圖(pages)😄。對我而言這是非常有意義的經(jīng)歷,我發(fā)現(xiàn)了很多使擴(kuò)展的方法。同時我還需要修復(fù)一些亂七八糟的錯誤用法。🍝
所以我將分享我的10個最佳實(shí)踐,如果你有大型項(xiàng)目需要開發(fā)推薦你使用他們。
1. 使用Slots可以使你的組件更強(qiáng)大和便于理解。
最近我寫了一篇文章some important things you need to know regarding slots in Vue.js。 主要講了為什么使用Slots可以提高組件復(fù)用且易于維護(hù)。
但是這和大型Vue項(xiàng)目有啥關(guān)系呢。我將描繪一個使用他們解決你痛點(diǎn)的藍(lán)圖。
假如我要開發(fā)一個popup。起初看起來沒有什么難點(diǎn),僅僅是包括標(biāo)題,描述和一些按鈕。 所以把所有東西都當(dāng)作props不就完了嗎。 我用了三個自定義props,并且click按鈕的時候觸發(fā)一個事件。 就是這么簡單! 😅
隨著項(xiàng)目的不斷發(fā)展,業(yè)務(wù)需要顯示許多其他新內(nèi)容:表單字段,不同的按鈕(取決于顯示在哪個頁面上)、卡片、頁腳和列表。通過添加更多的props可以解決這個問題。😩但是隨著業(yè)務(wù)發(fā)展,組件變的太復(fù)雜了。因?yàn)樗撕芏嘧咏M件,需要觸發(fā)很多個事件。🌋我遇到了坑爹的問題,修改了一個功能后影響了其他page上的功能。我創(chuàng)造了一個怪物而不是一個可維護(hù)的組件!
但是,一開始使用slots可能會更好。最終我使小組件來重構(gòu)這個組件。使他更容易維護(hù)、好理解、好擴(kuò)展。
<template> <div class="c-base-popup"> <div v-if="$slot.header" class="c-base-popup__header"> <slot name="header"> </div> <div v-if="$slot.subheader" class="c-base-popup__subheader"> <slot name="subheader"> </div> <div class="c-base-popup__body"> <h1>{{ title }}</h1> <p v-if="description">{{ description }}</p> </div> <div v-if="$slot.actions" class="c-base-popup__actions"> <slot name="actions"> </div> <div v-if="$slot.footer" class="c-base-popup__footer"> <slot name="footer"> </div> </div> </template> <script> export default { props: { description: { type: String, default: null }, title: { type: String, required: true } } } </script>
根據(jù)經(jīng)驗(yàn)在我看來,由熟練使用slots的開發(fā)人員構(gòu)建項(xiàng)目對將來項(xiàng)目的可維護(hù)性有更重要的意義。
⚠️ 經(jīng)驗(yàn)規(guī)則,當(dāng)子組件中使用了父組件的props時,應(yīng)該使用slots。
2.好好組織的你Vuex store
通常,一個新的Vue開發(fā)人員學(xué)習(xí)Vuex是因?yàn)閮蓚€問題:
- 當(dāng)一個組件需要重一個比較遠(yuǎn)的組件(嵌套層級或者兄弟組件:譯者注)訪問數(shù)據(jù)時。
- 需要持有一個銷毀組件的數(shù)據(jù)時。
這樣他創(chuàng)建第一個Vuex store,學(xué)習(xí)moudles的用法并且組織程序時。💡
問題是創(chuàng)建modules時沒有單一模式可循。我強(qiáng)烈建議一定要想清楚如何組織他們。據(jù)我所知,很多人更喜歡按照功能來組織他們(我也是:譯者注)。例如:
- Auth.
- Blog.
- Inbox.
- Settings.
就我來說,用從API獲得的數(shù)據(jù)模型組織更容易理解。例子:
- Users
- Teams
- Messages
- Widgets
- Articles
用那個取決于自己,但是從長遠(yuǎn)來看組織良好的Vuex store更具生產(chǎn)力。這樣也容易是新人融入并且繼承你的初衷。
3.用Actions調(diào)用api和提交數(shù)據(jù)。
我的大部分(不是全部)API調(diào)用都在Vuex的actions中,你一定想知道為什么這樣做。🤨
簡單的說是因?yàn)槔?shù)據(jù)時需要在store中commit。還有就是他提供了我喜歡的封裝和復(fù)用。其他原因就是:
- 如果我在兩個地方(blog和home page)獲取第一個頁面的數(shù)據(jù)。我只需使用不同的參數(shù)調(diào)用即可得到數(shù)據(jù),初次之外沒有重復(fù)的代碼被調(diào)用。
- 如果需要創(chuàng)建一些邏輯來避免重復(fù)拉取數(shù)據(jù),只需要在一個地方拉取一次。除了給服務(wù)器減負(fù)以外,我還可以在任何地方使用這些數(shù)據(jù)。
- 我可以在actions中最終Mixpanel事件,基于維護(hù)性使問題變的容易分析。我的代碼中大部分action中只有一個Mixpanel調(diào)用,😂我不必關(guān)注數(shù)據(jù)和發(fā)送這種工作方式太爽了。
4.使用mapState、mapGetters、mapMutations和mapAction精簡代碼。
當(dāng)你在組件中訪問state/getters或者調(diào)用actions/mutations時通常需要創(chuàng)建多個計(jì)算屬性。使用mapState,mapGetters,mapMutations和mapActions可以將來自store modules中的數(shù)據(jù)集中在一個地方,這樣可以精簡代碼并且更好理解。
// NPM import { mapState, mapGetters, mapActions, mapMutations } from "vuex"; export default { computed: { // Accessing root properties ...mapState("my_module", ["property"]), // Accessing getters ...mapGetters("my_module", ["property"]), // Accessing non-root properties ...mapState("my_module", { property: state => state.object.nested.property }) }, methods: { // Accessing actions ...mapActions("my_module", ["myAction"]), // Accessing mutations ...mapMutations("my_module", ["myMutation"]) } };
你想要的這里都有Vuex官方文檔。
5. 快使用API Factories
我通常會創(chuàng)建this.$api助手,可以在任何地方訪問我的API入口。我的項(xiàng)目根目錄有一個api文件夾有我的所有類(如下)。
api ├── auth.js ├── notifications.js └── teams.js
每一個都是一類接口的分組,這是我在Nuxt應(yīng)用中使用插件的方式初始化。(和標(biāo)準(zhǔn)Vue應(yīng)用程序中的過程非常相似)。
// PROJECT: API import Auth from "@/api/auth"; import Teams from "@/api/teams"; import Notifications from "@/api/notifications"; export default (context, inject) => { if (process.client) { const token = localStorage.getItem("token"); // Set token when defined if (token) { context.$axios.setToken(token, "Bearer"); } } // Initialize API repositories const repositories = { auth: Auth(context.$axios), teams: Teams(context.$axios), notifications: Notifications(context.$axios) }; inject("api", repositories); };
export default $axios => ({ forgotPassword(email) { return $axios.$post("/auth/password/forgot", { email }); }, login(email, password) { return $axios.$post("/auth/login", { email, password }); }, logout() { return $axios.$get("/auth/logout"); }, register(payload) { return $axios.$post("/auth/register", payload); } });
這樣我可以方便的在組件或Vuex操作中調(diào)用他們,如下:
export default { methods: { onSubmit() { try { this.$api.auth.login(this.email, this.password); } catch (error) { console.error(error); } } } };
6. 使用$config訪問環(huán)境變量(模板中特別有用)。
項(xiàng)目中定義了一些全局配置變量:
config ├── development.json └── production.json
我通常使用this.$config獲取,尤其是當(dāng)我在模板中時。 一如既往擴(kuò)展Vue對象非常容易:
// NPM import Vue from "vue"; // PROJECT: COMMONS import development from "@/config/development.json"; import production from "@/config/production.json"; if (process.env.NODE_ENV === "production") { Vue.prototype.$config = Object.freeze(production); } else { Vue.prototype.$config = Object.freeze(development); }
7.遵守一個commit命名規(guī)則。
在項(xiàng)目發(fā)展的過程中,經(jīng)常需要關(guān)注組件的變更歷史。如果團(tuán)隊(duì)中有人沒有遵守commit慣例,那么將很難理解他們所做的事情。
我總是使用并推薦Angular commit message guidelines。我所有的項(xiàng)目中都會使用他,通常團(tuán)隊(duì)中的其他人也會發(fā)現(xiàn)他的好處。
遵守這些規(guī)則使commit更加可讀,在查看項(xiàng)目歷史時使得commit更加容易追蹤。簡言之,他是這樣用的:
git commit -am "<type>(<scope>): <subject>" # Here are some samples git commit -am "docs(changelog): update changelog to beta.5" git commit -am "fix(release): need to depend on latest rxjs and zone.js"
看他們的README file更新更多。
8.始終在生產(chǎn)環(huán)境中凍結(jié)Package的版本。
我知道...所有軟件包都應(yīng)遵循 the semantic versioning rules.。但實(shí)際情況并非如此。😅
為了避免一個依賴影響了整個項(xiàng)目在半夜被拖起來,凍結(jié)所有程序包的版本可以使你一覺睡到天明并且工作愉快。 😇
這很簡單:避免以^開頭的版本:
{ "name": "my project", "version": "1.0.0", "private": true, "dependencies": { "axios": "0.19.0", "imagemin-mozjpeg": "8.0.0", "imagemin-pngquant": "8.0.0", "imagemin-svgo": "7.0.0", "nuxt": "2.8.1", }, "devDependencies": { "autoprefixer": "9.6.1", "babel-eslint": "10.0.2", "eslint": "6.1.0", "eslint-friendly-formatter": "4.0.1", "eslint-loader": "2.2.1", "eslint-plugin-vue": "5.2.3" } }
9. 顯示一個大的數(shù)據(jù)時應(yīng)該使用Vue虛擬滾動條。
在頁面中顯示多行或需要循環(huán)大量數(shù)據(jù)時,你已經(jīng)注意到該頁面渲染速度很快變慢。 要解決此問題,您可以使用vue-virtual-scoller。
npm install vue-virtual-scroller
他只渲染列表中的可見項(xiàng)并且復(fù)用組件和dom元素,以使其盡可能高效。 如此簡單就像一個魔法! ✨
<template> <RecycleScroller class="scroller" :items="list" :item-size="32" key-field="id" v-slot="{ item }" > <div class="user"> {{ item.name }} </div> </RecycleScroller> </template>
10.追蹤第三方程序包的大小
多人合作一個項(xiàng)目時,如果沒人關(guān)注安裝的依賴包數(shù)量很快變的難以置信。為了避免程序變慢(尤其是在移動網(wǎng)絡(luò)環(huán)境),我這VSC中使用import cost package這樣就可以編輯器中看到導(dǎo)入的包有多大,并且找出大的原因。
例如在最近的項(xiàng)目中,導(dǎo)入了整個lodash庫(壓縮后24kB)。 有啥子問題? 僅僅使用cloneDeep方法。 通過import cost package找到了問題,我們通過以下方式解決了該問題:
npm remove lodash npm install lodash.clonedeep
在使用的地方導(dǎo)入:
import cloneDeep from "lodash.clonedeep";
為了進(jìn)一步優(yōu)化,我們還可以使用Webpack Bundle Analyzer包通過樹狀圖來可視化Webpack輸出文件的大小。
以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
Vue2.5通過json文件讀取數(shù)據(jù)的方法
本文通過實(shí)例代碼給大家詳細(xì)介紹了Vue2.5通過json文件讀取數(shù)據(jù)的方法,非常不錯,具有參考借鑒價值,需要的朋友參考下吧2018-02-02webpack 3 + Vue2 使用dotenv配置多環(huán)境的步驟
這篇文章主要介紹了webpack 3 + Vue2 使用dotenv配置多環(huán)境,env文件在配置文件都可以用, vue頁面用的時候需要在 webpack.base.conf.js 重新配置,需要的朋友可以參考下2023-11-11vue+iview如何實(shí)現(xiàn)拼音、首字母、漢字模糊搜索
這篇文章主要介紹了vue+iview如何實(shí)現(xiàn)拼音、首字母、漢字模糊搜索,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2022-04-04去除element-ui下拉框的下拉箭頭的實(shí)現(xiàn)
我們最開始拿到的element-ui是帶有下拉箭頭的,那么如何去除element-ui下拉框的下拉箭頭的實(shí)現(xiàn),本文就詳細(xì)的介紹一下,感興趣的可以了解一下2023-08-08關(guān)于console.log打印結(jié)果是?[object?Object]的解決
這篇文章主要介紹了關(guān)于console.log打印結(jié)果是?[object?Object]的解決方案,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2022-04-04vue踩坑記之npm?install報錯問題解決總結(jié)
當(dāng)你跑起一個項(xiàng)目的時候,第一步需要先安裝依賴npm install,下面這篇文章主要給大家介紹了關(guān)于vue踩坑之npm?install報錯問題解決的相關(guān)資料,需要的朋友可以參考下2022-06-06