Enh(grouping)Add events to grouping

 `aggregationChanged` and `groupingChanged events added to the grouping publicApi

Closes #3868

Author: AgDude

misc/tutorial/320_complex_grouping.ngdoc

@@ -96,6 +96,23 @@ children of the selected rowHeader.
               });
             }
           });
+
+          $scope.gridApi.grouping.on.aggregationChanged($scope, function(col){
+            if ( col.treeAggregation.type ){
+              $scope.lastChange = col.displayName + ' aggregated using ' + col.treeAggregation.type;
+            } else {
+              $scope.lastChange = 'Aggregation removed from ' + col.displayName;
+            }
+          });
+
+          $scope.gridApi.grouping.on.groupingChanged($scope, function(col){
+            if ( col.grouping.groupPriority ){
+              $scope.lastChange = col.displayName + ' grouped with priority ' + col.grouping.groupPriority;
+            } else {
+              $scope.lastChange = col.displayName + ' removed from grouped columns';
+            }
+          });
+
         }
       };
 
@@ -255,6 +272,7 @@ children of the selected rowHeader.
 
   <file name="index.html">
     <div ng-controller="MainCtrl">
+      <p ng-show="lastChange">Last grouping change: {{ lastChange }}</p>
       <div id="grid1" ui-grid="gridOptions" ui-grid-grouping ui-grid-edit ui-grid-selection class="grid" style="width:100%;"></div>
     </div>
   </file>

src/features/grouping/js/grouping.js

@@ -157,6 +157,32 @@
         var publicApi = {
           events: {
             grouping: {
+              /**
+               * @ngdoc event
+               * @eventOf ui.grid.grouping.api:PublicApi
+               * @name aggregationChanged
+               * @description raised whenever aggregation is changed, added or removed from a column
+               *
+               * <pre>
+               *      gridApi.grouping.on.aggregationChanged(scope,function(col){})
+               * </pre>
+               * @param {gridCol} col the column which on which aggregation changed. The aggregation
+               * type is available as `col.treeAggregation.type`
+               */
+              aggregationChanged: {},
+              /**
+               * @ngdoc event
+               * @eventOf ui.grid.grouping.api:PublicApi
+               * @name groupingChanged
+               * @description raised whenever the grouped columns changes
+               *
+               * <pre>
+               *      gridApi.grouping.on.groupingChanged(scope,function(col){})
+               * </pre>
+               * @param {gridCol} col the column which on which grouping changed. The new grouping is
+               * available as `col.grouping`
+               */
+              groupingChanged: {}
             }
           },
           methods: {
@@ -652,6 +678,8 @@
         column.treeAggregationFn = uiGridTreeBaseService.nativeAggregations()[uiGridGroupingConstants.aggregation.COUNT].aggregationFn;
         column.treeAggregationFinalizerFn = service.groupedFinalizerFn;
 
+        grid.api.grouping.raise.groupingChanged(column);
+
         grid.queueGridRefresh();
       },
 
@@ -681,6 +709,8 @@
 
         service.tidyPriorities( grid );
 
+        grid.api.grouping.raise.groupingChanged(column);
+
         grid.queueGridRefresh();
       },
 
@@ -712,6 +742,8 @@
         column.treeAggregationFn = aggregationDef.aggregationFn;
         column.treeAggregationFinalizerFn = aggregationDef.finalizerFn;
 
+        grid.api.grouping.raise.aggregationChanged(column);
+
         grid.queueGridRefresh();
       },