高級 Vue 組件模式 (8)

08 使用 Control Props

目標

在第七篇文章中,我們對 toggle 組件進行了重構,使父組件能夠傳入開關狀態的初始值,同時還可以傳入自定義的狀態重置邏輯。雖然父組件擁有了改變 toggle 組件內部狀態的途徑,但是如果進一步思考的話,父組件並沒有絕對的控制權。在一些業務場景,我們期望父組件對於子組件的狀態,擁有絕對的控制權。

熟悉 React 的讀者一定不會對智能組件(Smart Component)和木偶組件(Dump Component)感到陌生。對於後者,其父組件一定對其擁有絕對控制權,因爲它內部沒有狀態,渲染邏輯完全取決於父組件所傳 props 的值。而對於前者則相反,由於組件內部會有自己的狀態,它內部的渲染邏輯由父組件所傳 props 與其內部狀態共同決定。

這篇文章將着重解決這個問題,如果能夠使一個智能組件的狀態變得可控,即:

  • toggle 組件的開關狀態應該完全由 prop 屬性 on 的值決定
  • 當沒有 on 屬性時,toggle 組件的開關狀態降級爲內部管理

額外地,我們還將實現一個小需求,toggle 組件的開關狀態至多切換四次,如果超過四次,則需點擊重置後,才能夠重新對開關切換狀態進行切換。

實現

判定組件是否受控

由於 toggle 組件爲一個智能組件,我們需要提供一個判定它是否受控的方式。很簡單,由目標中的第一點可知,當父組件傳入了 on 屬性後,toggle 處於被控制的狀態,否則則沒有,於是可以利用 Vue 組件的 computed 特性,聲明一個 isOnControlled 計算屬性,如下:

computed: {
  isOnControlled() {
    return this.on !== undefined;
  }
}

其內部邏輯很簡單,就是判定 prop 屬性 on 的值是否爲 undefined,如果是,則未被父組件控制,反之,則被父組件控制。

更改 on 的聲明方式

由於要滿足目標中提及的第二點,關於 prop 屬性 on 的聲明,我們要做出一些調整,如下:

on: {
  type: Boolean,
  default: undefined
},

就是簡單地將默認值,由 false 改爲了 undefined,這麼做的原因是因爲,按照之前的寫法,如果 on 未由父組件傳入,則默認值爲 false,那麼 toggle 組件會認爲父組件實際傳入了一個值爲 falseon 屬性,因此會將其內部的開關狀態控制爲,而非降級爲內部管理開關狀態。

實現狀態解析邏輯

之前的實現中,通過 scope-slot 注入插槽的狀態完全取決於組件內部 status 的值,我們需要改變狀態的注入邏輯。當組件受控時,其開關狀態應該與 prop 屬性保持一致,反之,則和原來一樣。因此編寫一個叫做 controlledStatus 的計算屬性:

controlledStatus() {
  return this.isOnControlled ? { on: this.on } : this.status;
}

這裏利用了之前聲明的 isOnControlled 屬性來判斷當前組件是否處於受控狀態。之後相應地把模板中開關狀態的注入邏輯也進行更改:

<slot :status="controlledStatus" :toggle="toggle" :reset="reset"></slot>

相應地,除了開關狀態的注入邏輯,toggle 方法和 reset 方法的注入邏輯也需要更改,至於爲什麼,就交由讀者自行思考得出答案吧,這裏簡單羅列實現代碼,以供參考:

// toggle 方法
toggle() {
  if (this.isOnControlled) {
    this.$emit("toggle", !this.on);
  } else {
    this.status.on = !this.status.on;
    this.$emit("toggle", this.status.on);
  }
}

// reset 方法
reset() {
  if (this.isOnControlled) {
    Promise.resolve(this.onReset(!this.on)).then(on => {
      this.$emit("reset", on);
    });
  } else {
    Promise.resolve(this.onReset(this.status.on)).then(on => {
      this.status.on = on || false;
      this.$emit("reset", this.status.on);
    });
  }
}

總體上的思路是,如果組件受控,則傳入回調方法中的開關狀態參數,是在觸發相應事件後,由 prop 屬性 on 得出的組件在下一時刻,應當處於的狀態。

這麼說可能有點繞,換句話說就是,當組件狀態發生更改時,如果當前的 on 屬性爲 true(開關狀態爲開),則組件本該處於關的狀態,但由於組件受控,則它內部不能直接將開關狀態更改爲關,而是依舊保持爲開,但是它會將 false(開關狀態爲關)作爲參數傳入觸發事件,這將告知父組件,當前組件的下一個狀態爲關,至於父組件是否同意將其狀態更改爲關則有父組件決定。

如果組件不受控,開關狀態由組件內部自行管理,那和之前的實現邏輯是一模一樣的,保留之前的代碼即可。

成果

toggle 組件被改造後,實現這個需求就很容易了。關於實現的代碼,這裏就不進行羅列了,有興趣可以通過在線代碼鏈接進行查看,十分簡單,這裏僅簡單附上一個最終的動態效果圖:

clipboard.png

你可以下面的鏈接來看看這個組件的實現代碼以及演示:

總結

關於 Controlled Component 和 Uncontrolled Component 的概念,我第一次是在 React 中關於表單的介紹中接觸到的。實際工作中,大部分對於狀態可控的需求也都存在於表單組件中,之所以存在這樣的需求,是因爲表單系統往往是複雜的,將其實現爲智能組件,往往內部狀態過於複雜,而如果實現爲木偶組件,代碼結構或者實現邏輯又過於繁瑣,這時如果可以借鑑這種模式的話,往往可以達到事半功倍的效果。

目錄

github gist

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章