摘要:不多廢話,先說結論小程序組件寫法這里就不再介紹。在官方文檔中,我們可以看到使用構造器構造頁面事實上,小程序的頁面也可以視為自定義組件。經過一番測試,得出結果為為了簡便。畢竟官方標準,不用擔心其他一系列后續問題。
在開發小程序的時候,我們總是期望用以往的技術規范和語法特點來書寫當前的小程序,所以才會有各色的小程序框架,例如 mpvue、taro 等這些編譯型框架。當然這些框架本身對于新開發的項目是有所幫助。而對于老項目,我們又想要利用 vue 的語法特性進行維護,又該如何呢?
在此我研究了一下youzan的 vant-weapp。而發現該項目中的組件是如此編寫的。
import { VantComponent } from "../common/component"; VantComponent({ mixins: [], props: { name: String, size: String }, // 可以使用 watch 來監控 props 變化 // 其實就是把properties中的observer提取出來 watch: { name(newVal) { ... }, // 可以直接使用字符串 代替函數調用 size: "changeSize" }, // 使用計算屬性 來 獲取數據,可以在 wxml直接使用 computed: { bigSize() { return this.data.size + 100 } }, data: { size: 0 }, methods: { onClick() { this.$emit("click"); }, changeSize(size) { // 使用set this.set(size) } }, // 對應小程序組件 created 周期 beforeCreate() {}, // 對應小程序組件 attached 周期 created() {}, // 對應小程序組件 ready 周期 mounted() {}, // 對應小程序組件 detached 周期 destroyed: {} });
居然發現該組件寫法整體上類似于 Vue 語法。而本身卻沒有任何編譯。看來問題是出在了導入的 VantComponet 這個方法上。下面我們開始詳細介紹一下如何利用 VantComponet 來對老項目進行維護。
TLDR (不多廢話,先說結論)小程序組件寫法這里就不再介紹。這里我們給出利用 VantComponent 寫 Page 的代碼風格。
import { VantComponent } from "../common/component"; VantComponent({ mixins: [], props: { a: String, b: Number }, // 在頁面這里 watch 基本上是沒有作用了,因為只做了props 變化的watch,page不會出現 props 變化 // 后面會詳細說明為何 watch: {}, // 計算屬性仍舊可用 computed: { d() { return c++ } }, methods: { onLoad() {} }, created() {}, // 其他組件生命周期 })
這里你可能感到疑惑,VantComponet 不是對組件 Component 生效的嗎?怎么會對頁面 Page 生效呢。事實上,我們是可以使用組件來構造小程序頁面的。
在官方文檔中,我們可以看到 使用 Component 構造器構造頁面
事實上,小程序的頁面也可以視為自定義組件。因而,頁面也可以使用 Component 構造器構造,擁有與普通組件一樣的定義段與實例方法。代碼編寫如下:
Component({ // 可以使用組件的 behaviors 機制,雖然 React 覺得 mixins 并不是一個很好的方案 // 但是在某種程度該方案的確可以復用相同的邏輯代碼 behaviors: [myBehavior], // 對應于page的options,與此本身是有類型的,而從options 取得數據均為 string類型 // 訪問 頁面 /pages/index/index?paramA=123¶mB=xyz // 如果聲明有屬性 paramA 或 paramB ,則它們會被賦值為 123 或 xyz,而不是 string類型 properties: { paramA: Number, paramB: String, }, methods: { // onLoad 不需要 option // 但是頁面級別的生命周期卻只能寫道 methods中來 onLoad() { this.data.paramA // 頁面參數 paramA 的值 123 this.data.paramB // 頁面參數 paramB 的值 ’xyz’ } } })
那么組件的生命周期和頁面的生命周期又是怎么對應的呢。經過一番測試,得出結果為: (為了簡便。只會列出 重要的的生命周期)
// 組件實例被創建 到 組件實例進入頁面節點樹 component created -> component attched -> // 頁面頁面加載 到 組件在視圖層布局完成 page onLoad -> component ready -> // 頁面卸載 到 組件實例被從頁面節點樹移除 page OnUnload -> component detached
當然 我們重點不是在 onload 和 onunload 中間的狀態,因為中間狀態的時候,我們可以在頁面中使用頁面生命周期來操作更好。
某些時候我們的一些初始化代碼不應該放在 onload 里面,我們可以考慮放在 component create 進行操作,甚至可以利用 behaviors 來復用初始化代碼。
某種方面來說,如果不需要 Vue 風格,我們在老項目中直接利用 Component 代替 Page 也不失為一個不錯的維護方案。畢竟官方標準,不用擔心其他一系列后續問題。
此時,我們對 VantComponent 開始進行解析
// 賦值,根據 map 的 key 和 value 來進行操作 function mapKeys(source: object, target: object, map: object) { Object.keys(map).forEach(key => { if (source[key]) { // 目標對象 的 map[key] 對應 源數據對象的 key target[map[key]] = source[key]; } }); } // ts代碼,也就是 泛型 function VantComponent( vantOptions: VantComponentOptions< Data, Props, Watch, Methods, Computed, CombinedComponentInstance > = {} ): void { const options: any = {}; // 用function 來拷貝 新的數據,也就是我們可以用的 Vue 風格 mapKeys(vantOptions, options, { data: "data", props: "properties", mixins: "behaviors", methods: "methods", beforeCreate: "created", created: "attached", mounted: "ready", relations: "relations", destroyed: "detached", classes: "externalClasses" }); // 對組件間關系進行編輯,但是page不需要,可以刪除 const { relation } = vantOptions; if (relation) { options.relations = Object.assign(options.relations || {}, { [`../${relation.name}/index`]: relation }); } // 對組件默認添加 externalClasses,但是page不需要,可以刪除 // add default externalClasses options.externalClasses = options.externalClasses || []; options.externalClasses.push("custom-class"); // 對組件默認添加 basic,封裝了 $emit 和小程序節點查詢方法,可以刪除 // add default behaviors options.behaviors = options.behaviors || []; options.behaviors.push(basic); // map field to form-field behavior // 默認添加 內置 behavior wx://form-field // 它使得這個自定義組件有類似于表單控件的行為。 // 可以研究下文給出的 內置behaviors if (vantOptions.field) { options.behaviors.push("wx://form-field"); } // add default options // 添加組件默認配置,多slot options.options = { multipleSlots: true,// 在組件定義時的選項中啟用多slot支持 // 如果這個 Component 構造器用于構造頁面 ,則默認值為 shared // 組件的apply-shared,可以研究下文給出的 組件樣式隔離 addGlobalClass: true }; // 監控 vantOptions observe(vantOptions, options); // 把當前重新配置的options 放入Component Component(options); }
內置behaviors
組件樣式隔離
剛剛我們談到 basic behaviors,代碼如下所示
export const basic = Behavior({ methods: { // 調用 $emit組件 實際上是使用了 triggerEvent $emit() { this.triggerEvent.apply(this, arguments); }, // 封裝 程序節點查詢 getRect(selector: string, all: boolean) { return new Promise(resolve => { wx.createSelectorQuery() .in(this)[all ? "selectAll" : "select"](selector) .boundingClientRect(rect => { if (all && Array.isArray(rect) && rect.length) { resolve(rect); } if (!all && rect) { resolve(rect); } }) .exec(); }); } } });observe
小程序 watch 和 computed的 代碼解析
export function observe(vantOptions, options) { // 從傳入的 option中得到 watch computed const { watch, computed } = vantOptions; // 添加 behavior options.behaviors.push(behavior); /// 如果有 watch 對象 if (watch) { const props = options.properties || {}; // 例如: // props: { // a: String // }, // watch: { // a(val) { // // 每次val變化時候打印 // consol.log(val) // } } Object.keys(watch).forEach(key => { // watch只會對prop中的數據進行 監視 if (key in props) { let prop = props[key]; if (prop === null || !("type" in prop)) { prop = { type: prop }; } // prop的observer被watch賦值,也就是小程序組件本身的功能。 prop.observer = watch[key]; // 把當前的key 放入prop props[key] = prop; } }); // 經過此方法 // props: { // a: { // type: String, // observer: (val) { // console.log(val) // } // } // } options.properties = props; } // 對計算屬性進行封裝 if (computed) { options.methods = options.methods || {}; options.methods.$options = () => vantOptions; if (options.properties) { // 監視props,如果props發生改變,計算屬性本身也要變 observeProps(options.properties); } } }observeProps
現在剩下的也就是 observeProps 以及 behavior 兩個文件了,這兩個都是為了計算屬性而生成的,這里我們先解釋 observeProps 代碼
export function observeProps(props) { if (!props) { return; } Object.keys(props).forEach(key => { let prop = props[key]; if (prop === null || !("type" in prop)) { prop = { type: prop }; } // 保存之前的 observer,也就是上一個代碼生成的prop let { observer } = prop; prop.observer = function() { if (observer) { if (typeof observer === "string") { observer = this[observer]; } // 調用之前保存的 observer observer.apply(this, arguments); } // 在發生改變的時候調用一次 set 來重置計算屬性 this.set(); }; // 把修改的props 賦值回去 props[key] = prop; }); }behavior
最終 behavior,也就算 computed 實現機制
// 異步調用 setData function setAsync(context: Weapp.Component, data: object) { return new Promise(resolve => { context.setData(data, resolve); }); }; export const behavior = Behavior({ created() { if (!this.$options) { return; } // 緩存 const cache = {}; const { computed } = this.$options(); const keys = Object.keys(computed); this.calcComputed = () => { // 需要更新的數據 const needUpdate = {}; keys.forEach(key => { const value = computed[key].call(this); // 緩存數據不等當前計算數值 if (cache[key] !== value) { cache[key] = needUpdate[key] = value; } }); // 返回需要的更新的 computed return needUpdate; }; }, attached() { // 在 attached 周期 調用一次,算出當前的computed數值 this.set(); }, methods: { // set data and set computed data // set可以使用callback 和 then set(data: object, callback: Function) { const stack = []; // set時候放入數據 if (data) { stack.push(setAsync(this, data)); } if (this.calcComputed) { // 有計算屬性,同樣也放入 stack中,但是每次set都會調用一次,props改變也會調用 stack.push(setAsync(this, this.calcComputed())); } return Promise.all(stack).then(res => { // 所有 data以及計算屬性都完成后調用callback if (callback && typeof callback === "function") { callback.call(this); } return res; }); } } });寫在后面
js 是一門靈活的語言(手動滑稽)
本身 小程序 Component 在 小程序 Page 之后,就要比Page 更加成熟好用,有時候新的方案往往藏在文檔之中,每次多看幾遍文檔絕不是沒有意義的。
小程序版本 版本2.6.1 Component 目前已經實現了 observers,可以監聽 props data 數據監聽器,目前 VantComponent沒有實現,當然本身而言,Page 不需要對 prop 進行監聽,因為進入頁面壓根不會變,而data變化本身就無需監聽,直接調用函數即可,所以對page而言,observers 可有可無。
該方案也只是對 js 代碼上有vue的風格,并沒在 template 以及 style 做其他文章。
該方案性能一定是有所缺失的,因為computed是每次set都會進行計算,而并非根據set 的 data 來進行操作,在刪減之后我認為本身是可以接受。如果本身對于vue的語法特性需求不高,可以直接利用 Component 來編寫 Page,選擇不同的解決方案實質上是需要權衡各種利弊。如果本身是有其他要求或者新的項目,仍舊推薦使用新技術,如果本身是已有項目并且需要維護的,同時又想擁有 Vue 特性。可以使用該方案,因為代碼本身較少,而且本身也可以基于自身需求修改。
同時,vant-weapp是一個非常不錯的項目,推薦各位可以去查看以及star。
文章版權歸作者所有,未經允許請勿轉載,若此文章存在違規行為,您可以聯系管理員刪除。
轉載請注明本文地址:http://specialneedsforspecialkids.com/yun/103913.html
摘要:好的項目代碼結構會大大提升項目的維護性和可擴展性。多說無益,我這里直接給大家一個示意圖,大家可以按照我給的這個項目結構組織項目。你連文件目錄都設計不好,我拿什么相信你能設計出來可擴展的程序 很多人都會用項目腳手架,也會跑hello world,然后再寫寫簡單的todolist。但是再往下深入就難了。比如很多教程和老師都會說,大家要多問一個為什么。其實我想說多問你妹啊。我都不知道問為什么...
摘要:最近,一個問題總是時不時的冒出我的腦海前端性能優化時候還有必要回顧前端性能優化然后我找到了雅虎軍規的條盡量減少請求個數須權衡使用內容分發網絡為文件頭指定或,使內容具有緩存性。那就是時候停下來,問一問是否還有必要這樣做。 之前,何同學的視頻在網上活了一陣子。引發了我們思考:5G將會給我們帶來什么。同時也回顧了4G乃至3G時代已經給我們帶來了哪些新的變革。最近,一個問題總是時不時的冒出我的...
摘要:原則具體包括自動化獨立性可重復簡單的解釋一下三個原則單元測試應該是全自動執行的。為了保證單元測試穩定可靠且便于維護,需要保證其獨立性。原則編寫單元測試用例時為了保證被測模塊的交付質量需要符合原則。與設計文檔相結合來編寫單元測試。 本文首發于泊浮目的專欄:https://segmentfault.com/blog... 背景 最近項目在測試階段陸陸續續的測出了一些bug.這個情況剛出現...
閱讀 2125·2019-08-29 16:53
閱讀 2700·2019-08-29 16:07
閱讀 2043·2019-08-29 13:13
閱讀 3268·2019-08-26 13:57
閱讀 1332·2019-08-26 13:31
閱讀 2434·2019-08-26 13:22
閱讀 1222·2019-08-26 11:43
閱讀 2085·2019-08-23 17:14