tablesorter (FORK) 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. This forked version adds lots of new enhancements including: alphanumeric sorting, pager callback functons, multiple widgets providing column styling, ui theme application, sticky headers, column filters and resizer, as well as extended documentation with a lot more demos.
Notice!
- Because of the change to the internal cache, the tablesorter v2.16+ core, filter widget and pager (both plugin & widget) will only work with the same version or newer files.
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.
Questions?
- Check the FAQ page.
- Search the main documentation (click the menu button in the upper left corner).
- Search the issues to see if the question or problem has been brought up before, and hopefully resolved.
- If someone is available, ask your question in the
#tablesorter
IRC channel at freenode.net. - Ask your question at Stackoverflow using a tablesorter tag.
- Please don't open a new issue unless it really is an issue with the plugin, or a feature request. Thanks!
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-4.
- 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.
- The original version can be found at http://tablesorter.com, or on GitHub.
- Dual licensed under the MIT or GPLv2 licenses (pick one).
Download
- Get all files: zip or tar.gz.
- Use bower:
bower install jquery.tablesorter
. - Use node.js:
npm install tablesorter
. - CDNJS: https://cdnjs.com/libraries/jquery.tablesorter
- jsDelivr: http://www.jsdelivr.com/?query=tablesorter
Related Projects
- Plugin for Rails. Maintained by themilkman.
- UserFrosting (A secure, modern user management system for PHP that uses tablesorter) by @alexweissman.
- Grav CMS:
bin/gpm install tablesorter
(ref). - tablesorter-pagercontrols – programmatically adds pager controls below a table and applies the pager add-on for large HTML tables by isg-software.
Contributing
If you would like to contribute, please...
- Fork.
- Make changes in a branch & add unit tests.
- Run
grunt test
(if qunit fails, run it again - it's fickle). - Create a pull request.
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.
- Thanks to prijutme4ty for numerous contributions!
- 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 through pull requests and open issues to this forked project!
Recent Changes
View the complete change log here.
Version 2.31.1 (2018-11-20)
- Core:
- Store sortList on init. Fixes issue #1585.
- Math:
- Add math_textAttr. See issue #1601.
- Readme:
- Remove bower, gitter & add Slack.
- Meta:
- Update dependencies.
Version 2.31.0 (2018-08-27)
- Editable:
- Add nbsp to empty cells. Fixes issue #1570.
- Docs:
- Add filter
getOptionSource
function. See issue #671. - Add built-in parsers demo. See issue #1571.
- Add filter
- Pager:
- Change default ajaxProcessing function. See issue #1580.
- Build:
- Update build to UMD wrap widgets, parsers & extras (necessitates a minor version bump).
Version 2.30.7 (2018-07-10)
- Core:
- Add
data-sortedBy
to headers; seeconfig.sortVars
. Closes issue #1558. - Ensure sort parameters are defined. Fixes issue #1566.
- Add
- Parser:
- input-select updates extra header checkboxes. Fixes issue #1560.
- CSS:
- Style caption per table theme. Fixes issue #1564.