feat: #387 - Configuration of default directive behaviour

config/grunt/concat.js

@@ -30,6 +30,7 @@ module.exports = function () {
       files: {
         '<%= paths.dist %>/<%= pkg.name %>.js': [
           '<%= paths.src %>/permission/permission.js',
+          '<%= paths.src %>/permission/permissionConfig.js',
           '<%= paths.src %>/permission/decorators/$q.js',
           '<%= paths.src %>/permission/strategies/PermissionStrategies.js',
           '<%= paths.src %>/permission/transition/TransitionProperties.js',

src/permission/directives/permission.js

@@ -64,7 +64,7 @@ function PermissionDirective($log, $injector, PermPermissionMap, PermPermissionS
       onUnauthorized: '&?permissionOnUnauthorized'
     },
     controllerAs: 'permission',
-    controller: function ($scope, $element) {
+    controller: function ($scope, $element, permissionConfig) {
       var permission = this;
 
       $scope.$watchGroup(['permission.only', 'permission.except', 'sref'],
@@ -118,7 +118,8 @@ function PermissionDirective($log, $injector, PermPermissionMap, PermPermissionS
         if (angular.isFunction(permission.onAuthorized)) {
           permission.onAuthorized()($element);
         } else {
-          PermPermissionStrategies.showElement($element);
+          var onAuthorizedMethodName = permissionConfig.defaultOnAuthorizedMethod;
+          PermPermissionStrategies[onAuthorizedMethodName]($element);
         }
       }
 
@@ -130,7 +131,8 @@ function PermissionDirective($log, $injector, PermPermissionMap, PermPermissionS
         if (angular.isFunction(permission.onUnauthorized)) {
           permission.onUnauthorized()($element);
         } else {
-          PermPermissionStrategies.hideElement($element);
+          var onUnauthorizedMethodName = permissionConfig.defaultOnUnauthorizedMethod;
+          PermPermissionStrategies[onUnauthorizedMethodName]($element);
         }
       }
     }

src/permission/permission.js

@@ -6,6 +6,7 @@
 
 var permission = angular.module('permission', []);
 
+/* istanbul ignore if  */
 if (typeof module !== 'undefined' && typeof exports !== 'undefined' && module.exports === exports) {
   module.exports = permission.name;
 }

src/permission/permissionConfig.js

@@ -0,0 +1,39 @@
+'use strict';
+
+/**
+ * Permission module configuration provider
+ *
+ * @name permission.permissionConfigProvider
+ */
+function permissionConfig() {
+  'ngInject';
+
+  this.defaultOnAuthorizedMethod = 'showElement';
+  this.defaultOnUnauthorizedMethod = 'hideElement';
+
+  /**
+   * Methods allowing to alter default directive onAuthorized behaviour in permission directive
+   *
+   * @param onAuthorizedMethod {String} One of permission.PermPermissionStrategies method names
+   */
+  this.setDefaultOnAuthorizedMethod = function (onAuthorizedMethod) {
+    this.defaultOnAuthorizedMethod = onAuthorizedMethod;
+  };
+
+  /**
+   * Methods allowing to alter default directive onUnauthorized behaviour in permission directive
+   *
+   * @param onUnauthorizedMethod {String} One of permission.PermPermissionStrategies method names
+   */
+  this.setDefaultOnUnauthorizedMethod = function (onUnauthorizedMethod) {
+    this.defaultOnUnauthorizedMethod = onUnauthorizedMethod;
+  };
+
+  this.$get = function () {
+    return this;
+  }
+}
+
+angular
+  .module('permission')
+  .provider('permissionConfig', permissionConfig);

test/unit/permission/configuration/permissionConfig.test.js

@@ -0,0 +1,61 @@
+describe('permission', function () {
+  'use strict';
+
+  describe('configuration', function () {
+    describe('provider: permissionConfig', function () {
+      var permissionConfigProvider;
+
+      beforeEach(function () {
+        module('permission');
+      });
+
+      beforeEach(function () {
+        module(['permissionConfigProvider', function (_permissionConfigProvider) {
+          permissionConfigProvider = _permissionConfigProvider;
+        }]);
+      });
+
+      beforeEach(inject());
+
+      describe('method: setDefaultOnAuthorizedMethod', function () {
+        it('should have default authorized method set to showElement', function () {
+          // GIVEN
+          // WHEN
+          //THEN
+          expect(permissionConfigProvider.$get().defaultOnAuthorizedMethod).toBe('showElement');
+        });
+
+        it('should set custom default authorized method when provided', function () {
+          // GIVEN
+          var onAuthorizedMethodName = 'customOnAuthorizedMethod';
+
+          // WHEN
+          permissionConfigProvider.setDefaultOnAuthorizedMethod(onAuthorizedMethodName);
+
+          //THEN
+          expect(permissionConfigProvider.$get().defaultOnAuthorizedMethod).toBe(onAuthorizedMethodName);
+        });
+      });
+
+      describe('method: setDefaultOnUnauthorizedMethod', function () {
+        it('should have default unauthorized method set to hideElement', function () {
+          // GIVEN
+          // WHEN
+          //THEN
+          expect(permissionConfigProvider.$get().defaultOnUnauthorizedMethod).toBe('hideElement');
+        });
+
+        it('should set custom default unauthorized method when provided', function () {
+          // GIVEN
+          var onUnauthorizedMethodName = 'customOnUnauthorizedMethod';
+
+          // WHEN
+          permissionConfigProvider.setDefaultOnUnauthorizedMethod(onUnauthorizedMethodName);
+
+          //defaultOnUnauthorizedMethod
+          expect(permissionConfigProvider.$get().defaultOnUnauthorizedMethod).toBe(onUnauthorizedMethodName);
+        });
+      });
+    });
+  });
+});