// Highlight Table Row
// Copyright (C) 2005 F. Permadi

var timeout_id;
var timeout_id2;
var mouse_event;
var hilite_color;
t_out=50;

// These variables are for saving the original background colors
var savedStates=new Array();
var savedStateCount=0;


// This function takes an element as a parameter and 
// returns an object which contain the saved state
// of the element's background color.
function saveBackgroundStyle(myElement)
{
saved=new Object();
saved.element=myElement;
if(myElement.className)saved.className=myElement.className;
saved.backgroundColor=myElement.style["backgroundColor"];
return saved; 
}


// This function takes an element as a parameter and 
// returns an object which contain the saved state
// of the element's background color.
function restoreBackgroundStyle(savedState)
{
savedState.element.style["backgroundColor"]=savedState.backgroundColor;
if(savedState.className)savedState.element.className=savedState.className;
}


// This function is used by highlightTableRow() to find table cells (TD) node
function findNode(startingNode, tagName)
{
// on Firefox, the TD node might not be the firstChild node of the TR node
myElement=startingNode;
var i=0;
while(myElement&&(!myElement.tagName||(myElement.tagName&&myElement.tagName!=tagName))) {
myElement=startingNode.childNodes[i];
i++;
} 
if(myElement&&myElement.tagName&&myElement.tagName==tagName) {
return myElement;
}
// on IE, the TD node might be the firstChild node of the TR node 
else if(startingNode.firstChild) {
return findNode(startingNode.firstChild, tagName);
}
return 0;
}


// Highlight table row.
// newElement could be any element nested inside the table
// highlightColor is the color of the highlight
function highlightTableRow(myElement, highlightColor)
{
var i=0;
// Restore color of the previously highlighted row
for(i;i<savedStateCount;i++)restoreBackgroundStyle(savedStates[i]);
savedStateCount=0;

// To get the node to the row (ie: the <TR> element), 
// we need to traverse the parent nodes until we get a row element (TR)
// Netscape has a weird node (if the mouse is over a text object, then there's no tagName
while(myElement&&((myElement.tagName&&myElement.tagName!="TR")||!myElement.tagName))myElement=myElement.parentNode;

// If you don't want a particular row to be highlighted, set it's id to "nohilite"
if(!myElement||(myElement&&myElement.id&&myElement.id=="nohilite"))return;

// Highlight every cell on the row
if(myElement) {
var tableRow=myElement;

// Save the backgroundColor style OR the style class of the row (if defined)
if(tableRow) {
savedStates[savedStateCount]=saveBackgroundStyle(tableRow);
savedStateCount++;
}

// myElement is a <TR>, then find the first TD
var tableCell=findNode(myElement, "TD"); 

var i=0;
// Loop through every sibling (a sibling of a cell should be a cell)
// We then highlight every siblings
while(tableCell) {
// Make sure it's actually a cell (a TD)
if(tableCell.tagName=="TD") {
// If no style has been assigned, assign it, otherwise Netscape will behave weird.
if(!tableCell.style) {
tableCell.style={};
}
else {
savedStates[savedStateCount]=saveBackgroundStyle(tableCell); 
savedStateCount++;
}
// Assign the highlight color
tableCell.style["backgroundColor"]=highlightColor;
// Optional: alter cursor
tableCell.style.cursor='hand';
i++;
}
// Go to the next cell in the row
tableCell=tableCell.nextSibling;
}
}
}


// This function is to be assigned to a <table> mouse event handler.
// If the element that fired the event is within a table row,
// this function will highlight the row.
function trackTableHighlight(mEvent, highlightColor)
{
if(!mEvent)mEvent=window.event;
mouse_event=mEvent.srcElement?mEvent.srcElement:mEvent.target;
hilite_color=highlightColor;
clearTimeout(timeout_id);
clearTimeout(timeout_id2);
timeout_id=window.setTimeout("highlightTableRow(mouse_event, hilite_color)", t_out);
}