DIV CSS 佈局教程網

AngularJS 自訂 directive 實作屬性繼承:讓子元素自動取得父元素的屬性
編輯:關於JavaScript     

自訂元件時常會遇到這個需求:父標籤上寫了一堆屬性,希望模板內部的元素能自動取得這些值,而不必透過 scope 一層層傳遞。做法是利用 Angular 的事件廣播機制,在父子 directive 之間傳遞屬性。

HTML:使用端

<!DOCTYPE html>
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 <title></title>
 <script src="../../Content/Plugins/Angular/angular.min.js"></script>
</head>
<body ng-app="mainApp" ng-controller="mainController">
 <quber-grid style="border: 1px solid #f00;" title="qubernet"></quber-grid>
</body>
</html>

這裡的 title="qubernet" 就是要往下傳的屬性。

模板:tmp.html

<div quber-grid-attr>
 我是測試的模板內容!
</div>

模板內的根元素掛了一個 quber-grid-attr 標記,這是接收方的識別點。

JavaScript

// 初始化 Angular 模組
var myNg = angular.module('mainApp', []);

// 父 directive:把自身的屬性集合廣播出去
myNg.directive('quberGrid', function () {
 return {
 restrict: 'EA',            // 同時允許元素與屬性兩種寫法
 replace: true,             // 用模板取代原本的 <quber-grid> 標籤
 templateUrl: 'tmp.html',
 link: function (sco, ele, attr) {
 // 通知下屬 DOM,執行名為 sendChildGridAttr 的事件
 sco.$broadcast('sendChildGridAttr', attr);
 }
 };
});

// 子 directive:接收廣播並把屬性設定到自己身上
myNg.directive('quberGridAttr', function () {
 return {
 restrict: 'A',
 link: function (sco, ele, attr) {
 sco.$on('sendChildGridAttr', function (event, data) {
 angular.forEach(data, function (val, key, obj) {
 if (key != '$attr' && key != '$$element') {
 attr.$set(key, val);
 }
 });
 });
 }
 };
});

myNg.controller('mainController', function ($scope) {
});

運作流程

1. Angular 編譯到 <quber-grid>,觸發父 directive 的 link 階段。

2. 此時 attr 參數裝著這個元素上的所有屬性,包含 title 與 style。

3. $broadcast 把這個 attr 物件往下發送,事件名為 sendChildGridAttr。

4. 模板中的 <div quber-grid-attr> 被編譯時,子 directive 透過 $on 收到廣播。

5. 遍歷屬性,用 attr.$set() 逐一設定到自己身上,排除掉 Angular 的內部欄位。

幾個實作上的提醒

為何要排除 $attr 與 $$element:attr 物件除了 HTML 上寫的屬性,還夾帶了 Angular 自己用的內部參照。若一併 $set 進去,會產生無意義的屬性甚至引發錯誤。

$broadcast 與 $emit 的差別:$broadcast 是往下(父 → 子)傳,$emit 是往上(子 → 父)傳。這裡要從外層元件傳進模板,所以必須用 broadcast。

時序問題:這個寫法依賴「父 directive 的 link 先執行,子 directive 後執行」。多數情況成立,但若模板是透過非同步方式載入,就可能需要改用 $timeout 延遲廣播,或改用更可靠的方式——直接在父 directive 中操作模板根元素的 attrs。

更 Angular 的替代方案:如果只是要傳值,其實用隔離 scope 綁定屬性會更直觀:scope: { title: '@' },然後在模板中用 {{title}} 取用。事件廣播的價值在於「傳遞一組不特定、數量不固定的屬性」,這才是上面這個範例真正的用武之地。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved