jQuery plugin: Tablesorter 2.0 - Filter Widget Any Match

# tablesorter

## Filter Widget Any Match

### Flexible client-side table sorting

Back to documentation

NOTE!

- This is a demo of the `filter_anyMatch` option (v2.13.3).
- This method has limitations in that it does not support all of the per column search features! So, at this time, the following types of queries are not allowed as the results will cause confusion:
  - Search operators - A search for values equal, greater or less than values (`> >= <= <`) is not allowed because tables that contain both numbers and text (in separate columns). For example:

        "Fred" > "1"  // true*
        "Fred" < "10" // false
        "Fred" > 1    // false (numeric comparisons occur with parsed table data)
        "Fred" > 1    // false
        "Fred" < 10   // false

    * For comparisons, letters have a greater ASCII value than numbers.
  - Range query - A search for any number range (`1 - 10`) is not allowed because, if any columns contain text, then no rows will result. The examples are the same as the search operators examples above.
  - Not Match query - A search for not matches (`!a`) is not allowed because tables that contain both numbers and text (in separate columns) will always show all rows. For example:

        "Frank".search("a")    //  2 (a match, so this row "may" be hidden)
        "Fred".search("a")      // -1 (a not match! so this row will always show)
        "25".search("a")        // -1 (a not match! so this row will always show)
        "1/1/2014".search("a")  // -1 (a not match! so this row will always show)

  - Allowed filters include plain text matching, fuzzy search (`~`), exact match (`"`), wild card matches( `?` or `*`), regex (`/\d/g`), and logical and (`a && b`)/or (`a|b`) matches.
- Setting this option should work properly with or without the column filters. The only issue you would have is if you triggered a search on the table using an array with undefined or null array values, like this:

      // apply "2?%" filter to the fifth column (zero-based index)
      var columns = [];
      columns[5] = '2?%';
      // anyMatch will kick in on undefined column filters,
      // unless the array looks like this: columns = [ '', '', '', '', '', '2?%' ]
      $('table').trigger('search', [ columns ]);

# Demo

Rank | First Name | Last Name | Age | Total | Discount | Date
--- | --- | --- | --- | --- | --- | ---
1 | Philip Aaron | Johnson Sr Esq | 25 | $5.95 | 22% | Jun 26, 2004 7:22 AM
11 | Aaron | Hibert | 12 | $2.99 | 5% | Aug 21, 2009 12:21 PM
12 | Brandon Clark | Henry Jr | 51 | $42.29 | 18% | Oct 13, 2000 1:15 PM
111 | Peter | Parker | 28 | $9.99 | 20% | Jul 6, 2006 8:14 AM
21 | John | Hood | 33 | $19.99 | 25% | Dec 10, 2002 5:14 AM
013 | Clark | Kent Sr. | 18 | $15.89 | 44% | Jan 12, 2003 11:14 AM
005 | Bruce | Almighty Esq | 45 | $153.19 | 44% | Jan 18, 2021 9:12 AM
10 | Alex | Dumass | 13 | $5.29 | 4% | Jan 8, 2012 5:11 PM
16 | Jim | Franco | 24 | $14.19 | 14% | Jan 14, 2004 11:23 AM
166 | Bruce Lee | Evans | 22 | $13.19 | 11% | Jan 18, 2007 9:12 AM
100 | Brenda Lee | McMasters | 18 | $55.20 | 15% | Feb 12, 2010 7:23 PM
55 | Dennis | Bronson | 65 | $123.00 | 32% | Jan 20, 2001 1:12 PM
9 | Martha | delFuego | 25 | $22.09 | 17% | Jun 11, 2011 10:55 AM

# Javascript

# HTML

Next up: jQuery custom filter widget ››