用 Vue.js 寫分頁功能時,我加了一個自訂 filter,結果 console 拋出錯誤訊息:
Failed to resolve filter: HomePage

console 錯誤資訊

原來的錯誤寫法
摸索一陣子後發現,問題竟然只是執行順序。我先把 pageList 跑起來、開始渲染視圖,之後才註冊 Vue 的 filter。Vue 在編譯模板時找不到對應的 filter,於是拋出這個錯誤。

修改後的正確寫法
把 filter 的註冊搬到建立 Vue 實例之前,錯誤就消失了。順序重點如下:
// 全域 filter 要在建立根實例之前註冊
Vue.filter('HomePage', function(value){
return value + ' 頁';
});
// 或者在使用它的元件內部用 filters 選項宣告
new Vue({
el: '#app',
data: { pageList: [] },
filters: {
HomePage: function(value){ return value + ' 頁'; }
}
});
「Failed to resolve filter」不只一種成因,遇到時可以依序檢查:
homePage、註冊時寫 HomePage 就會找不到。filters 宣告的 filter 只該元件可用,父層拿不到。本文已整理進《Vue.js 前端元件學習教程》,有興趣可以延伸閱讀。