阿里云新用户优惠

十五、UI-Grid Tooltips 工具提示

· 248 words · 2 minute read
ui-grid
angularjs · ui-grid · ui-grid中文

原文：117 Tooltips

当用户悬停在单元格上时，可以设置工具提示。

在columnDef 中设置 cellTooltip: true 后，此工具可以简单的提示单元格内容。

或者，它可以接收function 返回的当前列和行的值，例如：

cellTooltip: function(row, col) {
    return 'Name: ' + row.entity.name + ' Company: ' + row.entity.company;
  }

或者它可以是一个字符串，在这种情况下，字符串将显示：

cellTooltip: 'Custom tooltip - maybe some help text'

也可以用类似的方法设置一个headerTooltip ，默认是显示的是displayName。

注意，打开工具提示将会为每个单元格创建一个额外的监听，因此对表格整体性能会造成影响，不建议对每一列，比如列有数据但在表格中不显示（如长描述字段）。

Tooltips 优先于cellFilter，所以如果定义了一个cellFilter 也可以用工具提示。

  • index.html
<!doctype html>
<html ng-app="app">
  <head>
    <script src="http://ajax.googleapis.com/ajax/libs/angularjs/1.5.0/angular.js"></script>
    <script src="http://ajax.googleapis.com/ajax/libs/angularjs/1.5.0/angular-touch.js"></script>
    <script src="http://ajax.googleapis.com/ajax/libs/angularjs/1.5.0/angular-animate.js"></script>
    <script src="http://ui-grid.info/docs/grunt-scripts/csv.js"></script>
    <script src="http://ui-grid.info/docs/grunt-scripts/pdfmake.js"></script>
    <script src="http://ui-grid.info/docs/grunt-scripts/vfs_fonts.js"></script>
    <script src="http://ui-grid.info/release/ui-grid.js"></script>
    <script src="http://ui-grid.info/release/ui-grid.css"></script>
    <script src="app.js"></script>
  </head>
  <body>
    <div ng-controller="MainCtrl">
      <br>
      <br>
      <div id="grid1" ui-grid="gridOptions" class="grid"></div>
    </div>
  </body>
</html>
  • main.css
.grid {
  width: 500px;
  height: 200px;
}
.red { color: red;  background-color: yellow !important; }
.blue { color: blue;  }
  • app.js
var app = angular.module('app', ['ngAnimate', 'ngTouch', 'ui.grid']);

app.controller('MainCtrl', ['$scope', '$http', 'uiGridConstants', function ($scope, $http, uiGridConstants) {
  $scope.gridOptions = {
    enableSorting: true,
    columnDefs: [
      { field: 'name', cellTooltip: 'Custom string', headerTooltip: 'Custom header string' },
      { field: 'company', cellTooltip: 
        function( row, col ) {
          return 'Name: ' + row.entity.name + ' Company: ' + row.entity.company;
        }, headerTooltip: 
        function( col ) {
          return 'Header: ' + col.displayName;
        }
      },
      { field: 'gender', cellTooltip: true, headerTooltip: true, cellFilter: 'mapGender' },
    ],
    onRegisterApi: function( gridApi ) {
      $scope.gridApi = gridApi;
      $scope.gridApi.core.on.sortChanged( $scope, function( grid, sort ) {
        $scope.gridApi.core.notifyDataChange( uiGridConstants.dataChange.COLUMN );
      })
    }
  };

  $http.get('http://ui-grid.info/data/100.json')
    .success(function(data) {
      data.forEach( function setGender( row, index ){
        row.gender = row.gender==='male' ? '1' : '2';
      });

      $scope.gridOptions.data = data;
    });
}])
.filter('mapGender', function() {
  var genderHash = {
    1: 'male',
    2: 'female'
  };

  return function(input) {
    if (!input){
      return '';
    } else {
      return genderHash[input];
    }
  };
});

关注微信公众号，与我交流吧~

分享