\n * gridApi.cellNav.on.navigate(scope,function(newRowcol, oldRowCol) {})\n * \n * @param {object} newRowCol new position\n * @param {object} oldRowCol old position\n */\n navigate: function (newRowCol, oldRowCol) {},\n /**\n * @ngdoc event\n * @name viewPortKeyDown\n * @eventOf ui.grid.cellNav.api:PublicApi\n * @description is raised when the viewPort receives a keyDown event. Cells never get focus in uiGrid\n * due to the difficulties of setting focus on a cell that is not visible in the viewport. Use this\n * event whenever you need a keydown event on a cell\n * \n * .ui-grid-column-menu-button {\n * display: block;\n * }\n * \n */\n /**\n * @ngdoc property\n * @name enableColumnMenus\n * @propertyOf ui.grid.class:GridOptions.columnDef\n * @description Override for column menus everywhere - if set to false then you get no\n * column menus. Defaults to true.\n *\n */\n\n $scope.offAllEvents();\n\n if ($scope.sortable || $scope.colMenu) {\n $scope.onDownEvents();\n\n $scope.$on('$destroy', function () {\n $scope.offAllEvents();\n });\n }\n };\n\n updateHeaderOptions();\n\n if ($scope.col.filterContainer === 'columnMenu' && $scope.col.filterable) {\n $rootScope.$on('menu-shown', function() {\n $scope.$applyAsync(function () {\n setFilter($scope.col.filterable);\n });\n });\n }\n\n // Register a data change watch that would get triggered whenever someone edits a cell or modifies column defs\n var dataChangeDereg = $scope.grid.registerDataChangeCallback( updateHeaderOptions, [uiGridConstants.dataChange.COLUMN]);\n\n $scope.$on( '$destroy', dataChangeDereg );\n\n $scope.handleClick = function(event) {\n // If the shift key is being held down, add this column to the sort\n // Sort this column then rebuild the grid's rows\n uiGridCtrl.grid.sortColumn($scope.col, event.shiftKey)\n .then(function () {\n if (uiGridCtrl.columnMenuScope) { uiGridCtrl.columnMenuScope.hideMenu(); }\n uiGridCtrl.grid.refresh();\n }).catch(angular.noop);\n };\n\n $scope.headerCellArrowKeyDown = function(event) {\n if (event.keyCode === uiGridConstants.keymap.SPACE || event.keyCode === uiGridConstants.keymap.ENTER) {\n event.preventDefault();\n $scope.toggleMenu(event);\n }\n };\n\n $scope.toggleMenu = function(event) {\n event.stopPropagation();\n\n // If the menu is already showing and we're the column the menu is on\n if (uiGridCtrl.columnMenuScope.menuShown && uiGridCtrl.columnMenuScope.col === $scope.col) {\n // ... hide it\n uiGridCtrl.columnMenuScope.hideMenu();\n }\n // If the menu is NOT showing or is showing in a different column\n else {\n // ... show it on our column\n uiGridCtrl.columnMenuScope.showMenu($scope.col, $elm);\n }\n };\n }\n };\n }\n };\n }]);\n})();\n\n(function() {\n 'use strict';\n\n angular.module('ui.grid').directive('uiGridHeader', ['$templateCache', '$compile', 'uiGridConstants', 'gridUtil', '$timeout', 'ScrollEvent',\n function($templateCache, $compile, uiGridConstants, gridUtil, $timeout, ScrollEvent) {\n var defaultTemplate = 'ui-grid/ui-grid-header',\n emptyTemplate = 'ui-grid/ui-grid-no-header';\n\n return {\n restrict: 'EA',\n replace: true,\n require: ['^uiGrid', '^uiGridRenderContainer'],\n scope: true,\n compile: function() {\n return {\n pre: function ($scope, $elm, $attrs, controllers) {\n var uiGridCtrl = controllers[0],\n containerCtrl = controllers[1];\n\n $scope.grid = uiGridCtrl.grid;\n $scope.colContainer = containerCtrl.colContainer;\n\n updateHeaderReferences();\n\n var headerTemplate;\n if (!$scope.grid.options.showHeader) {\n headerTemplate = emptyTemplate;\n }\n else {\n headerTemplate = ($scope.grid.options.headerTemplate) ? $scope.grid.options.headerTemplate : defaultTemplate;\n }\n\n gridUtil.getTemplate(headerTemplate)\n .then(function (contents) {\n var template = angular.element(contents);\n\n var newElm = $compile(template)($scope);\n $elm.replaceWith(newElm);\n\n // And update $elm to be the new element\n $elm = newElm;\n\n updateHeaderReferences();\n\n if (containerCtrl) {\n // Inject a reference to the header viewport (if it exists) into the grid controller for use in the horizontal scroll handler below\n var headerViewport = $elm[0].getElementsByClassName('ui-grid-header-viewport')[0];\n\n\n if (headerViewport) {\n containerCtrl.headerViewport = headerViewport;\n angular.element(headerViewport).on('scroll', scrollHandler);\n $scope.$on('$destroy', function () {\n angular.element(headerViewport).off('scroll', scrollHandler);\n });\n }\n }\n\n $scope.grid.queueRefresh();\n }).catch(angular.noop);\n\n function updateHeaderReferences() {\n containerCtrl.header = containerCtrl.colContainer.header = $elm;\n\n var headerCanvases = $elm[0].getElementsByClassName('ui-grid-header-canvas');\n\n if (headerCanvases.length > 0) {\n containerCtrl.headerCanvas = containerCtrl.colContainer.headerCanvas = headerCanvases[0];\n }\n else {\n containerCtrl.headerCanvas = null;\n }\n }\n\n function scrollHandler() {\n if (uiGridCtrl.grid.isScrollingHorizontally) {\n return;\n }\n var newScrollLeft = gridUtil.normalizeScrollLeft(containerCtrl.headerViewport, uiGridCtrl.grid);\n var horizScrollPercentage = containerCtrl.colContainer.scrollHorizontal(newScrollLeft);\n\n var scrollEvent = new ScrollEvent(uiGridCtrl.grid, null, containerCtrl.colContainer, ScrollEvent.Sources.ViewPortScroll);\n scrollEvent.newScrollLeft = newScrollLeft;\n if ( horizScrollPercentage > -1 ) {\n scrollEvent.x = { percentage: horizScrollPercentage };\n }\n\n uiGridCtrl.grid.scrollContainers(null, scrollEvent);\n }\n },\n\n post: function ($scope, $elm, $attrs, controllers) {\n var uiGridCtrl = controllers[0];\n var containerCtrl = controllers[1];\n\n // gridUtil.logDebug('ui-grid-header link');\n\n var grid = uiGridCtrl.grid;\n\n // Don't animate header cells\n gridUtil.disableAnimations($elm);\n\n function updateColumnWidths() {\n // this styleBuilder always runs after the renderContainer, so we can rely on the column widths\n // already being populated correctly\n\n var columnCache = containerCtrl.colContainer.visibleColumnCache;\n\n // Build the CSS\n // uiGridCtrl.grid.columns.forEach(function (column) {\n var ret = '';\n var canvasWidth = 0;\n columnCache.forEach(function (column) {\n ret = ret + column.getColClassDefinition();\n canvasWidth += column.drawnWidth;\n });\n\n containerCtrl.colContainer.canvasWidth = canvasWidth;\n\n // Return the styles back to buildStyles which pops them into the `customStyles` scope variable\n return ret;\n }\n\n containerCtrl.header = $elm;\n\n var headerViewport = $elm[0].getElementsByClassName('ui-grid-header-viewport')[0];\n if (headerViewport) {\n containerCtrl.headerViewport = headerViewport;\n }\n\n // todo: remove this if by injecting gridCtrl into unit tests\n if (uiGridCtrl) {\n uiGridCtrl.grid.registerStyleComputation({\n priority: 15,\n func: updateColumnWidths\n });\n }\n }\n };\n }\n };\n }]);\n})();\n\n(function() {\n\nangular.module('ui.grid')\n.service('uiGridGridMenuService', [ 'gridUtil', 'i18nService', 'uiGridConstants', function( gridUtil, i18nService, uiGridConstants ) {\n /**\n * @ngdoc service\n * @name ui.grid.uiGridGridMenuService\n *\n * @description Methods for working with the grid menu\n */\n\n var service = {\n /**\n * @ngdoc method\n * @methodOf ui.grid.uiGridGridMenuService\n * @name initialize\n * @description Sets up the gridMenu. Most importantly, sets our\n * scope onto the grid object as grid.gridMenuScope, allowing us\n * to operate when passed only the grid. Second most importantly,\n * we register the 'addToGridMenu' and 'removeFromGridMenu' methods\n * on the core api.\n * @param {$scope} $scope the scope of this gridMenu\n * @param {Grid} grid the grid to which this gridMenu is associated\n */\n initialize: function( $scope, grid ) {\n grid.gridMenuScope = $scope;\n $scope.grid = grid;\n $scope.registeredMenuItems = [];\n\n // not certain this is needed, but would be bad to create a memory leak\n $scope.$on('$destroy', function() {\n if ( $scope.grid && $scope.grid.gridMenuScope ) {\n $scope.grid.gridMenuScope = null;\n }\n if ( $scope.grid ) {\n $scope.grid = null;\n }\n if ( $scope.registeredMenuItems ) {\n $scope.registeredMenuItems = null;\n }\n });\n\n $scope.registeredMenuItems = [];\n\n /**\n * @ngdoc function\n * @name addToGridMenu\n * @methodOf ui.grid.api:PublicApi\n * @description add items to the grid menu. Used by features\n * to add their menu items if they are enabled, can also be used by\n * end users to add menu items. This method has the advantage of allowing\n * remove again, which can simplify management of which items are included\n * in the menu when. (Noting that in most cases the shown and active functions\n * provide a better way to handle visibility of menu items)\n * @param {Grid} grid the grid on which we are acting\n * @param {array} items menu items in the format as described in the tutorial, with\n * the added note that if you want to use remove you must also specify an `id` field,\n * which is provided when you want to remove an item. The id should be unique.\n *\n */\n grid.api.registerMethod( 'core', 'addToGridMenu', service.addToGridMenu );\n\n /**\n * @ngdoc function\n * @name removeFromGridMenu\n * @methodOf ui.grid.api:PublicApi\n * @description Remove an item from the grid menu based on a provided id. Assumes\n * that the id is unique, removes only the last instance of that id. Does nothing if\n * the specified id is not found\n * @param {Grid} grid the grid on which we are acting\n * @param {string} id the id we'd like to remove from the menu\n *\n */\n grid.api.registerMethod( 'core', 'removeFromGridMenu', service.removeFromGridMenu );\n },\n\n\n /**\n * @ngdoc function\n * @name addToGridMenu\n * @propertyOf ui.grid.uiGridGridMenuService\n * @description add items to the grid menu. Used by features\n * to add their menu items if they are enabled, can also be used by\n * end users to add menu items. This method has the advantage of allowing\n * remove again, which can simplify management of which items are included\n * in the menu when. (Noting that in most cases the shown and active functions\n * provide a better way to handle visibility of menu items)\n * @param {Grid} grid the grid on which we are acting\n * @param {array} menuItems menu items in the format as described in the tutorial, with\n * the added note that if you want to use remove you must also specify an `id` field,\n * which is provided when you want to remove an item. The id should be unique.\n *\n */\n addToGridMenu: function( grid, menuItems ) {\n if ( !angular.isArray( menuItems ) ) {\n gridUtil.logError( 'addToGridMenu: menuItems must be an array, and is not, not adding any items');\n } else {\n if ( grid.gridMenuScope ) {\n grid.gridMenuScope.registeredMenuItems = grid.gridMenuScope.registeredMenuItems ? grid.gridMenuScope.registeredMenuItems : [];\n grid.gridMenuScope.registeredMenuItems = grid.gridMenuScope.registeredMenuItems.concat( menuItems );\n } else {\n gridUtil.logError( 'Asked to addToGridMenu, but gridMenuScope not present. Timing issue? Please log issue with ui-grid');\n }\n }\n },\n\n\n /**\n * @ngdoc function\n * @name removeFromGridMenu\n * @methodOf ui.grid.uiGridGridMenuService\n * @description Remove an item from the grid menu based on a provided id. Assumes\n * that the id is unique, removes only the last instance of that id. Does nothing if\n * the specified id is not found. If there is no gridMenuScope or registeredMenuItems\n * then do nothing silently - the desired result is those menu items not be present and they\n * aren't.\n * @param {Grid} grid the grid on which we are acting\n * @param {string} id the id we'd like to remove from the menu\n *\n */\n removeFromGridMenu: function( grid, id ) {\n var foundIndex = -1;\n\n if ( grid && grid.gridMenuScope ) {\n grid.gridMenuScope.registeredMenuItems.forEach( function( value, index ) {\n if ( value.id === id ) {\n if (foundIndex > -1) {\n gridUtil.logError( 'removeFromGridMenu: found multiple items with the same id, removing only the last' );\n } else {\n\n foundIndex = index;\n }\n }\n });\n }\n\n if ( foundIndex > -1 ) {\n grid.gridMenuScope.registeredMenuItems.splice( foundIndex, 1 );\n }\n },\n\n\n /**\n * @ngdoc array\n * @name gridMenuCustomItems\n * @propertyOf ui.grid.class:GridOptions\n * @description (optional) An array of menu items that should be added to\n * the gridMenu. Follow the format documented in the tutorial for column\n * menu customisation. The context provided to the action function will\n * include context.grid. An alternative if working with dynamic menus is to use the\n * provided api - core.addToGridMenu and core.removeFromGridMenu, which handles\n * some of the management of items for you.\n *\n */\n /**\n * @ngdoc boolean\n * @name gridMenuShowHideColumns\n * @propertyOf ui.grid.class:GridOptions\n * @description true by default, whether the grid menu should allow hide/show\n * of columns\n *\n */\n /**\n * @ngdoc method\n * @methodOf ui.grid.uiGridGridMenuService\n * @name getMenuItems\n * @description Decides the menu items to show in the menu. This is a\n * combination of:\n *\n * - the default menu items that are always included,\n * - any menu items that have been provided through the addMenuItem api. These\n * are typically added by features within the grid\n * - any menu items included in grid.options.gridMenuCustomItems. These can be\n * changed dynamically, as they're always recalculated whenever we show the\n * menu\n * @param {$scope} $scope the scope of this gridMenu, from which we can find all\n * the information that we need\n * @returns {Array} an array of menu items that can be shown\n */\n getMenuItems: function( $scope ) {\n var menuItems = [\n // this is where we add any menu items we want to always include\n ];\n\n if ( $scope.grid.options.gridMenuCustomItems ) {\n if ( !angular.isArray( $scope.grid.options.gridMenuCustomItems ) ) {\n gridUtil.logError( 'gridOptions.gridMenuCustomItems must be an array, and is not');\n } else {\n menuItems = menuItems.concat( $scope.grid.options.gridMenuCustomItems );\n }\n }\n\n var clearFilters = [{\n title: i18nService.getSafeText('gridMenu.clearAllFilters'),\n action: function ($event) {\n $scope.grid.clearAllFilters();\n },\n shown: function() {\n return $scope.grid.options.enableFiltering;\n },\n order: 100\n }];\n menuItems = menuItems.concat( clearFilters );\n\n menuItems = menuItems.concat( $scope.registeredMenuItems );\n\n if ( $scope.grid.options.gridMenuShowHideColumns !== false ) {\n menuItems = menuItems.concat( service.showHideColumns( $scope ) );\n }\n\n menuItems.sort(function(a, b) {\n return a.order - b.order;\n });\n\n return menuItems;\n },\n\n\n /**\n * @ngdoc array\n * @name gridMenuTitleFilter\n * @propertyOf ui.grid.class:GridOptions\n * @description (optional) A function that takes a title string\n * (usually the col.displayName), and converts it into a display value. The function\n * must return either a string or a promise.\n *\n * Used for internationalization of the grid menu column names - for angular-translate\n * you can pass $translate as the function, for i18nService you can pass getSafeText as the\n * function\n * @example\n * \n * gridOptions = {\n * gridMenuTitleFilter: $translate\n * }\n * \n */\n /**\n * @ngdoc method\n * @methodOf ui.grid.uiGridGridMenuService\n * @name showHideColumns\n * @description Adds two menu items for each of the columns in columnDefs. One\n * menu item for hide, one menu item for show. Each is visible when appropriate\n * (show when column is not visible, hide when column is visible). Each toggles\n * the visible property on the columnDef using toggleColumnVisibility\n * @param {$scope} $scope of a gridMenu, which contains a reference to the grid\n */\n showHideColumns: function( $scope ) {\n var showHideColumns = [];\n if ( !$scope.grid.options.columnDefs || $scope.grid.options.columnDefs.length === 0 || $scope.grid.columns.length === 0 ) {\n return showHideColumns;\n }\n\n function isColumnVisible(colDef) {\n return colDef.visible === true || colDef.visible === undefined;\n }\n\n function getColumnIcon(colDef) {\n return isColumnVisible(colDef) ? 'ui-grid-icon-ok' : 'ui-grid-icon-cancel';\n }\n\n $scope.grid.options.gridMenuTitleFilter = $scope.grid.options.gridMenuTitleFilter ? $scope.grid.options.gridMenuTitleFilter : function( title ) { return title; };\n\n $scope.grid.options.columnDefs.forEach( function( colDef, index ) {\n if ( $scope.grid.options.enableHiding !== false && colDef.enableHiding !== false || colDef.enableHiding ) {\n // add hide menu item - shows an OK icon as we only show when column is already visible\n var menuItem = {\n icon: getColumnIcon(colDef),\n action: function($event) {\n $event.stopPropagation();\n\n service.toggleColumnVisibility( this.context.gridCol );\n\n if ($event.target && $event.target.firstChild) {\n if (angular.element($event.target)[0].nodeName === 'I') {\n $event.target.className = getColumnIcon(this.context.gridCol.colDef);\n }\n else {\n $event.target.firstChild.className = getColumnIcon(this.context.gridCol.colDef);\n }\n }\n },\n shown: function() {\n return this.context.gridCol.colDef.enableHiding !== false;\n },\n context: { gridCol: $scope.grid.getColumn(colDef.name || colDef.field) },\n leaveOpen: true,\n order: 301 + index\n };\n service.setMenuItemTitle( menuItem, colDef, $scope.grid );\n showHideColumns.push( menuItem );\n }\n });\n\n // add header for columns\n if ( showHideColumns.length ) {\n showHideColumns.unshift({\n title: i18nService.getSafeText('gridMenu.columns'),\n order: 300,\n templateUrl: 'ui-grid/ui-grid-menu-header-item'\n });\n }\n\n return showHideColumns;\n },\n\n\n /**\n * @ngdoc method\n * @methodOf ui.grid.uiGridGridMenuService\n * @name setMenuItemTitle\n * @description Handles the response from gridMenuTitleFilter, adding it directly to the menu\n * item if it returns a string, otherwise waiting for the promise to resolve or reject then\n * putting the result into the title\n * @param {object} menuItem the menuItem we want to put the title on\n * @param {object} colDef the colDef from which we can get displayName, name or field\n * @param {Grid} grid the grid, from which we can get the options.gridMenuTitleFilter\n *\n */\n setMenuItemTitle: function( menuItem, colDef, grid ) {\n var title = grid.options.gridMenuTitleFilter( colDef.displayName || gridUtil.readableColumnName(colDef.name) || colDef.field );\n\n if ( typeof(title) === 'string' ) {\n menuItem.title = title;\n } else if ( title.then ) {\n // must be a promise\n menuItem.title = \"\";\n title.then( function( successValue ) {\n menuItem.title = successValue;\n }, function( errorValue ) {\n menuItem.title = errorValue;\n }).catch(angular.noop);\n } else {\n gridUtil.logError('Expected gridMenuTitleFilter to return a string or a promise, it has returned neither, bad config');\n menuItem.title = 'badconfig';\n }\n },\n\n /**\n * @ngdoc method\n * @methodOf ui.grid.uiGridGridMenuService\n * @name toggleColumnVisibility\n * @description Toggles the visibility of an individual column. Expects to be\n * provided a context that has on it a gridColumn, which is the column that\n * we'll operate upon. We change the visibility, and refresh the grid as appropriate\n * @param {GridColumn} gridCol the column that we want to toggle\n *\n */\n toggleColumnVisibility: function( gridCol ) {\n gridCol.colDef.visible = !( gridCol.colDef.visible === true || gridCol.colDef.visible === undefined );\n\n gridCol.grid.refresh();\n gridCol.grid.api.core.notifyDataChange( uiGridConstants.dataChange.COLUMN );\n gridCol.grid.api.core.raise.columnVisibilityChanged( gridCol );\n }\n };\n\n return service;\n}])\n\n.directive('uiGridMenuButton', ['gridUtil', 'uiGridConstants', 'uiGridGridMenuService', 'i18nService',\nfunction (gridUtil, uiGridConstants, uiGridGridMenuService, i18nService) {\n\n return {\n priority: 0,\n scope: true,\n require: ['^uiGrid'],\n templateUrl: 'ui-grid/ui-grid-menu-button',\n replace: true,\n\n link: function ($scope, $elm, $attrs, controllers) {\n var uiGridCtrl = controllers[0];\n\n // For the aria label\n $scope.i18n = {\n aria: i18nService.getSafeText('gridMenu.aria')\n };\n\n uiGridGridMenuService.initialize($scope, uiGridCtrl.grid);\n\n $scope.shown = false;\n\n $scope.toggleOnKeydown = function(event) {\n if (\n event.keyCode === uiGridConstants.keymap.ENTER ||\n event.keyCode === uiGridConstants.keymap.SPACE ||\n (event.keyCode === uiGridConstants.keymap.ESC && $scope.shown)\n ) {\n $scope.toggleMenu();\n }\n };\n\n $scope.toggleMenu = function () {\n if ( $scope.shown ) {\n $scope.$broadcast('hide-menu');\n $scope.shown = false;\n } else {\n $scope.menuItems = uiGridGridMenuService.getMenuItems( $scope );\n $scope.$broadcast('show-menu');\n $scope.shown = true;\n }\n };\n\n $scope.$on('menu-hidden', function() {\n $scope.shown = false;\n gridUtil.focus.bySelector($elm, '.ui-grid-icon-container');\n });\n }\n };\n}]);\n})();\n\n(function() {\n\n/**\n * @ngdoc directive\n * @name ui.grid.directive:uiGridMenu\n * @element style\n * @restrict A\n *\n * @description\n * Allows us to interpolate expressions in `\n I am in a box.\n \n \n \n * $scope.gridOptions = {\n * customScroller: function myScrolling(uiGridViewport, scrollHandler) {\n * uiGridViewport.on('scroll', function myScrollingOverride(event) {\n * // Do something here\n *\n * scrollHandler(event);\n * });\n * }\n * };\n * \n * @param {object} uiGridViewport Element being scrolled. (this gets passed in by the grid).\n * @param {function} scrollHandler Function that needs to be called when scrolling happens. (this gets passed in by the grid).\n */\n if (grid && grid.options && grid.options.customScroller) {\n grid.options.customScroller($elm, scrollHandler);\n } else {\n $elm.on('scroll', scrollHandler);\n }\n\n var ignoreScroll = false;\n\n function scrollHandler() {\n var newScrollTop = $elm[0].scrollTop;\n var newScrollLeft = gridUtil.normalizeScrollLeft($elm, grid);\n\n var vertScrollPercentage = rowContainer.scrollVertical(newScrollTop);\n var horizScrollPercentage = colContainer.scrollHorizontal(newScrollLeft);\n\n var scrollEvent = new ScrollEvent(grid, rowContainer, colContainer, ScrollEvent.Sources.ViewPortScroll);\n scrollEvent.newScrollLeft = newScrollLeft;\n scrollEvent.newScrollTop = newScrollTop;\n if ( horizScrollPercentage > -1 ) {\n scrollEvent.x = { percentage: horizScrollPercentage };\n }\n\n if ( vertScrollPercentage > -1 ) {\n scrollEvent.y = { percentage: vertScrollPercentage };\n }\n\n grid.scrollContainers($scope.$parent.containerId, scrollEvent);\n }\n\n if ($scope.$parent.bindScrollVertical) {\n grid.addVerticalScrollSync($scope.$parent.containerId, syncVerticalScroll);\n }\n\n if ($scope.$parent.bindScrollHorizontal) {\n grid.addHorizontalScrollSync($scope.$parent.containerId, syncHorizontalScroll);\n grid.addHorizontalScrollSync($scope.$parent.containerId + 'header', syncHorizontalHeader);\n grid.addHorizontalScrollSync($scope.$parent.containerId + 'footer', syncHorizontalFooter);\n }\n\n function syncVerticalScroll(scrollEvent) {\n containerCtrl.prevScrollArgs = scrollEvent;\n $elm[0].scrollTop = scrollEvent.getNewScrollTop(rowContainer,containerCtrl.viewport);\n }\n\n function syncHorizontalScroll(scrollEvent) {\n containerCtrl.prevScrollArgs = scrollEvent;\n var newScrollLeft = scrollEvent.getNewScrollLeft(colContainer, containerCtrl.viewport);\n\n $elm[0].scrollLeft = gridUtil.denormalizeScrollLeft(containerCtrl.viewport,newScrollLeft, grid);\n }\n\n function syncHorizontalHeader(scrollEvent) {\n var newScrollLeft = scrollEvent.getNewScrollLeft(colContainer, containerCtrl.viewport);\n\n if (containerCtrl.headerViewport) {\n containerCtrl.headerViewport.scrollLeft = gridUtil.denormalizeScrollLeft(containerCtrl.viewport,newScrollLeft, grid);\n }\n }\n\n function syncHorizontalFooter(scrollEvent) {\n var newScrollLeft = scrollEvent.getNewScrollLeft(colContainer, containerCtrl.viewport);\n\n if (containerCtrl.footerViewport) {\n containerCtrl.footerViewport.scrollLeft = gridUtil.denormalizeScrollLeft(containerCtrl.viewport,newScrollLeft, grid);\n }\n }\n\n $scope.$on('$destroy', function unbindEvents() {\n $elm.off();\n });\n },\n controller: ['$scope', function ($scope) {\n this.rowStyle = function () {\n var rowContainer = $scope.rowContainer;\n var colContainer = $scope.colContainer;\n\n var styles = {};\n\n if (rowContainer.currentTopRow !== 0) {\n // top offset based on hidden rows count\n var translateY = \"translateY(\"+ (rowContainer.currentTopRow * rowContainer.grid.options.rowHeight) +\"px)\";\n\n styles['transform'] = translateY;\n styles['-webkit-transform'] = translateY;\n styles['-ms-transform'] = translateY;\n }\n\n if (colContainer.currentFirstColumn !== 0) {\n if (colContainer.grid.isRTL()) {\n styles['margin-right'] = colContainer.columnOffset + 'px';\n }\n else {\n styles['margin-left'] = colContainer.columnOffset + 'px';\n }\n }\n\n return styles;\n };\n }]\n };\n }\n ]);\n\n})();\n\n(function() {\n\tangular.module('ui.grid')\n\t\t.directive('uiGridVisible', function uiGridVisibleAction() {\n\t\t\treturn function($scope, $elm, $attr) {\n\t\t\t\t$scope.$watch($attr.uiGridVisible, function(visible) {\n\t\t\t\t\t$elm[visible ? 'removeClass' : 'addClass']('ui-grid-invisible');\n\t\t\t\t});\n\t\t\t};\n\t\t});\n})();\n\n(function () {\n 'use strict';\n\n angular.module('ui.grid').controller('uiGridController', ['$scope', '$element', '$attrs', 'gridUtil', '$q', 'uiGridConstants',\n 'gridClassFactory', '$parse', '$compile',\n function ($scope, $elm, $attrs, gridUtil, $q, uiGridConstants,\n gridClassFactory, $parse, $compile) {\n // gridUtil.logDebug('ui-grid controller');\n var self = this;\n var deregFunctions = [];\n\n self.grid = gridClassFactory.createGrid($scope.uiGrid);\n\n // assign $scope.$parent if appScope not already assigned\n self.grid.appScope = self.grid.appScope || $scope.$parent;\n\n $elm.addClass('grid' + self.grid.id);\n self.grid.rtl = gridUtil.getStyles($elm[0])['direction'] === 'rtl';\n\n\n // angular.extend(self.grid.options, );\n\n // all properties of grid are available on scope\n $scope.grid = self.grid;\n\n if ($attrs.uiGridColumns) {\n deregFunctions.push( $attrs.$observe('uiGridColumns', function(value) {\n self.grid.options.columnDefs = angular.isString(value) ? angular.fromJson(value) : value;\n self.grid.buildColumns()\n .then(function() {\n self.grid.preCompileCellTemplates();\n\n self.grid.refreshCanvas(true);\n }).catch(angular.noop);\n }) );\n }\n\n // prevents an error from being thrown when the array is not defined yet and fastWatch is on\n function getSize(array) {\n return array ? array.length : 0;\n }\n\n // if fastWatch is set we watch only the length and the reference, not every individual object\n if (self.grid.options.fastWatch) {\n self.uiGrid = $scope.uiGrid;\n if (angular.isString($scope.uiGrid.data)) {\n deregFunctions.push( $scope.$parent.$watch($scope.uiGrid.data, dataWatchFunction) );\n deregFunctions.push( $scope.$parent.$watch(function() {\n if ( self.grid.appScope[$scope.uiGrid.data] ) {\n return self.grid.appScope[$scope.uiGrid.data].length;\n } else {\n return undefined;\n }\n }, dataWatchFunction) );\n } else {\n deregFunctions.push( $scope.$parent.$watch(function() { return $scope.uiGrid.data; }, dataWatchFunction) );\n deregFunctions.push( $scope.$parent.$watch(function() { return getSize($scope.uiGrid.data); }, function() { dataWatchFunction($scope.uiGrid.data); }) );\n }\n deregFunctions.push( $scope.$parent.$watch(function() { return $scope.uiGrid.columnDefs; }, columnDefsWatchFunction) );\n deregFunctions.push( $scope.$parent.$watch(function() { return getSize($scope.uiGrid.columnDefs); }, function() { columnDefsWatchFunction($scope.uiGrid.columnDefs); }) );\n } else {\n if (angular.isString($scope.uiGrid.data)) {\n deregFunctions.push( $scope.$parent.$watchCollection($scope.uiGrid.data, dataWatchFunction) );\n } else {\n deregFunctions.push( $scope.$parent.$watchCollection(function() { return $scope.uiGrid.data; }, dataWatchFunction) );\n }\n deregFunctions.push( $scope.$parent.$watchCollection(function() { return $scope.uiGrid.columnDefs; }, columnDefsWatchFunction) );\n }\n\n\n function columnDefsWatchFunction(n, o) {\n if (n && n !== o) {\n self.grid.options.columnDefs = $scope.uiGrid.columnDefs;\n self.grid.callDataChangeCallbacks(uiGridConstants.dataChange.COLUMN, {\n orderByColumnDefs: true,\n preCompileCellTemplates: true\n });\n }\n }\n\n var mostRecentData;\n\n function dataWatchFunction(newData) {\n // gridUtil.logDebug('dataWatch fired');\n var promises = [];\n\n if ( self.grid.options.fastWatch ) {\n if (angular.isString($scope.uiGrid.data)) {\n newData = self.grid.appScope.$eval($scope.uiGrid.data);\n } else {\n newData = $scope.uiGrid.data;\n }\n }\n\n mostRecentData = newData;\n\n if (newData) {\n // columns length is greater than the number of row header columns, which don't count because they're created automatically\n var hasColumns = self.grid.columns.length > (self.grid.rowHeaderColumns ? self.grid.rowHeaderColumns.length : 0);\n\n if (\n // If we have no columns\n !hasColumns &&\n // ... and we don't have a ui-grid-columns attribute, which would define columns for us\n !$attrs.uiGridColumns &&\n // ... and we have no pre-defined columns\n self.grid.options.columnDefs.length === 0 &&\n // ... but we DO have data\n newData.length > 0\n ) {\n // ... then build the column definitions from the data that we have\n self.grid.buildColumnDefsFromData(newData);\n }\n\n // If we haven't built columns before and either have some columns defined or some data defined\n if (!hasColumns && (self.grid.options.columnDefs.length > 0 || newData.length > 0)) {\n // Build the column set, then pre-compile the column cell templates\n promises.push(self.grid.buildColumns()\n .then(function() {\n self.grid.preCompileCellTemplates();\n }).catch(angular.noop));\n }\n\n $q.all(promises).then(function() {\n // use most recent data, rather than the potentially outdated data passed into watcher handler\n self.grid.modifyRows(mostRecentData)\n .then(function () {\n // if (self.viewport) {\n self.grid.redrawInPlace(true);\n // }\n\n $scope.$evalAsync(function() {\n self.grid.refreshCanvas(true);\n self.grid.callDataChangeCallbacks(uiGridConstants.dataChange.ROW);\n });\n }).catch(angular.noop);\n }).catch(angular.noop);\n }\n }\n\n var styleWatchDereg = $scope.$watch(function () { return self.grid.styleComputations; }, function() {\n self.grid.refreshCanvas(true);\n });\n\n $scope.$on('$destroy', function() {\n deregFunctions.forEach( function( deregFn ) { deregFn(); });\n styleWatchDereg();\n });\n\n self.fireEvent = function(eventName, args) {\n args = args || {};\n\n // Add the grid to the event arguments if it's not there\n if (angular.isUndefined(args.grid)) {\n args.grid = self.grid;\n }\n\n $scope.$broadcast(eventName, args);\n };\n\n self.innerCompile = function innerCompile(elm) {\n $compile(elm)($scope);\n };\n }]);\n\n/**\n * @ngdoc directive\n * @name ui.grid.directive:uiGrid\n * @element div\n * @restrict EA\n * @param {Object} uiGrid Options for the grid to use\n *\n * @description Create a very basic grid.\n *\n * @example\n \n * mySortFn = function(a, b) {\n * var nulls = $scope.gridApi.core.sortHandleNulls(a, b);\n * if ( nulls !== null ) {\n * return nulls;\n * } else {\n * // your code for sorting here\n * };\n * \n * @param {object} a sort value a\n * @param {object} b sort value b\n * @returns {number} null if there were no nulls/undefineds, otherwise returns\n * a sort value that should be passed back from the sort function\n *\n */\n self.api.registerMethod( 'core', 'sortHandleNulls', rowSorter.handleNulls );\n\n /**\n * @ngdoc function\n * @name sortChanged\n * @methodOf ui.grid.api:PublicApi\n * @description The sort criteria on one or more columns has\n * changed. Provides as parameters the grid and the output of\n * getColumnSorting, which is an array of gridColumns\n * that have sorting on them, sorted in priority order.\n *\n * @param {$scope} scope The scope of the controller. This is used to deregister this event when the scope is destroyed.\n * @param {Function} callBack Will be called when the event is emited. The function passes back the grid and an array of\n * columns with sorts on them, in priority order.\n *\n * @example\n * \n * gridApi.core.on.sortChanged( $scope, function(grid, sortColumns) {\n * // do something\n * });\n * \n */\n self.api.registerEvent( 'core', 'sortChanged' );\n\n /**\n * @ngdoc function\n * @name columnVisibilityChanged\n * @methodOf ui.grid.api:PublicApi\n * @description The visibility of a column has changed,\n * the column itself is passed out as a parameter of the event.\n *\n * @param {$scope} scope The scope of the controller. This is used to deregister this event when the scope is destroyed.\n * @param {Function} callBack Will be called when the event is emited. The function passes back the GridCol that has changed.\n *\n * @example\n * \n * gridApi.core.on.columnVisibilityChanged( $scope, function (column) {\n * // do something\n * } );\n * \n */\n self.api.registerEvent( 'core', 'columnVisibilityChanged' );\n\n /**\n * @ngdoc method\n * @name notifyDataChange\n * @methodOf ui.grid.api:PublicApi\n * @description Notify the grid that a data or config change has occurred,\n * where that change isn't something the grid was otherwise noticing. This\n * might be particularly relevant where you've changed values within the data\n * and you'd like cell classes to be re-evaluated, or changed config within\n * the columnDef and you'd like headerCellClasses to be re-evaluated.\n * @param {string} type one of the\n * {@link ui.grid.service:uiGridConstants#properties_dataChange uiGridConstants.dataChange}\n * values (ALL, ROW, EDIT, COLUMN, OPTIONS), which tells us which refreshes to fire.\n *\n * - ALL: listeners fired on any of these events, fires listeners on all events.\n * - ROW: fired when a row is added or removed.\n * - EDIT: fired when the data in a cell is edited.\n * - COLUMN: fired when the column definitions are modified.\n * - OPTIONS: fired when the grid options are modified.\n */\n self.api.registerMethod( 'core', 'notifyDataChange', this.notifyDataChange );\n\n /**\n * @ngdoc method\n * @name clearAllFilters\n * @methodOf ui.grid.api:PublicApi\n * @description Clears all filters and optionally refreshes the visible rows.\n * @param {object} refreshRows Defaults to true.\n * @param {object} clearConditions Defaults to false.\n * @param {object} clearFlags Defaults to false.\n * @returns {promise} If `refreshRows` is true, returns a promise of the rows refreshing.\n */\n self.api.registerMethod('core', 'clearAllFilters', this.clearAllFilters);\n\n self.registerDataChangeCallback( self.columnRefreshCallback, [uiGridConstants.dataChange.COLUMN]);\n self.registerDataChangeCallback( self.processRowsCallback, [uiGridConstants.dataChange.EDIT]);\n self.registerDataChangeCallback( self.updateFooterHeightCallback, [uiGridConstants.dataChange.OPTIONS]);\n\n self.registerStyleComputation({\n priority: 10,\n func: self.getFooterStyles\n });\n };\n\n Grid.prototype.calcFooterHeight = function () {\n if (!this.hasFooter()) {\n return 0;\n }\n\n var height = 0;\n if (this.options.showGridFooter) {\n height += this.options.gridFooterHeight;\n }\n\n height += this.calcColumnFooterHeight();\n\n return height;\n };\n\n Grid.prototype.calcColumnFooterHeight = function () {\n var height = 0;\n\n if (this.options.showColumnFooter) {\n height += this.options.columnFooterHeight;\n }\n\n return height;\n };\n\n Grid.prototype.getFooterStyles = function () {\n var style = '.grid' + this.id + ' .ui-grid-footer-aggregates-row { height: ' + this.options.columnFooterHeight + 'px; }';\n style += ' .grid' + this.id + ' .ui-grid-footer-info { height: ' + this.options.gridFooterHeight + 'px; }';\n return style;\n };\n\n Grid.prototype.hasFooter = function () {\n return this.options.showGridFooter || this.options.showColumnFooter;\n };\n\n /**\n * @ngdoc function\n * @name isRTL\n * @methodOf ui.grid.class:Grid\n * @description Returns true if grid is RightToLeft\n */\n Grid.prototype.isRTL = function () {\n return this.rtl;\n };\n\n\n /**\n * @ngdoc function\n * @name registerColumnBuilder\n * @methodOf ui.grid.class:Grid\n * @description When the build creates columns from column definitions, the columnbuilders will be called to add\n * additional properties to the column.\n * @param {function(colDef, col, gridOptions)} columnBuilder function to be called\n */\n Grid.prototype.registerColumnBuilder = function registerColumnBuilder(columnBuilder) {\n this.columnBuilders.push(columnBuilder);\n };\n\n /**\n * @ngdoc function\n * @name buildColumnDefsFromData\n * @methodOf ui.grid.class:Grid\n * @description Populates columnDefs from the provided data\n * @param {function(colDef, col, gridOptions)} rowBuilder function to be called\n */\n Grid.prototype.buildColumnDefsFromData = function (dataRows) {\n this.options.columnDefs = gridUtil.getColumnsFromData(dataRows, this.options.excludeProperties);\n };\n\n /**\n * @ngdoc function\n * @name registerRowBuilder\n * @methodOf ui.grid.class:Grid\n * @description When the build creates rows from gridOptions.data, the rowBuilders will be called to add\n * additional properties to the row.\n * @param {function(row, gridOptions)} rowBuilder function to be called\n */\n Grid.prototype.registerRowBuilder = function registerRowBuilder(rowBuilder) {\n this.rowBuilders.push(rowBuilder);\n };\n\n /**\n * @ngdoc function\n * @name registerDataChangeCallback\n * @methodOf ui.grid.class:Grid\n * @description When a data change occurs, the data change callbacks of the specified type\n * will be called. The rules are:\n *\n * - when the data watch fires, that is considered a ROW change (the data watch only notices\n * added or removed rows)\n * - when the api is called to inform us of a change, the declared type of that change is used\n * - when a cell edit completes, the EDIT callbacks are triggered\n * - when the columnDef watch fires, the COLUMN callbacks are triggered\n * - when the options watch fires, the OPTIONS callbacks are triggered\n *\n * For a given event:\n * - ALL calls ROW, EDIT, COLUMN, OPTIONS and ALL callbacks\n * - ROW calls ROW and ALL callbacks\n * - EDIT calls EDIT and ALL callbacks\n * - COLUMN calls COLUMN and ALL callbacks\n * - OPTIONS calls OPTIONS and ALL callbacks\n *\n * @param {function(grid)} callback function to be called\n * @param {array} types the types of data change you want to be informed of. Values from\n * the {@link ui.grid.service:uiGridConstants#properties_dataChange uiGridConstants.dataChange}\n * values ( ALL, EDIT, ROW, COLUMN, OPTIONS ). Optional and defaults to ALL\n * @returns {function} deregister function - a function that can be called to deregister this callback\n */\n Grid.prototype.registerDataChangeCallback = function registerDataChangeCallback(callback, types, _this) {\n var self = this,\n uid = gridUtil.nextUid();\n\n if ( !types ) {\n types = [uiGridConstants.dataChange.ALL];\n }\n if ( !Array.isArray(types)) {\n gridUtil.logError(\"Expected types to be an array or null in registerDataChangeCallback, value passed was: \" + types );\n }\n this.dataChangeCallbacks[uid] = { callback: callback, types: types, _this: _this };\n\n return function() {\n delete self.dataChangeCallbacks[uid];\n };\n };\n\n /**\n * @ngdoc function\n * @name callDataChangeCallbacks\n * @methodOf ui.grid.class:Grid\n * @description Calls the callbacks based on the type of data change that\n * has occurred. Always calls the ALL callbacks, calls the ROW, EDIT, COLUMN and OPTIONS callbacks if the\n * event type is matching, or if the type is ALL.\n * @param {string} type the type of event that occurred - one of the\n * {@link ui.grid.service:uiGridConstants#properties_dataChange uiGridConstants.dataChange}\n * values (ALL, ROW, EDIT, COLUMN, OPTIONS)\n */\n Grid.prototype.callDataChangeCallbacks = function callDataChangeCallbacks(type, options) {\n angular.forEach( this.dataChangeCallbacks, function( callback, uid ) {\n if ( callback.types.indexOf( uiGridConstants.dataChange.ALL ) !== -1 ||\n callback.types.indexOf( type ) !== -1 ||\n type === uiGridConstants.dataChange.ALL ) {\n if (callback._this) {\n callback.callback.apply(callback._this, this, options);\n }\n else {\n callback.callback(this, options);\n }\n }\n }, this);\n };\n\n /**\n * @ngdoc function\n * @name notifyDataChange\n * @methodOf ui.grid.class:Grid\n * @description Notifies us that a data change has occurred, used in the public\n * api for users to tell us when they've changed data or some other event that\n * our watches cannot pick up\n * @param {string} type the type of event that occurred - one of the\n * uiGridConstants.dataChange values (ALL, ROW, EDIT, COLUMN, OPTIONS)\n *\n * - ALL: listeners fired on any of these events, fires listeners on all events.\n * - ROW: fired when a row is added or removed.\n * - EDIT: fired when the data in a cell is edited.\n * - COLUMN: fired when the column definitions are modified.\n * - OPTIONS: fired when the grid options are modified.\n */\n Grid.prototype.notifyDataChange = function notifyDataChange(type) {\n var constants = uiGridConstants.dataChange;\n\n if ( type === constants.ALL ||\n type === constants.COLUMN ||\n type === constants.EDIT ||\n type === constants.ROW ||\n type === constants.OPTIONS ) {\n this.callDataChangeCallbacks( type );\n }\n else {\n gridUtil.logError(\"Notified of a data change, but the type was not recognised, so no action taken, type was: \" + type);\n }\n };\n\n /**\n * @ngdoc function\n * @name columnRefreshCallback\n * @methodOf ui.grid.class:Grid\n * @description refreshes the grid when a column refresh\n * is notified, which triggers handling of the visible flag.\n * This is called on uiGridConstants.dataChange.COLUMN, and is\n * registered as a dataChangeCallback in grid.js\n * @param {object} grid The grid object.\n * @param {object} options Any options passed into the callback.\n */\n Grid.prototype.columnRefreshCallback = function columnRefreshCallback(grid, options) {\n grid.buildColumns(options);\n grid.queueGridRefresh();\n };\n\n /**\n * @ngdoc function\n * @name processRowsCallback\n * @methodOf ui.grid.class:Grid\n * @description calls the row processors, specifically\n * intended to reset the sorting when an edit is called,\n * registered as a dataChangeCallback on uiGridConstants.dataChange.EDIT\n * @param {object} grid The grid object.\n */\n Grid.prototype.processRowsCallback = function processRowsCallback( grid ) {\n grid.queueGridRefresh();\n };\n\n\n /**\n * @ngdoc function\n * @name updateFooterHeightCallback\n * @methodOf ui.grid.class:Grid\n * @description recalculates the footer height,\n * registered as a dataChangeCallback on uiGridConstants.dataChange.OPTIONS\n * @param {object} grid The grid object.\n */\n Grid.prototype.updateFooterHeightCallback = function updateFooterHeightCallback( grid ) {\n grid.footerHeight = grid.calcFooterHeight();\n grid.columnFooterHeight = grid.calcColumnFooterHeight();\n };\n\n\n /**\n * @ngdoc function\n * @name getColumn\n * @methodOf ui.grid.class:Grid\n * @description returns a grid column for the column name\n * @param {string} name column name\n */\n Grid.prototype.getColumn = function getColumn(name) {\n return rowColumnFinder(this.columns, function (column) {\n return column.colDef.name === name;\n });\n };\n\n /**\n * @ngdoc function\n * @name getColDef\n * @methodOf ui.grid.class:Grid\n * @description returns a grid colDef for the column name\n * @param {string} name column.field\n */\n Grid.prototype.getColDef = function getColDef(name) {\n return rowColumnFinder(this.options.columnDefs, function (colDef) {\n return colDef.name === name;\n });\n };\n\n /**\n * @ngdoc function\n * @name assignTypes\n * @methodOf ui.grid.class:Grid\n * @description uses the first row of data to assign colDef.type for any types not defined.\n */\n /**\n * @ngdoc property\n * @name type\n * @propertyOf ui.grid.class:GridOptions.columnDef\n * @description the type of the column, used in sorting. If not provided then the\n * grid will guess the type. Add this only if the grid guessing is not to your\n * satisfaction. One of:\n * - 'string'\n * - 'boolean'\n * - 'number'\n * - 'date'\n * - 'object'\n * - 'numberStr'\n * Note that if you choose date, your dates should be in a javascript date type\n *\n */\n Grid.prototype.assignTypes = function() {\n var self = this;\n\n self.options.columnDefs.forEach(function (colDef, index) {\n // Assign colDef type if not specified\n if (!colDef.type) {\n var col = new GridColumn(colDef, index, self);\n var firstRow = self.rows.length > 0 ? self.rows[0] : null;\n if (firstRow) {\n colDef.type = gridUtil.guessType(self.getCellValue(firstRow, col));\n }\n else {\n colDef.type = 'string';\n }\n }\n });\n };\n\n\n /**\n * @ngdoc function\n * @name isRowHeaderColumn\n * @methodOf ui.grid.class:Grid\n * @description returns true if the column is a row Header\n * @param {object} column column\n */\n Grid.prototype.isRowHeaderColumn = function isRowHeaderColumn(column) {\n return this.rowHeaderColumns.indexOf(column) !== -1;\n };\n\n /**\n * @ngdoc function\n * @name addRowHeaderColumn\n * @methodOf ui.grid.class:Grid\n * @description adds a row header column to the grid\n * @param {object} colDef Column definition object.\n * @param {float} order Number that indicates where the column should be placed in the grid.\n * @param {boolean} stopColumnBuild Prevents the buildColumn callback from being triggered. This is useful to improve\n * performance of the grid during initial load.\n */\n Grid.prototype.addRowHeaderColumn = function addRowHeaderColumn(colDef, order, stopColumnBuild) {\n var self = this;\n\n // default order\n if (order === undefined) {\n order = 0;\n }\n\n var rowHeaderCol = new GridColumn(colDef, gridUtil.nextUid(), self);\n rowHeaderCol.isRowHeader = true;\n if (self.isRTL()) {\n self.createRightContainer();\n rowHeaderCol.renderContainer = 'right';\n }\n else {\n self.createLeftContainer();\n rowHeaderCol.renderContainer = 'left';\n }\n\n // relies on the default column builder being first in array, as it is instantiated\n // as part of grid creation\n self.columnBuilders[0](colDef,rowHeaderCol,self.options)\n .then(function() {\n rowHeaderCol.enableFiltering = false;\n rowHeaderCol.enableSorting = false;\n rowHeaderCol.enableHiding = false;\n rowHeaderCol.headerPriority = order;\n self.rowHeaderColumns.push(rowHeaderCol);\n self.rowHeaderColumns = self.rowHeaderColumns.sort(function (a, b) {\n return a.headerPriority - b.headerPriority;\n });\n\n if (!stopColumnBuild) {\n self.buildColumns()\n .then(function() {\n self.preCompileCellTemplates();\n self.queueGridRefresh();\n }).catch(angular.noop);\n }\n }).catch(angular.noop);\n };\n\n /**\n * @ngdoc function\n * @name getOnlyDataColumns\n * @methodOf ui.grid.class:Grid\n * @description returns all columns except for rowHeader columns\n */\n Grid.prototype.getOnlyDataColumns = function getOnlyDataColumns() {\n var self = this,\n cols = [];\n\n self.columns.forEach(function (col) {\n if (self.rowHeaderColumns.indexOf(col) === -1) {\n cols.push(col);\n }\n });\n return cols;\n };\n\n /**\n * @ngdoc function\n * @name buildColumns\n * @methodOf ui.grid.class:Grid\n * @description creates GridColumn objects from the columnDefinition. Calls each registered\n * columnBuilder to further process the column\n * @param {object} opts An object contains options to use when building columns\n *\n * * **orderByColumnDefs**: defaults to **false**. When true, `buildColumns` will reorder existing columns according to the order within the column definitions.\n *\n * @returns {Promise} a promise to load any needed column resources\n */\n Grid.prototype.buildColumns = function buildColumns(opts) {\n var options = {\n orderByColumnDefs: false\n };\n\n angular.extend(options, opts);\n\n // gridUtil.logDebug('buildColumns');\n var self = this;\n var builderPromises = [];\n var headerOffset = self.rowHeaderColumns.length;\n var i;\n\n // Remove any columns for which a columnDef cannot be found\n // Deliberately don't use forEach, as it doesn't like splice being called in the middle\n // Also don't cache columns.length, as it will change during this operation\n for (i = 0; i < self.columns.length; i++) {\n if (!self.getColDef(self.columns[i].name)) {\n self.columns.splice(i, 1);\n i--;\n }\n }\n\n // add row header columns to the grid columns array _after_ columns without columnDefs have been removed\n // rowHeaderColumns is ordered by priority so insert in reverse\n for (var j = self.rowHeaderColumns.length - 1; j >= 0; j--) {\n self.columns.unshift(self.rowHeaderColumns[j]);\n }\n\n // look at each column def, and update column properties to match. If the column def\n // doesn't have a column, then splice in a new gridCol\n self.options.columnDefs.forEach(function (colDef, index) {\n self.preprocessColDef(colDef);\n var col = self.getColumn(colDef.name);\n\n if (!col) {\n col = new GridColumn(colDef, gridUtil.nextUid(), self);\n self.columns.splice(index + headerOffset, 0, col);\n }\n else {\n // tell updateColumnDef that the column was pre-existing\n col.updateColumnDef(colDef, false);\n }\n\n self.columnBuilders.forEach(function (builder) {\n builderPromises.push(builder.call(self, colDef, col, self.options));\n });\n });\n\n /*** Reorder columns if necessary ***/\n if (!!options.orderByColumnDefs) {\n // Create a shallow copy of the columns as a cache\n var columnCache = self.columns.slice(0);\n\n // We need to allow for the \"row headers\" when mapping from the column defs array to the columns array\n // If we have a row header in columns[0] and don't account for it we'll overwrite it with the column in columnDefs[0]\n\n // Go through all the column defs, use the shorter of columns length and colDefs.length because if a user has given two columns the same name then\n // columns will be shorter than columnDefs. In this situation we'll avoid an error, but the user will still get an unexpected result\n var len = Math.min(self.options.columnDefs.length, self.columns.length);\n for (i = 0; i < len; i++) {\n // If the column at this index has a different name than the column at the same index in the column defs...\n if (self.columns[i + headerOffset].name !== self.options.columnDefs[i].name) {\n // Replace the one in the cache with the appropriate column\n columnCache[i + headerOffset] = self.getColumn(self.options.columnDefs[i].name);\n }\n else {\n // Otherwise just copy over the one from the initial columns\n columnCache[i + headerOffset] = self.columns[i + headerOffset];\n }\n }\n\n // Empty out the columns array, non-destructively\n self.columns.length = 0;\n\n // And splice in the updated, ordered columns from the cache\n Array.prototype.splice.apply(self.columns, [0, 0].concat(columnCache));\n }\n\n return $q.all(builderPromises).then(function() {\n if (self.rows.length > 0) {\n self.assignTypes();\n }\n if (options.preCompileCellTemplates) {\n self.preCompileCellTemplates();\n }\n }).catch(angular.noop);\n };\n\n Grid.prototype.preCompileCellTemplate = function(col) {\n var self = this;\n var html = col.cellTemplate.replace(uiGridConstants.MODEL_COL_FIELD, self.getQualifiedColField(col));\n html = html.replace(uiGridConstants.COL_FIELD, 'grid.getCellValue(row, col)');\n\n col.compiledElementFn = $compile(html);\n\n if (col.compiledElementFnDefer) {\n col.compiledElementFnDefer.resolve(col.compiledElementFn);\n }\n };\n\n/**\n * @ngdoc function\n * @name preCompileCellTemplates\n * @methodOf ui.grid.class:Grid\n * @description precompiles all cell templates\n */\n Grid.prototype.preCompileCellTemplates = function() {\n var self = this;\n self.columns.forEach(function (col) {\n if ( col.cellTemplate ) {\n self.preCompileCellTemplate( col );\n } else if ( col.cellTemplatePromise ) {\n col.cellTemplatePromise.then( function() {\n self.preCompileCellTemplate( col );\n }).catch(angular.noop);\n }\n });\n };\n\n /**\n * @ngdoc function\n * @name getGridQualifiedColField\n * @methodOf ui.grid.class:Grid\n * @description Returns the $parse-able accessor for a column within its $scope\n * @param {GridColumn} col col object\n */\n Grid.prototype.getQualifiedColField = function (col) {\n var base = 'row.entity';\n if ( col.field === uiGridConstants.ENTITY_BINDING ) {\n return base;\n }\n return gridUtil.preEval(base + '.' + col.field);\n };\n\n /**\n * @ngdoc function\n * @name createLeftContainer\n * @methodOf ui.grid.class:Grid\n * @description creates the left render container if it doesn't already exist\n */\n Grid.prototype.createLeftContainer = function() {\n if (!this.hasLeftContainer()) {\n this.renderContainers.left = new GridRenderContainer('left', this, { disableColumnOffset: true });\n }\n };\n\n /**\n * @ngdoc function\n * @name createRightContainer\n * @methodOf ui.grid.class:Grid\n * @description creates the right render container if it doesn't already exist\n */\n Grid.prototype.createRightContainer = function() {\n if (!this.hasRightContainer()) {\n this.renderContainers.right = new GridRenderContainer('right', this, { disableColumnOffset: true });\n }\n };\n\n /**\n * @ngdoc function\n * @name hasLeftContainer\n * @methodOf ui.grid.class:Grid\n * @description returns true if leftContainer exists\n */\n Grid.prototype.hasLeftContainer = function() {\n return this.renderContainers.left !== undefined;\n };\n\n /**\n * @ngdoc function\n * @name hasRightContainer\n * @methodOf ui.grid.class:Grid\n * @description returns true if rightContainer exists\n */\n Grid.prototype.hasRightContainer = function() {\n return this.renderContainers.right !== undefined;\n };\n\n\n /**\n * undocumented function\n * @name preprocessColDef\n * @methodOf ui.grid.class:Grid\n * @description defaults the name property from field to maintain backwards compatibility with 2.x\n * validates that name or field is present\n */\n Grid.prototype.preprocessColDef = function preprocessColDef(colDef) {\n var self = this;\n\n if (!colDef.field && !colDef.name) {\n throw new Error('colDef.name or colDef.field property is required');\n }\n\n // maintain backwards compatibility with 2.x\n // field was required in 2.x. now name is required\n if (colDef.name === undefined && colDef.field !== undefined) {\n // See if the column name already exists:\n var newName = colDef.field,\n counter = 2;\n while (self.getColumn(newName)) {\n newName = colDef.field + counter.toString();\n counter++;\n }\n colDef.name = newName;\n }\n };\n\n // Return a list of items that exist in the `n` array but not the `o` array. Uses optional property accessors passed as third & fourth parameters\n Grid.prototype.newInN = function newInN(o, n, oAccessor, nAccessor) {\n var self = this;\n\n var t = [];\n for (var i = 0; i < n.length; i++) {\n var nV = nAccessor ? n[i][nAccessor] : n[i];\n\n var found = false;\n for (var j = 0; j < o.length; j++) {\n var oV = oAccessor ? o[j][oAccessor] : o[j];\n if (self.options.rowEquality(nV, oV)) {\n found = true;\n break;\n }\n }\n if (!found) {\n t.push(nV);\n }\n }\n\n return t;\n };\n\n var rowColumnFinder = function(array, func) {\n if (array && array.length) {\n if (angular.isFunction(array.find)) {\n return array.find(func) || null;\n }\n\n var result = null;\n array.every(function (entry) {\n if (func(entry)) {\n result = entry;\n return false;\n }\n return true;\n });\n return result;\n }\n return null;\n }\n\n /**\n * @ngdoc function\n * @name getRow\n * @methodOf ui.grid.class:Grid\n * @description returns the GridRow that contains the rowEntity\n * @param {object} rowEntity the gridOptions.data array element instance\n * @param {array} lookInRows [optional] the rows to look in - if not provided then\n * looks in grid.rows\n */\n Grid.prototype.getRow = function getRow(rowEntity, lookInRows) {\n var self = this;\n lookInRows = lookInRows == void 0 ? this.rows : lookInRows;\n return rowColumnFinder(lookInRows, function (row) {\n return self.options.rowEquality(row.entity, rowEntity);\n });\n };\n\n /**\n * @ngdoc function\n * @name getRowsByKey\n * @methodOf ui.grid.class:Grid\n * @description returns the GridRows who have an key that is equal to comparator\n * @param {boolean} isInEntity if true then key is in entity else it's directly in row\n * @param {(string|number)} key the key to look for\n * @param {any} comparator the value that key should have\n * @param {array} lookInRows [optional] the rows to look in - if not provided then\n * looks in grid.rows\n */\n Grid.prototype.getRowsByKey = function getRowsByKey(isInEntity, key, comparator, lookInRows) {\n if ( key == void 0 ) {\n return null;\n }\n\n lookInRows = lookInRows == void 0 ? this.rows : lookInRows;\n var func = isInEntity ? function (row) {\n return row.entity != void 0 && row.entity.hasOwnProperty(key) && row.entity[key] === comparator;\n } : function (row) {\n return row.hasOwnProperty(key) && row[key] === comparator;\n }\n\n return lookInRows.filter(func);\n };\n\n /**\n * @ngdoc function\n * @name findRowByKey\n * @methodOf ui.grid.class:Grid\n * @description returns the first GridRow which has an key that is equal to comparator\n * @param {boolean} isInEntity if true then key is in entity else it's directly in row\n * @param {(string|number)} key the key to look for\n * @param {any} comparator the value that key should have\n * @param {array} lookInRows [optional] the rows to look in - if not provided then\n * looks in grid.rows\n */\n Grid.prototype.findRowByKey = function findRowByKey(isInEntity, key, comparator, lookInRows) {\n var result = null;\n if ( key != void 0 ) {\n lookInRows = lookInRows == void 0 ? this.rows : lookInRows;\n var func = isInEntity ? function (row) {\n if ( row.entity != void 0 && row.entity.hasOwnProperty(key) && row.entity[key] === comparator ) {\n result = row;\n return false;\n }\n return true;\n } : function (row) {\n if ( row.hasOwnProperty(key) && row[key] === comparator ) {\n result = row;\n return false;\n }\n return true;\n }\n\n lookInRows.every(func);\n }\n return result\n };\n\n /**\n * @ngdoc function\n * @name modifyRows\n * @methodOf ui.grid.class:Grid\n * @description creates or removes GridRow objects from the newRawData array. Calls each registered\n * rowBuilder to further process the row\n * @param {array} newRawData Modified set of data\n *\n * This method aims to achieve three things:\n * 1. the resulting rows array is in the same order as the newRawData, we'll call\n * rowsProcessors immediately after to sort the data anyway\n * 2. if we have row hashing available, we try to use the rowHash to find the row\n * 3. no memory leaks - rows that are no longer in newRawData need to be garbage collected\n *\n * The basic logic flow makes use of the newRawData, oldRows and oldHash, and creates\n * the newRows and newHash\n *\n * ```\n * newRawData.forEach newEntity\n * if (hashing enabled)\n * check oldHash for newEntity\n * else\n * look for old row directly in oldRows\n * if !oldRowFound // must be a new row\n * create newRow\n * append to the newRows and add to newHash\n * run the processors\n * ```\n *\n * Rows are identified using the hashKey if configured. If not configured, then rows\n * are identified using the gridOptions.rowEquality function\n *\n * This method is useful when trying to select rows immediately after loading data without\n * using a $timeout/$interval, e.g.:\n *\n * $scope.gridOptions.data = someData;\n * $scope.gridApi.grid.modifyRows($scope.gridOptions.data);\n * $scope.gridApi.selection.selectRow($scope.gridOptions.data[0]);\n *\n * OR to persist row selection after data update (e.g. rows selected, new data loaded, want\n * originally selected rows to be re-selected))\n */\n Grid.prototype.modifyRows = function modifyRows(newRawData) {\n var self = this;\n var oldRows = self.rows.slice(0);\n var oldRowHash = self.rowHashMap || self.createRowHashMap();\n var allRowsSelected = true;\n self.rowHashMap = self.createRowHashMap();\n self.rows.length = 0;\n\n newRawData.forEach( function( newEntity, i ) {\n var newRow, oldRow;\n\n if ( self.options.enableRowHashing ) {\n // if hashing is enabled, then this row will be in the hash if we already know about it\n oldRow = oldRowHash.get( newEntity );\n } else {\n // otherwise, manually search the oldRows to see if we can find this row\n oldRow = self.getRow(newEntity, oldRows);\n }\n\n // update newRow to have an entity\n if ( oldRow ) {\n newRow = oldRow;\n newRow.entity = newEntity;\n }\n\n // if we didn't find the row, it must be new, so create it\n if ( !newRow ) {\n newRow = self.processRowBuilders(new GridRow(newEntity, i, self));\n }\n\n self.rows.push( newRow );\n self.rowHashMap.put( newEntity, newRow );\n if (!newRow.isSelected) {\n allRowsSelected = false;\n }\n });\n\n if (self.selection && self.rows.length) {\n self.selection.selectAll = allRowsSelected;\n }\n\n self.assignTypes();\n\n var p1 = $q.when(self.processRowsProcessors(self.rows))\n .then(function (renderableRows) {\n return self.setVisibleRows(renderableRows);\n }).catch(angular.noop);\n\n var p2 = $q.when(self.processColumnsProcessors(self.columns))\n .then(function (renderableColumns) {\n return self.setVisibleColumns(renderableColumns);\n }).catch(angular.noop);\n\n return $q.all([p1, p2]);\n };\n\n\n /**\n * Private Undocumented Method\n * @name addRows\n * @methodOf ui.grid.class:Grid\n * @description adds the newRawData array of rows to the grid and calls all registered\n * rowBuilders. this keyword will reference the grid\n */\n Grid.prototype.addRows = function addRows(newRawData) {\n var self = this,\n existingRowCount = self.rows.length;\n\n for (var i = 0; i < newRawData.length; i++) {\n var newRow = self.processRowBuilders(new GridRow(newRawData[i], i + existingRowCount, self));\n\n if (self.options.enableRowHashing) {\n var found = self.rowHashMap.get(newRow.entity);\n if (found) {\n found.row = newRow;\n }\n }\n\n self.rows.push(newRow);\n }\n };\n\n /**\n * @ngdoc function\n * @name processRowBuilders\n * @methodOf ui.grid.class:Grid\n * @description processes all RowBuilders for the gridRow\n * @param {GridRow} gridRow reference to gridRow\n * @returns {GridRow} the gridRow with all additional behavior added\n */\n Grid.prototype.processRowBuilders = function processRowBuilders(gridRow) {\n var self = this;\n\n self.rowBuilders.forEach(function (builder) {\n builder.call(self, gridRow, self.options);\n });\n\n return gridRow;\n };\n\n /**\n * @ngdoc function\n * @name registerStyleComputation\n * @methodOf ui.grid.class:Grid\n * @description registered a styleComputation function\n *\n * If the function returns a value it will be appended into the grid's `