/*
 * jQuery tableHover plugin
 * Version: 0.1.4
 *
 * Copyright (c) 2007 Roman Weich
 * http://p.sohei.org
 *
 * Dual licensed under the MIT and GPL licenses 
 * (This means that you can choose the license that best suits your project, and use it accordingly):
 *   http://www.opensource.org/licenses/mit-license.php
 *   http://www.gnu.org/licenses/gpl.html
 *
 * Changelog: 
 * v 0.1.4 - 2007-12-17
 *  - fix: clicking on a link or child element inside a cell did not set the clickClass on the rows/columns.
 * v 0.1.3 - 2007-09-04
 *  - fix: highlight did not work when the hovered table cell had child elements inside
 * v 0.1.2 - 2007-08-13
 *  - fix/change: changed event binding routine, as is got really slow with jquery 1.1.3.1
 *  -change: added new option "ignoreCols", through which columns can be excluded from the highlighting process
 * v 0.1.1 - 2007-06-05
 *  - fix: errors when using the plugin on a table not having a theader or tfoot
 * v 0.1.0 - 2007-05-31
 */

(function($) {
  /**
   * Calculates the actual cellIndex value of all cells in the table and stores it in the realCell property of each cell.
   * Thats done because the cellIndex value isn't correct when colspans or rowspans are used.
   * Originally created by Matt Kruse for his table library - Big Thanks! (see http://www.javascripttoolbox.com/)
   * @param {element} table  The table element.
   */
  var fixCellIndexes = function(table)  {
    var rows = table.rows;
    var len = rows.length;
    var matrix = [];
    for ( var i = 0; i < len; i++ ) {
      var cells = rows[i].cells;
      var clen = cells.length;
      for ( var j = 0; j < clen; j++ ) {
        var c = cells[j];
        var rowSpan = c.rowSpan || 1;
        var colSpan = c.colSpan || 1;
        var firstAvailCol = -1;
        if ( !matrix[i] ) { 
          matrix[i] = []; 
        }
        var m = matrix[i];
        // Find first available column in the first row
        while ( m[++firstAvailCol] ) {}
        c.realIndex = firstAvailCol;
        for ( var k = i; k < i + rowSpan; k++ ) {
          if ( !matrix[k] ) { 
            matrix[k] = []; 
          }
          var matrixrow = matrix[k];
          for ( var l = firstAvailCol; l < firstAvailCol + colSpan; l++ ) {
            matrixrow[l] = 1;
          }
        }
      }
    }
  };

  /**
   * Sets the rowIndex of each row in the table. 
   * Opera seems to get that wrong using document order instead of logical order on the tfoot-tbody part.
   * @param {element} table  The table element.
   */
  var fixRowIndexes = function(tbl)  {
    var v = 0, i, k, r = ( tbl.tHead ) ? tbl.tHead.rows : 0;
    if ( r ) {
      for ( i = 0; i < r.length; i++ ) {
        r[i].realRIndex = v++;
      }
    }
    for ( k = 0; k < tbl.tBodies.length; k++ ) {
      r = tbl.tBodies[k].rows;
      if ( r ) {
        for ( i = 0; i < r.length; i++ ) {
          r[i].realRIndex = v++;
        }
      }
    }
    r = ( tbl.tFoot ) ? tbl.tFoot.rows : 0;
    if ( r ) {
      for ( i = 0; i < r.length; i++ ) {
        r[i].realRIndex = v++;
      }
    }
  };

  /**
   * Highlights table rows and/or columns on mouse over.
   * Fixes the highlight of the currently highlighted rows/columns on click.
   * Works on tables with rowspans and colspans.
   *
   * @param {map} options      An object for optional settings (options described below).
   *
   * @option {boolean} allowHead    Allow highlighting when hovering over the table header.
   *              Default value: true
   * @option {boolean} allowBody    Allow highlighting when hovering over the table body.
   *              Default value: true
   * @option {boolean} allowFoot    Allow highlighting when hovering over the table footer.
   *              Default value: true
   *
   * @option {boolean} headRows    If true the rows in the table header will be highlighted when hovering over them.
   *              Default value: false
   * @option {boolean} bodyRows    If true the rows in the table body will be highlighted when hovering over them.
   *              Default value: true
   * @option {boolean} footRows    If true the rows in the table footer will be highlighted when hovering over them.
   *              Default value: false
   * @option {boolean} spanRows    When hovering over a cell spanning over more than one row, highlight all spanned rows.
   *              Default value: true
   *
   * @option {boolean} headCols    If true the cells in the table header (matching the currently hovered column) will be highlighted.
   *              Default value: false
   * @option {boolean} bodyCols    If true the cells in the table body (matching the currently hovered column) will be highlighted.
   *              Default value: true
   * @option {boolean} footCols    If true the cells in the table footer (matching the currently hovered column) will be highlighted.
   *              Default value: false
   * @option {boolean} spanCols    When hovering over a cell spanning over more than one column, highlight all spanned columns.
   *              Default value: true
   * @option {array} ignoreCols    An array of numbers. Each column with the matching column index won't be included in the highlighting process.
   *              Index starting at 1!
   *              Default value: [] (empty array)
   *
   * @option {boolean} headCells    Set a special highlight class to the cell the mouse pointer is currently pointing at (inside the table header only).
   *              Default value: false
   * @option {boolean} bodyCells    Set a special highlight class to the cell the mouse pointer is currently pointing at (inside the table body only).
   *              Default value: true
   * @option {boolean} footCells    Set a special highlight class to the cell the mouse pointer is currently pointing at (inside the table footer only).
   *              Default value: false
   *
   * @option {string} rowClass      The css class set to the currently highlighted row.
   *              Default value: 'hover'
   * @option {string} colClass      The css class set to the currently highlighted column.
   *              Default value: '' (empty string)
   * @option {string} cellClass      The css class set to the currently highlighted cell.
   *              Default value: '' (empty string)
   * @option {string} clickClass    The css class set to the currently highlighted row and column on mouse click.
   *              Default value: '' (empty string)
   *
   * @example $('#table').tableHover({});
   * @desc Add simple row highlighting to #table with default settings.
   *
   * @example $('#table').tableHover({rowClass: "someclass", colClass: "someotherclass"});
   * @desc Add row and columnhighlighting to #table and set the specified css classes to the highlighted cells.
   *
   * @example $('#table').tableHover({clickClass: "someclickclass"});
   * @desc Add simple row highlighting to #table and set the specified css class on the cells when clicked.
   *
   * @example $('#table').tableHover({allowBody: false, allowFoot: false, allowHead: true, colClass: "someclass"});
   * @desc Add column highlighting on #table only highlighting the cells when hovering over the table header.
   *
   * @example $('#table').tableHover({bodyCols: false, footCols: false, headCols: true, colClass: "someclass"});
   * @desc Add column highlighting on #table only for the cells in the header.
   *
   * @type jQuery
   *
   * @name tableHover
   * @cat Plugins/tableHover
   * @author Roman Weich (http://p.sohei.org)
   */
  $.fn.tableHover = function(options) {
    var settings = $.extend({
        allowHead : true,
        allowBody : true,
        allowFoot : true,

        headRows : false,
        bodyRows : true,
        footRows : false,
        spanRows : true,

        headCols : false,
        bodyCols : true,
        footCols : false,
        spanCols : true,
        ignoreCols : [],

        headCells : false,
        bodyCells : true,
        footCells : false,
        //css classes,,
        rowClass : 'hover',
        colClass : '',
        cellClass : '',
        clickClass : ''
      }, options);

    return this.each(function() {
      var colIndex = [], rowIndex = [], tbl = this, r, rCnt = 0, lastClick = [-1, -1];
      if ( !tbl.tBodies || !tbl.tBodies.length ) {
        return;
      }

      /**
       * Adds all rows and each of their cells to the row and column indexes.
       * @param {array} rows    An array of table row elements to add.
       * @param {string} nodeName  Defines whether the rows are in the header, body or footer of the table.
       */
      var addToIndex = function(rows, nodeName) {
        var c, row, rowI, cI, rI, s;
        //loop through the rows
        for ( rowI = 0; rowI < rows.length; rowI++, rCnt++ ) {
          row = rows[rowI];
          //each cell
          for ( cI = 0; cI < row.cells.length; cI++ ) {
            c = row.cells[cI];
            //add to rowindex
            if ( (nodeName == 'TBODY' && settings.bodyRows) 
              || (nodeName == 'TFOOT' && settings.footRows) 
              || (nodeName == 'THEAD' && settings.headRows) ) {
              s = c.rowSpan;
              while ( --s >= 0 ) {
                rowIndex[rCnt + s].push(c);
              }
            }
            //add do colindex
            if ( (nodeName == 'TBODY' && settings.bodyCols)
                || (nodeName == 'THEAD' && settings.headCols) 
                || (nodeName == 'TFOOT' && settings.footCols) ) {
              s = c.colSpan;
              while ( --s >= 0 ) {
                rI = c.realIndex + s;
                if ( $.inArray(rI + 1, settings.ignoreCols) > -1 ) {
                  break;//dont highlight the columns in the ignoreCols array
                }
                if ( !colIndex[rI] ) {
                  colIndex[rI] = [];
                }
                colIndex[rI].push(c);
              }
            }
            //allow hover for the cell?
            if ( (nodeName == 'TBODY' && settings.allowBody) 
                || (nodeName == 'THEAD' && settings.allowHead) 
                || (nodeName == 'TFOOT' && settings.allowFoot) ) {
              c.thover = true;
            }
          }
        }
      };

      /**
       * Mouseover event handling. Set the highlight to the rows/cells.
       */
      var over = function(e) {
        var p = e.target;
        while ( p != this && p.thover !== true ) {
          p = p.parentNode;
        }
        if ( p.thover === true ) {
          highlight(p, true);
        }
      };

      /**
       * Mouseout event handling. Remove the highlight from the rows/cells.
       */
      var out = function(e) {
        var p = e.target;
        while ( p != this && p.thover !== true ) {
          p = p.parentNode;
        }
        if ( p.thover === true ) {
          highlight(p, false);
        }
      };
      
      /**
       * Mousedown event handling. Sets or removes the clickClass css style to the currently highlighted rows/cells.
       */
      var click = function(e) {
        var t = e.target;
        while ( t && t != tbl && !t.thover ) //search the real target
          t = t.parentNode;
        if ( t.thover && settings.clickClass != '' ) {
          var x = t.realIndex, y = t.parentNode.realRIndex, s = '';
          //unclick
          $('td.' + settings.clickClass + ', th.' + settings.clickClass, tbl).removeClass(settings.clickClass);
          if ( x != lastClick[0] || y != lastClick[1] ) {
            //click..
            if ( settings.rowClass != '' ) {
              s += ',.' + settings.rowClass;
            }
            if ( settings.colClass != '' ) {
              s += ',.' + settings.colClass;
            }
            if ( settings.cellClass != '' ) {
              s += ',.' + settings.cellClass;
            }
            if ( s != '' ) {
              $('td, th', tbl).filter(s.substring(1)).addClass(settings.clickClass);
            }
            lastClick = [x, y];
          } else {
            lastClick = [-1, -1];
          }
        }
      };
      
      /**
       * Adds or removes the highlight to/from the columns and rows.
       * @param {element} cell  The cell with the mouseover/mouseout event.
       * @param {boolean} on    Defines whether the style will be set or removed.
       */
      var highlight = function(cell, on) {
        if ( on ) { //create dummy funcs - dont want to test for on==true all the time
          $.fn.tableHoverHover = $.fn.addClass;
        } else {
          $.fn.tableHoverHover = $.fn.removeClass;
        }
        //highlight columns
        var h = colIndex[cell.realIndex] || [], rH = [], i = 0, rI, nn;
        if ( settings.colClass != '' ) {
          while ( settings.spanCols && ++i < cell.colSpan && colIndex[cell.realIndex + i] ) {
            h = h.concat(colIndex[cell.realIndex + i]);
          }
          $(h).tableHoverHover(settings.colClass);
        }
        //highlight rows
        if ( settings.rowClass != '' ) {
          rI = cell.parentNode.realRIndex;
          if ( rowIndex[rI] ) {
            rH = rH.concat(rowIndex[rI]);
          }
          i = 0;
          while ( settings.spanRows && ++i < cell.rowSpan ) {
            if ( rowIndex[rI + i] ) {
              rH = rH.concat(rowIndex[rI + i]);
            }
          }
          $(rH).tableHoverHover(settings.rowClass);
        }
        //highlight cell
        if ( settings.cellClass != '' ) {
          nn = cell.parentNode.parentNode.nodeName.toUpperCase();
          if ( (nn == 'TBODY' && settings.bodyCells)
              || (nn == 'THEAD' && settings.headCells)
              || (nn == 'TFOOT' && settings.footCells) ) {
            $(cell).tableHoverHover(settings.cellClass);
          }
        }
      };

      fixCellIndexes(tbl);
      fixRowIndexes(tbl);

      //init rowIndex
      for ( r = 0; r < tbl.rows.length; r++ ) {
        rowIndex[r] = [];
      }
      //add header cells to index
      if ( tbl.tHead ) {
        addToIndex(tbl.tHead.rows, 'THEAD');
      }
      //create index - loop through the bodies
      for ( r = 0; r < tbl.tBodies.length; r++ ) {
        addToIndex(tbl.tBodies[r].rows, 'TBODY');
      }
      //add footer cells to index
      if ( tbl.tFoot ) {
        addToIndex(tbl.tFoot.rows, 'TFOOT');
      }
      $(this).bind('mouseover', over).bind('mouseout', out).click(click);
    });
  };
})(jQuery);
