本文深入講解AngularJS自定義指令的用法。AngularJS是一款熱門的JavaScript開發庫,需要的朋友可以參考。
所謂自定義指令,其實就是你自己寫的指令,會在AngularJS編譯DOM時作為核心函數被執行。假設你想在應用的不同頁面復用某段特定代碼,又不想反覆複製粘貼,那麼就可以把這段代碼抽到單獨的文件,再透過自定義指令來引用它。這樣代碼更易於維護和理解。AngularJS共有四種類型的自定義指令:
元素指令
屬性指令
CSS class 指令
注釋指令
在動手實現之前,先看看自定義指令大致長什麼樣。
在HTML中寫入如下標籤,用來放置代碼片段:
<guitar-reviews> ... </guitar-reviews>
在JS文件中,用以下代碼讓該指令生效:
app.directive('guitarReviews', function() {
return {
restrict : 'E', // 使用E表示元素指令
templateUrl : 'custom-directives/reviews.html'
};
});
代碼解釋:如同app.controller,我們先定義app.directive,接著定義guitarReviews,它是HTML中使用的元素標籤名。值得注意的是,guitar-reviews與guitarReviews並不相同——這是因為連字符形式會被轉換為駝峰式命名,所以在JS裡變成了guitarReviews。restrict: 'E' 表示我們定義的是元素指令,templateUrl則指向要引入的代碼片段文件。
在HTML標籤中寫入如下屬性,用來承載代碼片段:
<div guitar-reviews> ... </div>
在JS文件中,用以下代碼讓該指令生效:
app.directive('guitarReviews', function() {
return {
restrict : 'A', // 使用A表示屬性指令
templateUrl : 'custom-directives/reviews.html'
};
});
注意:AngularJS建議使用普通的CSS class與注釋,而非自定義指令中的CSS和注釋形式。
接下來我們在項目中實際實現自定義指令。
在指定文件夾下新建一個名為cDirectives的文件夾用來存放自定義指令,再在其中創建reviews.html文件,用於容納用戶評論。此時文件夾層次結構如下:

在details.html中剪切評論部分,並添加<user-reviews></user-reviews>標籤:

將你從details.html剪切的代碼粘貼到reviews.html中:
<!-- Review Tab START, it has a new controller -->
<div ng-show="panel.isSelected(3)" class="reviewContainer" ng-controller="ReviewController as reviewCtrl">
<div class="longDescription uReview" ng-repeat="review in guitarVariable[whichGuitar].reviews">
<h3>Review Points: {{review.star}} </h3>
<p> {{review.body}} ~{{review.name}} on {{review.createdOn | date:'MM/yy'}} </p>
</div>
<div ng-show="add === 1" class="longDescription uReview">
<h3>Review Points: {{reviewCtrl.review.star}} <span ng-click="add=0">X</span></h3>
<p> {{reviewCtrl.review.body}} ~ {{reviewCtrl.review.name}} </p>
</div>
<a href ng-click="add=1" class="addReviewLink">Add review</a>
<form class="reviewForm" name="reviewForm" ng-submit="reviewForm.$valid && reviewCtrl.addReview(guitarVariable.indexOf(guitarVariable[whichGuitar]))" novalidate ng-show="add===1">
<div>
Review Points: <select ng-model="reviewCtrl.review.star" ng-options="point for point in [5,4,3,2,1]" required></select>
Email: <input type="email" ng-model="reviewCtrl.review.name" required>
<button type="submit">Submit</button>
</div>
<textarea placeholder="Enter your experience with this guitar..." ng-model="reviewCtrl.review.body"></textarea>
</form>
</div><br /><!-- END Review Tab -->
現在可以為user-reviews標籤添加行為了。打開controller.js,加入如下代碼:
GuitarControllers.directive('userReviews', function() {
return {
restrict : 'E', // 使用E表示元素指令
templateUrl : 'partials/cDirectives/reviews.html'
};
});
代碼解釋:這裡的<user-reviews>指令變成了駝峰形式的userReviews,連字符隨之消失。當它被調用時,會加載templateUrl指定的文件,並將該指令限制為元素E類型。
至此,我們就自定義了一個指令。儘管界面上看不出變化,但代碼結構已變得更加清晰有序。你也能嘗試為描述與規格自定義指令,動手試試吧。