Support for notify handler when a match is found

[prainho]

I've changed your code to support match notification when a match is found.

You are free to use this code:

/*
- Copyright (c) 2008 Greg Weber greg at gregweber.info
- Dual licensed under the MIT and GPLv2 licenses just as jQuery is:
- http://jquery.org/license
  *
- documentation at http://gregweber.info/projects/uitablefilter
  *
- allows table rows to be filtered (made invisible)
- <code>
- t = $('table')
- $.uiTableFilter( t, phrase )
- </code>
- arguments:
-   jQuery object containing table rows
-   phrase to search for
-   optional arguments:
-     column to limit search too (the column title in the table header)
- 
  ifHidden - callback to execute if one or more elements was hidden
  
  
  */
  (function ($) {
  $.uiTableFilter = function (jq, phrase, column, ifHidden, notifyMatchHandler) {
      var new_hidden = false;
      if (this.last_phrase === phrase) return false;
  
  
  var phrase_length = phrase.length;
  var words = phrase.toLowerCase().split(" ");
  
  // these function pointers may change
  var matches = function (elem) { elem.show(); if (notifyMatchHandler) notifyMatchHandler(elem); }
  var noMatch = function (elem) { elem.hide(); new_hidden = true }
  var getText = function (elem) { return elem.text() }
  
  if (column) {
      var index = null;
      jq.find("thead > tr:last > th").each(function (i) {
          if ($.trim($(this).text()) == column) {
              index = i; return false;
          }
      });
      if (index == null) throw ("given column: " + column + " not found")
  
      getText = function (elem) {
          return $(elem.find(
  ("td:eq(" + index + ")"))).text()
      }
  }
  
  // if added one letter to last time,
  // just check newest word and only need to hide
  if ((words.size > 1) && (phrase.substr(0, phrase_length - 1) ===
    this.last_phrase)) {
  
      if (phrase[-1] === " ")
      { this.last_phrase = phrase; return false; }
  
      var words = words[-1]; // just search for the newest word
  
      // only hide visible rows
      matches = function (elem) { ; }
      var elems = jq.find("tbody:first > tr:visible")
  }
  else {
      new_hidden = true;
      var elems = jq.find("tbody:first > tr")
  }
  
  elems.each(function () {
      var elem = $(this);
      $.uiTableFilter.has_words(getText(elem), words, false) ?
  matches(elem) : noMatch(elem);
  });
  
  last_phrase = phrase;
  if (ifHidden && new_hidden) ifHidden();
  return jq;
  
  
  };
  
  // caching for speedup
  $.uiTableFilter.last_phrase = ""
  
  // not jQuery dependent
  // "" [""] -> Boolean
  // "" [""] Boolean -> Boolean
  $.uiTableFilter.has_words = function (str, words, caseSensitive) {
      var text = caseSensitive ? str : str.toLowerCase();
      for (var i = 0; i < words.length; i++) {
          if (text.indexOf(words[i]) === -1) return false;
      }
      return true;
  }
  })(jQuery);

[gregwebs]

please create a pull request for this, otherwise I have no idea what you have changed