// search_highlight.js
/* Source: http://www.nsftools.com/misc/SearchAndHighlight.htm */
/*
 * This is the function that actually highlights a text string by
 * adding HTML tags before and after all occurrences of the search
 * term. You can pass your own tags if you'd like, or if the
 * highlightStartTag or highlightEndTag parameters are omitted or
 * are empty strings then the default <font> tags will be used.
 */
function doHighlight(bodyText, searchTerm, highlightStartTag, highlightEndTag) 
{
  // the highlightStartTag and highlightEndTag parameters are optional
  if ((!highlightStartTag) || (!highlightEndTag)) {
    highlightStartTag = "<font style='color:blue; background-color:yellow;'>";
    highlightEndTag = "</font>";
  }
  
  // find all occurences of the search term in the given text,
  // and add some "highlight" tags to them (we're not using a
  // regular expression search, because we want to filter out
  // matches that occur within HTML tags and script blocks, so
  // we have to do a little extra validation)
  var newText = "";
  var i = -1;
  var lcSearchTerm = searchTerm.toLowerCase();
  var lcBodyText = bodyText.toLowerCase();
    
  while (bodyText.length > 0) {
    i = lcBodyText.indexOf(lcSearchTerm, i+1);
    if (i < 0) {
      newText += bodyText;
      bodyText = "";
    } else {
      // skip anything inside an HTML tag
      if (bodyText.lastIndexOf(">", i) >= bodyText.lastIndexOf("<", i)) {
        // skip anything inside a <script> block
        if (lcBodyText.lastIndexOf("/script>", i) >= lcBodyText.lastIndexOf("<script", i)) {
          newText += bodyText.substring(0, i) + highlightStartTag + bodyText.substr(i, searchTerm.length) + highlightEndTag;
          bodyText = bodyText.substr(i + searchTerm.length);
          lcBodyText = bodyText.toLowerCase();
          i = -1;
        }
      }
    }
  }
  
  return newText;
}


/*
 * This is sort of a wrapper function to the doHighlight function.
 * It takes the searchText that you pass, optionally splits it into
 * separate words, and transforms the text on the current web page.
 * Only the "searchText" parameter is required; all other parameters
 * are optional and can be omitted.
 */
function highlightSearchTerms(searchText, treatAsPhrase, warnOnFailure, highlightStartTag, highlightEndTag)
{
  // if the treatAsPhrase parameter is true, then we should search for 
  // the entire phrase that was entered; otherwise, we will split the
  // search string so that each word is searched for and highlighted
  // individually
  if (treatAsPhrase) {
    searchArray = [searchText];
  } else {
    searchArray = searchText.split(" ");
  }
  
  if (!document.body || typeof(document.body.innerHTML) == "undefined") {
    if (warnOnFailure) {
      alert("Sorry, for some reason the text of this page is unavailable. Searching will not work.");
    }
    return false;
  }
  
  var bodyText = document.body.innerHTML;
  for (var i = 0; i < searchArray.length; i++) {
    bodyText = doHighlight(bodyText, searchArray[i], highlightStartTag, highlightEndTag);
  }
  
  document.body.innerHTML = bodyText;
  return true;
}


/*
 * This displays a dialog box that allows a user to enter their own
 * search terms to highlight on the page, and then passes the search
 * text or phrase to the highlightSearchTerms function. All parameters
 * are optional.
 */
function searchPrompt(defaultText, treatAsPhrase, textColor, bgColor)
{
  // This function prompts the user for any words that should
  // be highlighted on this web page
  if (!defaultText) {
    defaultText = "";
  }
  
  // we can optionally use our own highlight tag values
  if ((!textColor) || (!bgColor)) {
    highlightStartTag = "";
    highlightEndTag = "";
  } else {
    highlightStartTag = "<font style='color:" + textColor + "; background-color:" + bgColor + ";'>";
    highlightEndTag = "</font>";
  }
  
  if (treatAsPhrase) {
    promptText = "Please enter the phrase you'd like to search for:";
  } else {
    promptText = "Please enter the words you'd like to search for, separated by spaces:";
  }
  
  searchText = prompt(promptText, defaultText);

  if (!searchText)  {
    //alert("No search terms were entered. Exiting function.");
    return false;
  }
  
  return highlightSearchTerms(searchText, treatAsPhrase, true, highlightStartTag, highlightEndTag);
}

function jumpTo(loc){
    return location.href = "#"+ loc;
}

function showNodes() {
	var e = document.getElementsByTagName("dt");
	var msg = "";
	// NB IE strips the quotes from the ID attribute
	var re = /<a\s+id=\"?(.*?)\"?\s*>/i;
	var ar;
	for (var i = 0; i < e.length; i++)
	{
		msg += i + " " + e[i].innerHTML + "\n";
		if (e[i].title)
			msg += "   - -" + e[i].title + "\n";
		ar = re.exec(e[i].innerHTML);
		if (ar)
			msg += "  **" + ar[1] + "\n";
	}
	alert(msg);
	return true;
}

function findFirstKeywordLoc(searchText)
/* Search through all <DT> tags for a match with *first* word in searchText
   expecting tag in format
   <DT TITLE="keyword1 keyword2"><A ID="myloc"></A>Title for this topic</DT>
   If find a keyword in title that matchs, return "myloc" else empty string ""
*/
{
	var loc = "";
	var toFind = searchText.split(" ")[0];
	//alert("Looking for " + toFind);
	var e = document.getElementsByTagName("dt");
	var regid = /<a\s+id=\"?(.*?)\"?\s*>/i;
	var regkw = new RegExp(toFind, "i");
	// Work through al DT tags until find a match
	for (var i = 0; i < e.length; i++)
	{
		if (regkw.test(e[i].title))
		{
			//alert("found match at " + e[i].title);
			// Now extract location ID from A tag
			loc = regid.exec(e[i].innerHTML)[1];
			//alert("location is [" + loc + "]");
			break;
		}
	}
	return loc;
}

function highlightAndJump(searchText, treatAsPhrase, warnOnFailure, highlightStartTag, highlightEndTag)
{
	var loc;
	highlightSearchTerms(searchText, treatAsPhrase, warnOnFailure, highlightStartTag, highlightEndTag);
	loc = findFirstKeywordLoc(searchText);
	jumpTo(loc);
	return false;
}