ExtJS Grid Tooltip提示

本文总结了ExtJS Grid Tooltip的几种实现方法。ExtJS Grid Tooltip可以通过表头提示，单元格提示，行提示以及自己手动添加等方式完成。本文参考了官方FAQ上提供的描述。

ExtJS Grid Tooltip实现之一：表头提示

在2.2里面是设置ColumnModel.tooltip ,3.0则是Column. tooltip 如下:

 var grid = new Ext.grid.GridPanel({
   columns:[
     {header:'名称',dataIndex:'name',tooltip:'对象名称'},
     {header:'开始时间 - 结束时间 < br/>成功/失败/成功率', dataIndex:'sucRate',tooltip:'成功/失败/成功率'}
   ]
 });

ExtJS Grid Tooltip实现之二：单元格提示

1)使用Ext.QuickTips

在开始的时候就执行Ext.QuickTips.init();

然后对需要提示的单元格,重写renderer函数,添加ext:qtitle , ext:qtip这2个属性即可。

这个在官方的FAQ上有详细描述: http://extjs.com/learn/Ext_FAQ_Grid#Add_ToolTip_or_Qtip

 //option 1
 //========

renderer = function (data, metadata, record, rowIndex, columnIndex, store) {    

     //build the qtip:
     var title = 'Details for ' + value + '-' + record.get('month') +
         '-' + record.get('year');
     var tip = record.get('sunday_events');

     metadata.attr = 'ext:qtitle="' + title + '"' + ' ext:qtip="' + tip + '"';

     //return the display text:
     var displayText = '< span style="color: #000;">' + value + '< /span>< br />' +
         record.get('sunday_events_short');
     return displayText;
 };

 //option 2
 //========
 renderer = function (data, metadata, record, rowIndex, columnIndex, store) {
     var qtip = '>';
     if(data >= 0){
         qtip = " qtip='yeah'/>";
         return '< span style="color:green;"' + qtip + data + '%< /span>';
     }else if(data <  0){
         qtip = " qtip='woops'/>";
         return '< span style="color:red;"' + qtip + data + '%< /span>';
     }
     return data;
 };

 //option 3
 //========
 var qtipTpl = new Ext.XTemplate(
     '< h3>Phones:< /h3>',
     '< tpl for=".">',
     '< div>< i>{phoneType}:< /i> {phoneNumber}< /div>',
     '< /tpl>'
 );

 renderer = function (data, metadata, record, rowIndex, columnIndex, store) {

     // get data
     var data = record.data;

     // convert phones to array (only once)
     data.phones = Ext.isArray(data.phones) ?
         data.phones :
         this.getPhones(data.phones);

     // create tooltip
     var qtip = qtipTpl.apply(data.phones);

     metadata.attr = 'ext:qtitle="' + title + '"' + ' ext:qtip="' + tip + '"';

     //return the display text:
     return data;
 };

2)使用ToolTip

官方也已经给出方法:

http://extjs.com/forum/showthread.php?p=112125#post112125

http://extjs.com/forum/showthread.php?t=55690

以上给出的方法是可以让一个grid里面的元素共享一个tooltip对象。一般用来做rowtip

不过3.0有更好的方式,如下:

ExtJS Grid Tooltip实现之三：行提示 RowTip

ExtJS3.0新增的方法,设置tooltip的delegate

 var myGrid = new Ext.grid.gridPanel(gridConfig);
 myGrid.on('render', function(grid) {
     var store = grid.getStore();  // Capture the Store.

    var view = grid.getView();    // Capture the GridView.    

     myGrid.tip = new Ext.ToolTip({
         target: view.mainBody,    // The overall target element.

         delegate: '.x-grid3-row', // Each grid row causes its own seperate show and hide.

         trackMouse: true,         // Moving within the row should not hide the tip.

         renderTo: document.body,  // Render immediately so that tip.body can be referenced prior to the first show.

         listeners: {              // Change content dynamically depending on which element triggered the show.

             beforeshow: function updateTipBody(tip) {
                   var rowIndex = view.findRowIndex(tip.triggerElement);                     if(!Ext.isEmpty(content)){                        tip.body.dom.innerHTML = "提示信息";                    }else{                        return false; //停止执行，从而禁止显示Tip                        tip.destroy();                    }
             }
         }
     });
 });