紀錄工作經驗、相關知識,解決技術相關問題。

Javascript, 網站相關

MVVM 架構模式解析:Model、View 與 ViewModel 職責劃分與資料綁定原理

MVVM 架構模式解析:Model、View 與 ViewModel 職責劃分與資料綁定原理 特色圖片

MVVM 架構(Model-View-ViewModel)把應用程式的商業與呈現邏輯,和使用者介面(UI)分開。Microsoft 的說明指出,這種分離讓應用程式更容易測試、維護與演進。

想了解基礎原理細節可前往 〈MVC vs MVVM 差異比較:前端框架狀態管理與雙向綁定機制〉 觀看,本文聚焦於 Model、View 與 ViewModel 的職責邊界,以及屬性變更通知的運作方式。

跳往 生產環境可用程式碼範本(#examples)


一、 核心速查與常見瓶頸對照

釐清各元件的職責範圍,是避免畫面與邏輯糾纏的第一步。以下先列出常見的錯誤寫法,再用表格對照三個角色。

1. 常見錯誤寫法的工程瓶頸

  • ViewModel 參考 View 型別:Microsoft 建議不要在 ViewModel 中引用 Button、ListView 這類 View 型別,ViewModel 才能獨立測試。
  • 商業邏輯寫在 View 的 code-behind:UI 控制項與商業邏輯緊密耦合,會增加修改 UI 的成本,也讓這類程式碼難以進行單元測試。
  • 用 code-behind 手動啟用或停用 UI 元素:官方建議由 ViewModel 定義「命令是否可用」「操作是否進行中」這類狀態,View 以綁定 ViewModel 屬性的方式呈現。
  • 屬性變更通知使用不當:值沒有改變卻發出通知,或在同一次方法呼叫中對同一個屬性重複通知,違反官方列出的通知原則(見 Q2)。

2. 核心機制規格對照表

核心元件主要職責與角色依賴與互動對象避免發生的反模式
Model封裝應用程式的資料,通常包含資料模型與商業、驗證邏輯,常搭配 service 或 repository 處理資料存取。不知道 ViewModel 的存在。反過來依賴 ViewModel 或 View。
View定義畫面的結構、版面與外觀;透過資料繫結與命令連結 ViewModel。知道 ViewModel。在 code-behind 放商業邏輯。
ViewModel實作 View 可繫結的屬性與命令,透過變更通知事件告知 View 狀態改變,並協調 View 與 Model 的互動。知道 Model,不知道 View。引用 Button、ListView 等 View 型別。

補充說明:上表依 Microsoft Learn 的 .NET MAUI MVVM 說明整理。Martin Fowler 的 GUI Architectures 頁面指出,Presentation Model 也稱為 MVVM。


二、 關鍵機制解析:底層規範與注意事項

1. 職責劃分與資料流向原理

依官方說明,View 知道 ViewModel、ViewModel 知道 Model,Model 不知道 ViewModel,ViewModel 也不知道 View。因此 ViewModel 隔開了 View 與 Model,讓 Model 可以獨立於 View 演進。

ViewModel 負責提供屬性與命令,決定 UI 要提供哪些功能;功能如何顯示,則由 View 決定。Model 的資料常需要轉成畫面容易使用的形式,例如把兩個屬性的值合併成一個顯示字串,官方建議這類資料轉換放在 ViewModel。

View 端實際操作 DOM 時的重排與重繪成本,可參考 DOM 樹狀結構與渲染引擎:Reflow 重排與 Repaint 重繪效能優化要點。

使用者操作的方向則是:View 上的按鈕點擊或項目選取,經由命令(Command)繫結執行 ViewModel 的程式碼,不在 code-behind 寫事件處理函式。

2. 屬性變更通知與雙向資料綁定

要讓 ViewModel 參與雙向資料綁定,它的屬性在值改變時必須引發 PropertyChanged 事件;.NET 以實作 INotifyPropertyChanged 介面達成。JavaScript 沒有內建的對應介面,下方範本一改用 Proxy 攔截屬性設定,自行在狀態改變時通知訂閱者。

MDN 指出,Proxy 可以攔截並重新定義物件的基本操作;Vue 3 對 reactive 物件正是使用 Proxy,Vue 2 則只用 getter/setter。細節可參考 Vue.js 反應式系統 Proxy 與雙向綁定底層實作差異解析。

前端框架的做法也不同。Vue 的 v-model 是 :value 綁定加 input 事件監聽的簡寫,以目前綁定的 JavaScript 狀態為準;React 則是由頂層元件以 props 往下傳遞資料(one-way data flow),子元件透過父元件傳下的函式回傳使用者輸入。

補充說明:上述 Vue 與 React 官方文件並未把自己歸類為 MVVM,這裡只是比較資料流動的方式。


三、 實作範本:生產環境完整程式碼

以下提供兩個範本,分別展示以 Proxy 做狀態變更通知的 ViewModel,以及以 Command 封裝使用者行為的 ViewModel。

範本一:基於 ES6 Proxy 與訂閱通知的 ViewModel 封裝

此範本用原生 JavaScript 實作輕量級 ViewModel,ViewModel 不碰 DOM,只在狀態改變時通知訂閱者。

// Model 層:處理資料與 API 請求
class UserModel {
  async fetchUserData(userId) {
    // 模擬非同步網路請求
    return new Promise((resolve) => {
      setTimeout(() => {
        resolve({ id: userId, name: 'Sean', role: 'Engineer' });
      }, 500);
    });
  }
}

// ViewModel 層:管理 UI 狀態與商業邏輯
class UserViewModel {
  constructor(model) {
    this.model = model;
    this._state = {
      user: null,
      isLoading: false,
      errorMessage: ''
    };
    this._listeners = [];

    // 使用 Proxy 攔截狀態變更,自動觸發畫面更新通知
    this.state = new Proxy(this._state, {
      set: (target, property, value) => {
        target[property] = value;
        this._notifyListeners();
        return true;
      }
    });
  }

  // 回傳取消訂閱的函式,View 結束時可呼叫
  subscribe(listener) {
    this._listeners.push(listener);
    return () => {
      this._listeners = this._listeners.filter((l) => l !== listener);
    };
  }

  _notifyListeners() {
    this._listeners.forEach(listener => listener(this.state));
  }

  async loadUser(userId) {
    this.state.isLoading = true;
    this.state.errorMessage = '';
    try {
      const data = await this.model.fetchUserData(userId);
      this.state.user = data;
    } catch (error) {
      this.state.errorMessage = '載入使用者資料失敗';
    } finally {
      this.state.isLoading = false;
    }
  }
}

// 模擬 View 層的渲染邏輯
const model = new UserModel();
const viewModel = new UserViewModel(model);

const unsubscribe = viewModel.subscribe((state) => {
  if (state.isLoading) {
    console.log('畫面渲染:載入中...');
  } else if (state.errorMessage) {
    console.log(`畫面渲染錯誤:${state.errorMessage}`);
  } else if (state.user) {
    console.log(`畫面渲染完成:歡迎 ${state.user.name} (${state.user.role})`);
  }
});

// 觸發動作
viewModel.loadUser(101).then(() => unsubscribe());

使用範本時的 Node.js 輸出如下:

畫面渲染:載入中...
畫面渲染:載入中...
畫面渲染:載入中...
畫面渲染完成:歡迎 Sean (Engineer)

補充說明:每一次透過 state 指派屬性都會通知一次,所以 isLoading 設為 true、errorMessage 清空、user 寫入(此時 isLoading 仍是 true)各通知一次,輸出三行「載入中」;最後 isLoading 設為 false 才顯示完成畫面。若要避免連續通知,可比照 Microsoft 的原則,在方法結束或狀態穩定後再通知。

範本二:命令模式實作(Command Pattern)取代事件監聽器

此範本示範用 Command 物件封裝使用者行為,讓 ViewModel 獨立於具體的 DOM 事件物件之外。物件內含 execute 與 canExecute,對應 .NET 的 ICommand 介面。

class Command {
  constructor(execute, canExecute) {
    this.execute = execute;
    this.canExecute = canExecute || (() => true);
  }
}

class FormViewModel {
  constructor() {
    this.username = '';
    this.isSubmitting = false;

    // 定義提交命令
    this.submitCommand = new Command(
      () => this.submitForm(),
      () => this.username.trim().length > 0 && !this.isSubmitting
    );
  }

  setUsername(value) {
    this.username = value;
    // 狀態改變時可動態評估命令是否可執行
  }

  async submitForm() {
    if (!this.submitCommand.canExecute()) return;
    
    this.isSubmitting = true;
    console.log(`執行提交作業,使用者名稱:${this.username}`);
    
    // 模擬非同步提交
    await new Promise(resolve => setTimeout(resolve, 1000));
    
    this.isSubmitting = false;
    console.log('提交完成');
  }
}

// 驗證命令模式運作
const formVm = new FormViewModel();
formVm.setUsername('Sean');

if (formVm.submitCommand.canExecute()) {
  formVm.submitCommand.execute();
}

使用範本時的 Node.js 輸出如下:

執行提交作業,使用者名稱:Sean
提交完成

補充說明:.NET 的 ICommand 除了 Execute、CanExecute,還有 CanExecuteChanged 事件:ViewModel 在命令可用狀態改變時引發此事件,綁定的控制項就會更新啟用狀態。範本中的 Command 為簡化版,沒有這個事件,需要由呼叫端自行在適當時機重新呼叫 canExecute()。


四、 常見問題與排錯(Q&A)

Q1:ViewModel 如何避免直接參考 View?

解答:ViewModel 不引用 View 型別,只透過屬性繫結與命令和 View 溝通。

Microsoft 建議,View 對 ViewModel 的主要依賴應該是把控制項繫結到資料來源的屬性;不要在 ViewModel 中引用 Button、ListView 這類 View 型別,如此 ViewModel 才能獨立測試。

ViewModel 若訂閱了事件,在 View 結束時也要取消訂閱。範本一的 subscribe 會回傳取消訂閱的函式,就是為了這個用途;React 的 useEffect 清理函式也是在元件從 DOM 移除後執行,用來移除監聽。

Q2:實作屬性變更通知時,有哪些原則要遵守?

解答:只在值真的改變時通知,並在物件處於穩定狀態時才發出。

依 Microsoft 列出的屬性變更通知原則:

  1. 公開屬性的值改變時,一律引發 PropertyChanged。
  2. 計算屬性所依賴的值改變時,也要為計算屬性引發通知。
  3. 在修改屬性的方法結束時,或物件處於安全狀態時才引發事件;通知會同步呼叫處理函式,若在操作中途引發,可能讓處理函式看到只更新一半的物件。
  4. 屬性值沒有改變時,不要引發事件,所以要先比較新舊值。
  5. 在 ViewModel 建構函式中初始化屬性時,不要引發事件,此時繫結的控制項尚未訂閱。
  6. 在同一次同步呼叫公開方法的過程中,同一個屬性名稱不要通知超過一次。

補充說明:同一頁也提到,用 lambda 運算式傳入屬性名稱會有小幅的效能成本,換得編譯期的型別安全與重新命名支援。

Q3:在 MVVM 架構下,如何處理非同步資料流與網路請求?

解答:把非同步請求收斂到 ViewModel,並用狀態屬性向外呈現結果。

開發者常把 API 呼叫寫在 View 的點擊事件中,導致載入中、錯誤訊息、資料回傳這些狀態無法被複用與測試。

Microsoft 建議在 ViewModel 中用非同步方法處理 I/O,並引發事件以非同步方式通知 View 屬性變更,避免阻塞 UI 執行緒。View 只依據 isLoading、errorMessage 這類狀態屬性切換畫面,範本一就是這種做法。

Q4:ViewModel 是否可以包含商業邏輯?與 Model 的界線在哪裡?

解答:ViewModel 放呈現邏輯與狀態,核心商業與驗證邏輯放在 Model。

官方說明中,ViewModel 封裝呈現邏輯與狀態,例如把資料轉成畫面容易使用的形式,或定義命令是否可用;Model 則包含資料模型與商業、驗證邏輯,並常搭配 service 或 repository 處理資料存取。

ViewModel 同時負責協調 View 與 Model 的互動,通常一個 ViewModel 會對應多個 Model 類別。若 ViewModel 把所有計算與 API 呼叫全包辦,就會失去這個分工。

Q5:如何對 ViewModel 進行單元測試?

解答:直接實例化 ViewModel,不需要 View。

Microsoft 指出,開發者可以在不使用 View 的情況下,對 ViewModel 與 Model 撰寫單元測試,而且 ViewModel 的測試可以執行與 View 完全相同的功能。

做法是實例化 ViewModel,傳入替代用的 Model,再驗證它暴露的狀態屬性與方法行為。前提是 ViewModel 沒有引用 View 型別(見 Q1)。

Q6:Command 模式如何取代傳統事件監聽器?

解答:把動作封裝成 Command 物件,View 只繫結 Command。

Microsoft 說明,Command 封裝執行動作的程式碼,並讓它和視覺呈現脫鉤,ViewModel 因此不直接依賴 UI 框架提供的事件,也更容易移植到其他平台。

ICommand 定義了 Execute(執行動作)、CanExecute(是否可執行)與 CanExecuteChanged(可用狀態改變的事件)。綁定到命令的控制項會在 CanExecuteChanged 觸發後更新啟用狀態,不必在多個事件處理函式中重複判斷。範本二示範了 execute 與 canExecute 的封裝方式。


想看 .NET WPF 裡 INotifyPropertyChanged 與 ICommand 的實作,可以參考〈WPF MVVM 範本:INotifyPropertyChanged 與 ICommand〉。

參考資料與延伸閱讀

發佈留言