jQuery.filterTable Change Log
- Support for
quickListClear option that appends a quick list link which clears the filter.
- Fixed filtering to work for special characters ',
- Minor documentation updates.
- The filtering should now trigger automatically on input on iOS. For some reason, Safari iOS triggers a
blur event on field change but not
keyup or other related events.
- A new feature for extending the plugin (option
filterExpression) has been added. The default is unchanged—the literal filter string.
- To search for any of multiple terms, set
filterTableFindAny to perform an OR search which delimits on space or comma characters in the filter field. Thank you to Lukas for the implementation. An example page is included.
- To search for all of multiple terms, set
filterTableFindAll to perform an AND search which delimits on space or comma characters in the filter field. Note that the matching is per-cell not per row, so each cell must have all terms to match. An example page is included.
- A new feature for ignoring columns is available via the
ignoreColumns option. Provide an array of column numbers (0-indexed) to ignore those columns during filtering. The default is no columns are ignored. An example page is included.
- A new feature for ignoring cells with a specific class is available via the
ignoreClass option. Provide a class name to ignore those cells during filtering. The default is no classes are ignored. An exampled page is included. Thanks to geda0 for the idea.
- Added a
minChars option, thanks to Darius Kazemi, which specifies the minimum number of characters a user must enter into the filter field before filtering occurs. Default is 1, meaning the moment the user begins to type, filtering will occur.
- Merged Pierre Rudloff’s Bower support.
- Merged Jason’s
minRows bug fix.
- Added an FAQ file.
- Added a return key trap to the input filter field so that pressing return in the field should not submit any forms the table may be within.
preventReturnKey option (
true by default) has been added to allow you to switch back to the previous behavior of allowing the return key to submit forms.
- There is a potentially significant change in functionality in this version. While the documentation offered the
inputSelector option, within the code it was implemented as
filterSelector. This has been corrected to match the documentation. Note that if you were previously using the
filterSelector option to overcome this issue, you will need to change it to
inputSelector to use the feature with this version.
- Added an
inputSelector option, thanks to Pratik Thakkar, which specifies a selector for an existing element to use instead of creating a new filter input field. There are some caveats of which to be aware:
- If the element doesn't exist, a filter input field will be created as normal.
- Because of quick lists and other options, this setting will be ignored and the filter input field will be created as normal if the resolution of the
inputSelector returns more than one element.
- Added an
autofocus option, thanks to Robert McLeod, which is disabled by default. Note that autofocus is generally a bad idea for accessibility reasons, but if you do not need to be compliant or don't want to support accessibility users, it's a nice user experience option.
- There is a potentially significant change in functionality in this version. The callback is now called every time the search query changes. Previously it was only called when the change was a non-empty query. That is, the callback is now called when the query is cleared too.
- Additional features have been taken from Tomas Celizna's CoffeeScript-based fork:
- The quick list items can now be something other than anchor tags. See the
- The filter query field can now have a name attribute assigned to it. See the
- The class applied to visible rows is now user changeable. See the
- The options in the documentation have been ordered alphabetically for easier scanning.
- The internal pseudo selector is now created appropriately according to the jQuery version. (Pseudo selector generation changed in jQuery 1.8)
- Fixed a bug with filtering rarely showing rows that did not have a match with the search query.
- Added example pages.
- Improved inline documentation of the source code.
1.3.1 (in spirit)
- The functionality is not reapplied to tables that have already been processed. This allows you to call
$(selector).filterTable() again for dynamically created data without it affecting previously filtered tables.
- Changed the default container class to
table-filter to be consistent with the plugin name.
- Made the cell highlighting class an option rather than hard-coded.