tablesorter is a jQuery plugin for turning a standard HTML table with THEAD and TBODY tags into a sortable table without page refreshes. tablesorter can successfully parse and sort many types of data including linked data in a cell.

Documentation

• See the full documentation.
• All of the original document pages have been included.
• Information from my blog post on undocumented options and lots of new demos have also been included.
• Change log moved from included text file into the wiki documentation.

Demos

• Basic alpha-numeric sort Demo.
• Links to demo pages can be found within the main documentation.
• More demos & playgrounds - updated in the wiki pages.

Features

• Multi-column alphanumeric sorting and filtering.
• Multi-tbody sorting - see the options table on the main document page.
• Supports Bootstrap v2 and 3
• Parsers for sorting text, alphanumeric text, URIs, integers, currency, floats, IP addresses, dates (ISO, long and short formats) & time. Add your own easily.
• Inline editing - see demo
• Support for ROWSPAN and COLSPAN on TH elements.
• Support secondary "hidden" sorting (e.g., maintain alphabetical sort when sorting on other criteria).
• Extensibility via widget system.
• Cross-browser: IE 6.0+, FF 2+, Safari 2.0+, Opera 9.0+, Chrome 5.0+.
• Small code size, starting at 25K minified
• Works with jQuery 1.2.6+ (jQuery 1.4.1+ needed with some widgets).
• Works with jQuery 1.9+ ($.browser.msie was removed; needed in the original version).

Licensing

• Copyright (c) 2007 Christian Bach.
• Original examples and docs at: http://tablesorter.com.
• Dual licensed under the MIT and GPL licenses.

Special Thanks

• Big shout-out to Nick Craver for getting rid of the eval() function that was previously needed for multi-column sorting.
• Big thanks to thezoggy for helping with code, themes and providing valuable feedback.
• Big thanks to ThsSin- for taking over for a while and also providing valuable feedback.
• Also extra thanks to christhomas and Lynesth for help with code.
• And, of course thanks to everyone else that has contributed, and continues to contribute to this forked project!

Change Log

View the complete listing here.

Version 2.15.6 (3/7/2014)

• Doc

  • Added docs for $.tablesorter.language which contains the text used in the aria-label for the header
  • Update isValueInArray & sortAppend docs.

• Core

  • Destroy now unbinds the updateCache method properly
  • Update $.tablesorter.isValueInArray function & sortAppend option. Fixes issue #523.
  • All test dates are now time zone & DST independent. Fixes issue #516.
  • Added tests for sortForce, sortAppend, sortMultiSortKey and sortResetKey.
  • Cache natural sort regex.
  • Date parsers now return the original cell text instead of an empty string when encountering invalid dates. Sort of fixes issue #531.
  • Event fixes:
    • Sort events will now only show when the table is being sorted; previously when updating an unsorted table, sort events would fire.
    • The updateComplete event now fires after every triggered update (update, updateRows, updateAll, updateCell & addRows)
    • Updated pager to correctly trigger the updateComplete event when using ajax.
    • Added unit tests to ensure these events fire on an empty table.
    • Fixes issue #532

• ColumnSelector widget

  • Make column disable, visible & invisible methods consistent. Fixes issue #519

• Filter widget

  • Preset filter searches (set by data-value on the header) work again. Fixes issues #511 & #525.
  • Add note to docs about adding a placeholder. Fixes issue #522.
  • Filter build select function no longer causes a javascript error on empty tables. Fixes issue #528.

• Grouping widget

  • The collapsed option once again shows the group headers. Fixes issues #514 & 533
  • Add group_saveGroups & group_saveReset options:
    • The group_saveGroups option (true by default) saves the group name of any collapsed groups (requires group_collapsible to be true)
    • The group_saveReset option (null by default) contains a jQuery selector string or jQuery object pointing to an element to be used to clear the saved groups.
    • Both of these options require the storage utility script contained within the jquery.tablesorter.widgets.js file.
    • Fullfils feature request of issue #514.
  • Added details about using regular expressions within the group_separator option.

• Header Titles widget (headerTitles)

  • New widget which adds the current sort to the header title attribute.
  • It distinguishes between a text and numeric sort and includes the current sort direction
  • A prefix can be included.
  • By default, an ascending sort shows either "A - Z" or "0 - 9", or "Z - A" or "9 - 0" for descending sorts.
  • Note that date columns will show as numeric
  • Fixes issue #529.

• Pager (addon & widget)

  • Ensure empty array [] and array of empty strings ['', '', ''] evaluate as the same when checking if the filters have changed. Fixes issue #202 (again).
  • Compare totalRows vs. totalPages when preventing an ajax call.
  • Changes to make the updateComplete event fire, but because of the asynchronous nature of ajax, it fires before any sortEnd events. It may take some more work to resolve this, if it becomes a concern.
  • Attempted to fix pager row count issue. See issue #455.

• Miscellaneous

  • Pager custom controls (beta) now shows no pages on a single page. Fixes issue #518
  • Increase Bootstrap 3 theme css specificity. See issue #515
  • Checkbox parser no longer causes a js error when a checkbox doesn't exist.

Version 2.15.5 (2/23/2014)

• Pager widget now initializes properly when using ajax. Fixes issue #510.

Version 2.15.4 (2/22/2014)

• Add "updateCache" method
  • This method updates the parsers, if undefined, then updates the internal cache.
  • Used by the pager (addon & widget) to update the internal cache after an ajax update.
• Pager (addon & widget)
  • Fixed several undefined variable javascript errors. Fixes issue #509.
  • Fixed an issue with recursion in the pager widget - removed several unnecessary "applyWidget" methods.
  • Now uses the "updateCache" method after the table is rendered using ajax.

Version 2.15.3 (2/21/2014)

• Stickyheaders
  • Sorting works again. Fixes issue #508.
  • Table no longer scrolls to the top after initializing a sort from the sticky header.

Version 2.15.2 (2/20/2014)

• Filter widget
  • Fix js error on empty tables & multiple rows in thead while managing c.parsers. Fixes issue #507.
  • filter-onlyAvail now updates all selects properly. Fixes issue #473.
  • Fix annoying filter search caret jumping to end while typing
• Doc updates
  • Added delayInit demo (pull #504) - thanks Infeligo!
  • Fixed some markup issues & rearranged some links
  • Updated minified widget file date. Fixes issue #505