Anglejsから始めて、いくつかの古いJQueryプラグインをAngularディレクティブに変換する作業をしています。 (要素)ディレクティブの一連のデフォルトオプションを定義したいのですが、属性でオプション値を指定することでオーバーライドできます。
私は他の人がこれを行った方法を見て回っていましたが、 angular-ui ライブラリでは i.bootstrap.pagination が似たようなことをしているようです。
最初に、すべてのデフォルトオプションが定数オブジェクトで定義されます。
.constant('paginationConfig', {
itemsPerPage: 10,
boundaryLinks: false,
...
})
次に、getAttributeValue
ユーティリティ関数がディレクティブコントローラーにアタッチされます。
this.getAttributeValue = function(attribute, defaultValue, interpolate) {
return (angular.isDefined(attribute) ?
(interpolate ? $interpolate(attribute)($scope.$parent) :
$scope.$parent.$eval(attribute)) : defaultValue);
};
最後に、これはリンク関数で使用され、属性を次のように読み込みます。
.directive('pagination', ['$parse', 'paginationConfig', function($parse, config) {
...
controller: 'PaginationController',
link: function(scope, element, attrs, paginationCtrl) {
var boundaryLinks = paginationCtrl.getAttributeValue(attrs.boundaryLinks, config.boundaryLinks);
var firstText = paginationCtrl.getAttributeValue(attrs.firstText, config.firstText, true);
...
}
});
これは、デフォルト値のセットを置き換えたいという標準的なものの、やや複雑なセットアップのようです。これを行う他の一般的な方法はありますか?または、常にgetAttributeValue
などのユーティリティ関数を定義し、この方法でオプションを解析するのは正常ですか?この共通のタスクに対して人々がどのような戦略を持っているかを知りたいです。
また、ボーナスとして、interpolate
パラメーターが必要な理由がわかりません。
compile
関数を使用できます-属性が設定されていない場合は読み取ります-デフォルト値でそれらを埋めます。
.directive('pagination', ['$parse', 'paginationConfig', function($parse, config) {
...
controller: 'PaginationController',
compile: function(element, attrs){
if (!attrs.attrOne) { attrs.attrOne = 'default value'; }
if (!attrs.attrTwo) { attrs.attrTwo = 42; }
},
...
}
});
ディレクティブのスコープブロックのプロパティに=?
フラグを使用します。
angular.module('myApp',[])
.directive('myDirective', function(){
return {
template: 'hello {{name}}',
scope: {
// use the =? to denote the property as optional
name: '=?'
},
controller: function($scope){
// check if it was defined. If not - set a default
$scope.name = angular.isDefined($scope.name) ? $scope.name : 'default name';
}
}
});
私はAngularJS v1.5.10を使用していますが、 preLink
compile function がデフォルトの属性値の設定にかなり適していることがわかりました。
ただのリマインダー:
attrs
は、rawDOM属性値を保持します。これは常にundefined
または文字列です。scope
は、(特に)提供された分離スコープ仕様(=
/<
/@
/など)に従ってDOM属性値parsedを保持します。要約スニペット:
.directive('myCustomToggle', function () {
return {
restrict: 'E',
replace: true,
require: 'ngModel',
transclude: true,
scope: {
ngModel: '=',
ngModelOptions: '<?',
ngTrueValue: '<?',
ngFalseValue: '<?',
},
link: {
pre: function preLink(scope, element, attrs, ctrl) {
// defaults for optional attributes
scope.ngTrueValue = attrs.ngTrueValue !== undefined
? scope.ngTrueValue
: true;
scope.ngFalseValue = attrs.ngFalseValue !== undefined
? scope.ngFalseValue
: false;
scope.ngModelOptions = attrs.ngModelOptions !== undefined
? scope.ngModelOptions
: {};
},
post: function postLink(scope, element, attrs, ctrl) {
...
function updateModel(disable) {
// flip model value
var newValue = disable
? scope.ngFalseValue
: scope.ngTrueValue;
// assign it to the view
ctrl.$setViewValue(newValue);
ctrl.$render();
}
...
},
template: ...
}
});