本文精選了3個有助於改善用戶體驗的AngularJS指令。AngularJS是一款人氣極高的JavaScript框架,需要的朋友可以參考借鑑。
要在應用中展示用戶頭像,通常需要取得用戶的電子郵件地址,將其轉為小寫後再做md5加密。把這套邏輯封裝成指令,就能輕鬆復用。
示例用法:
<gravatar-image email="test@email.com" size="50"></gravatar-image>
指令定義如下:
app.directive('gravatarImage', function () {
return {
restrict: 'AE',
replace: true,
required: 'email',
template: '<img ng-src="https://www.gravatar.com/avatar/{{hash}}?s={{size}}&d=identicon" />',
link: function (scope, element, attrs) {
attrs.$observe('email', function (value) {
if(!value) { return; }
// 這裡引入md5加密函數,對郵箱地址做小寫處理後加密
scope.hash = md5(value.toLowerCase());
scope.size = attrs.size;
if(angular.isUndefined(scope.size)) {
scope.size = 60; // 預設60像素
}
});
}
};
});
其中的md5加密函數較長,可從公開的加密庫中引入,此處為保持簡潔略去其實現細節。
這是一個短小卻實用的指令。以下例子中,用戶點擊鏈接後出現的輸入框會自動獲得焦點,無需再手動點擊。
示例用法:
<a ng-click="addName=true">添加名字</a>
<input ng-show="addName" type="text" ng-model="name" focus-me="{{addName}}" />
指令定義如下:
app.directive('focusMe', ['$timeout', function($timeout) {
return {
scope: { trigger: '@focusMe' },
link: function(scope, element) {
scope.$watch('trigger', function(value) {
if(value === "true") {
$timeout(function() {
element[0].focus();
});
}
});
}
};
}]);
我們選用contenteditable而非textarea,主要是因為前者在佈局與UI上沒有太多限制。這條指令能把contenteditable元素的HTML內容與ng-model進行雙向綁定。目前框架原生並不支援在contenteditable上使用ng-model。
示例用法:
<p contenteditable="true" ng-model="text"></p>
指令定義如下:
app.directive('contenteditable', function() {
return {
require: '?ngModel',
link: function(scope, element, attrs, ctrl) {
// 若未綁定模型則不做任何處理
if (!ctrl) { return; }
// 監聽輸入或回車,view -> model
element.bind('input enterKey', function() {
var rerender = false;
var html = element.html();
if (attrs.noLineBreaks) {
html = html.replace(/<div>/g, '').replace(/<br>/g, '').replace(/<\/div>/g, '');
rerender = true;
}
scope.$apply(function() {
ctrl.$setViewValue(html);
if(rerender) { ctrl.$render(); }
});
});
element.keyup(function(e){
if(e.keyCode === 13){ element.trigger('enterKey'); }
});
// model -> view
ctrl.$render = function() { element.html(ctrl.$viewValue); };
// 從DOM載入初始值
ctrl.$render();
};
};
});
希望透過上述介紹,你能體會到AngularJS指令的用處。對我而言,指令是AngularJS最令人振奮的特性之一。它能創建可復用的組件,並添加到純HTML的應用中,這種能力既強大又優雅。由於指令實用且編寫難度不高,社群早已為眾多熱門庫開發了大量指令。例如,AngularJS團隊就為Bootstrap打造了一系列指令,也就是廣為人知的UI Bootstrap。