有關自定義指令的scope參數,網上很多文章都在講這3種綁定方式實現的效果是什麼,但幾乎沒有人講到底怎麼使用,本篇希望聊聊 到底怎麼用 這個話題。 一. 自定義指令 自定義指令,是 用來實現組件化的方式,相比於 和`Vue`的組件化方式,它真的很複雜,自定義指令太重了,它暴露了太多可供定製的參數,以 ...
有關自定義指令的scope參數,網上很多文章都在講這3種綁定方式實現的效果是什麼,但幾乎沒有人講到底怎麼使用,本篇希望聊聊到底怎麼用這個話題。
一. 自定義指令
自定義指令,是Angularjs
用來實現組件化的方式,相比於React
和Vue
的組件化方式,它真的很複雜,自定義指令太重了,它暴露了太多可供定製的參數,以至於普通的開發者完全不知道要用它來做什麼而將其束之高閣,畢竟一般的業務邏輯通過controller和service就已經可以完成了。
自定義指令在Angularjs
項目中主要有兩大用途:
1.封裝指定組件的DOM操作
Angularjs
期望的開發方式是將DOM的操作儘可能封裝在自定義指令中,這樣對於局部變數的操作會更容易加入到Angular自己的生命周期中。2.組件化
Angularjs
靠自定義指令實現組件化。諸如你在React
和Vue
中看到的類似於,這樣的自定義標簽,或是父級子級傳值所使用的prop,又或者是標記組件自身狀態的state,在Angularjs
中全部都是通過自定義指令來實現的。
二. 數據綁定的形式
自定義指令在定義後,需要在html文件中編寫,最常用的方式是將其書寫為標簽屬性。當使用自定義指令時,常常需要將一個變數的值從controller傳遞至directive中,此時需要在scope
屬性中進行變數綁定設置,Angularjs
提供了3種不同的綁定方式(實際上也可以直接傳遞True),如下所示:
scope: {
infiniteScroll: '=', // 將infiniteScroll同父級controller中的指定對象雙向綁定
onSend: '&', // 從父級獲取一個變數的引用,常用作方法調用
fromName: '@' // 從父級獲取值後便只在本地作用域生效
}
關於三種綁定方式使用的方法,網上可以搜到非常多的文章,本篇不再贅述,今天我們只來詳細看一下這幾種方式的使用場景和區別。
2.1 @綁定
@綁定
可以轉移常量賦值的位置,常用於為自定義封裝組件暴露一個可設定常量參數的介面。這種綁定方式的意義,在於從自定義指令外部(一般是從html頁面上綁定一個常量或控制器中的變數)獲取一個局部變數的值。
實際場景:
例如我們封裝了一個分頁組件,其中指令局部作用域中的displayPaginationNums
屬性用於決定分頁組件的頁碼欄顯示多少個按鈕,然後把剩餘的按鈕收起來並添加...
按鈕,這是一個很常見的需求。
不使用@綁定
不使用@綁定,完全可以做到,只需要在link函數里,初始化為其賦值即可。
link:function(scope, elements, attrs){
scope.displayPaginationNums = 5;//用於決定分頁導航欄最多可顯示幾個數字
},
使用這樣的方式,就可以,但我們預設了一個前提,那就是所有調用這個組件的人,都會瀏覽這個組件的源代碼。這其實是很不方便的,換位思考一下,你使用Angularjs
的時候,會先去源碼里找一下對應的方法開頭都定義了哪些變數,哪些可以修改嗎?當然不會。
這個屬性在不同的項目中都會需要賦值,但需要動態去修改的場景其實並不多,所以我們需要將介面暴露至更高的開發層級,供調用者直接賦值。
使用@綁定
當使用@綁定後,我們實際上是面向調用者暴露了去設定重要參數的介面,使用起來更加方便。下麵的寫法讓開發者使用這個組件時,可以在代碼編寫時方便地傳入自己想要設定的值:
//指令定義時
scope:{
displayPaginationNums:'@'
},
<!--指令調用時-->
<div table-pagination
display-pagination-nums="5">
面向對象程式設計原則中有一個重要的原則,叫做開放封閉原則,它的意思是說,你在程式設計中所書寫的代碼,應該對擴展開放,對修改封閉。簡單地說就是你所編寫的代碼成型以後,在後續的使用和功能擴展的時候,儘可能不需要再去改動代碼,而只需要通過編寫與擴展相關的代碼即可。
此處就是從封閉轉為開放的一個示例,雖然看起來很細小,但可以很明確地表達這個原則。
2.2 &綁定
&綁定
用於傳遞父級函數的引用,用來調用父級控制器中定義的方法。如果只是以業務邏輯為模塊進行封裝,這種綁定方式可以幫我們避免一部分代碼重覆,如果是為通用框架編寫純組件,則可以為調用者提供自定義函數的介面。
實際場景:
比如我們在製作一個表格和分頁組件時,表格每一頁只顯示10條數據,分頁是後臺來完成的,那麼每一次點擊分頁組件上的頁碼按鈕時,我們都需要向後臺發送ajax請求來獲取新一頁的數據。那麼這個發送ajax請求的方法你會寫在哪裡呢?
不使用&綁定
將方法寫在controller中
優勢:這樣做的好處是如果以後我們需要增加一個輸入框來實現精確跳轉到哪一頁時,可以直接在模板中使用
ng-change="sendAjax( )"
來綁定這個方法,方便復用,擴展,甚至修改功能。劣勢:但這樣做的話,如果想在自定義指令中就無法直接調用這個方法,常見的處理策略是在自定義指令中使用
scope.$emit( )
將一個自定義事件發送至父級controller,在父級controller中使用$scope.$on( )
來監聽這個自定義事件,併在回調中執行$scope.sendAjax( )
這個方法。將方法寫在指令的link函數中
優勢:可以將一些不需要用戶感知的函數封裝起來,例如數據發送前的校驗,或是響應數據的結構重組等,提高業務邏輯相關的代碼在controller中的比重,減小controller的體積。
劣勢:當其他組件想要使用這個方法時會很困難,Angularjs並沒有提供一種跨directive調用方法的機制。
實際上在開發過程中,不熟悉
&綁定
的開發者在使用自定義指令時,幾乎都會選擇將方法寫在controller中並通過消息機制來觸發這個函數(也就是上文中第一個方法),他們希望指令所封裝的組件是純粹的,換句話說,它是可復用且與業務邏輯剝離的。
使用&綁定
對於業務邏輯開發而言
簡潔且容易使用,組件可直接調用controller中的業務邏輯代碼,避免了當自定義事件過多時造成的controller中充滿了事件監聽的回調方法的問題,使用方法如下:
//主模板中
<div change-page="sendAjax"></div>
//指令定義中
...
template:'<div ng-click="changePage()"></div>'
scope:{
changePage: '&'
},
...
對於模塊封裝而言
從上面的示例就可以看出,自定義指令中實際執行的
changePage( )
方法,是用戶在使用這個組件時編寫在controller之中的sendAjax( )這個方法,當我們需要封裝一個供其他開發者調用的組件時(往往是在編寫一個組件庫),這種結構是在angular中最自然的實現方式。
當你希望給一個自定義指令暴露越來越多個性化定製介面時,它很可能變得臃腫,甚至一無是處。
&綁定
意義,在於將業務邏輯從組件中剝離出來,但過多的可定製性又會給開發者帶來額外的問題,你會發現,僅僅是簡單地使用一個下拉框或是勾選框之類的簡單組件時,就需要傳入一大堆自定屬性,而這本該是在交互設計標準中確定好並編寫在項目中的指定位置的。自定義指令的可定製性越高,html模板的體積就會越大,controller中的代碼量也會隨之增大,帶來的直接問題就是:開發很方便,維護很痛苦。
2.3 =綁定
=綁定
是3中綁定形式中最常用的一種,常用於將用於渲染的數組或對象傳入自定義指令中。這樣做可以將業務邏輯分塊,使得代碼結構更具有層次性,降低維護難度。
實際場景:
一個表格組件,需要通過ajax請求從後臺獲取100條用於展示的數據,這些數據可能需要排序,過濾,分頁等操作,首先應該明確的是,即時這些代碼全部寫在controller中,程式也是可以運行的,只是當你在其他場合需要復用時,就需要複製粘貼很多代碼。那麼該如何來設計這樣一個功能並提取公用組件呢?排序
,過濾
,分頁
都是表格組件的通用動作,也就是說與數據對象本身的結構並沒有太大關係,對於一個通用型表格控制項來說,我們唯一必須要傳入的只有一項——數據源,且它是有可能會隨著用戶操作而發生變化的。
推薦的技術方案為:
- service : 封裝$http操作,信息提示,及容錯處理
- controller : 調用service暴露的方法從後臺獲取數據,並賦值給指定變數
- directive : 雙向數據綁定controller中的變數以獲取驅動表格渲染的數據,將排序,過濾,分頁的具體實現封裝在指令內部。
這樣的結構,使巨集觀業務邏輯,前後臺信息交互,組件通用功能分別在不同的模塊中實現,可以極大提高定位問題的速度。
=綁定
的雙向數據綁定在使用中是存在一些方法問題的,詳情請參考《Angularjs1.X進階筆記(1)—兩種不同的雙向數據綁定》
。
三. 自定義指令的實用意義
=綁定
—— 常用於傳遞從後臺獲取的用於驅動純組件的源數據。@綁定
—— 為自定義指令中傳遞可配置的常量參數提供設置介面。&綁定
—— 為自定義指令中傳遞自定義方法提供介面。