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.

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.

Download

• Get all files
• Use bower: bower install jquery.tablesorter
• Use node.js: npm install tablesorter
• CDNJS: https://cdnjs.com/libraries/jquery.tablesorter

Related Projects

• Plugin for Rails. Maintained by themilkman.
• Bootsole (OOP templating engine using tablesorter) by alexweissman.

Contributing

If you would like to contribute, please...

1. Fork.
2. Make changes in a branch & add unit tests.
3. Run grunt test (if qunit fails, run it again - it's fickle).
4. 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 to this forked project!

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!

Recent Changes

View the complete change log here.

Version 2.22.2 (6/30/2015)

• Core
  • Only use preventDefault in specific jQuery versions (v1.3.2 & older). Fixes issue #911.
  • The "updateCache" method now accepts a tbody object.
  • Make getParsedText a public function.
  • Allow empty string in textExtraction data-attribute. Fixes issue #954.
• Docs
  • Update trigger sort method documentation.
  • Update information about cssIgnoreRow. See issue #911.
  • Add requirement to include .filter { display: none } in custom themes.
  • Improve Bootstrap example in column selector docs. See pull #935, thanks @Herst!
  • Clean up & corrections:
    • Code examples in math & editing demos.
    • Corrected comments in "Skip the parsing of column content" demo.
    • Fix HTML validation issues.
  • Add contributing.md link to JSCS formatting file by @Herst.
  • Update to Bootstrap v3.3.5.
• Parsers
  • Checkbox: add checkbox parser class name option (config.checkboxClass).
  • Metric: Support metric base unit case insensitivity.
• Editable
  • Allow Shift+Enter to create a new line (even with editable_enterToAccept set as true).
  • Update cache without requiring a hover over the thead; cache order now properly maintained on touch devices.
• Filter
  • Target last used filter properly. See issue #920.
  • filter_selectSource now ignores parsers, if none are set (empty or ajax tables). See issue #934.
  • Add support for nesting of "AND" & "OR" searches. Fixes issues #891 & #918.
  • Filter row remains visible after focused when filter_hideFilters is set.
  • Remove trailing comma in pull #948, thanks @Herst!
• Output
  • Allow empty string data-attributes. See issue #923.
  • output_saveRows now accepts jQuery filter selectors. See issue #923.
  • Fix hiddenColumns option causing an empty output. Fixes issue #923.
  • Prevent javascript error when no row data is passed. See issue #923.
  • Remove tfoot clone, instead concat data to the end.
  • Fix colspans and hidden columns.
  • Stop outputTable method propagation. Fixes issue #944.
• Pager
  • Make hasWidget think the pager addon is a widget.
  • Prevent adding a row if ajax returned JSON totalrows is zero. See Stackoverflow.
• RepeatHeaders
  • use selectorRemove option setting.
• Resizable
  • Replace window resize trigger. See issue #912.
  • Resizing now works with overflow wrapped tables. Fixes issue #953.
• Scroller
  • Fix added stylesheet error using "," instead of ";".
  • Remove colgroup & hidden elements in fixed columns.
  • Fix slow fixed column scrolling in Firefox. See issue #135.
  • Multiple tbody fix. See issues #906 & #913.
  • Limit horizontal scrollbar to scrolling section.
  • Removed widthFixed requirement.
  • Update RTL support.
  • Fix column alignment. Fixes issue #913.
  • Fix filter return zero to few rows.
  • Reduce init lag & correct no fixed column tbody width. See issue #906.
  • Fix mousewheel scrolling on fixed columns.
  • Cleanup & old IE fix.
  • Fix column alignment issues #940, #937, #931 & #927.
  • Throttle IE scrolling. Partially fixes issue #928.
  • Save scroll positioning. Fixes issues #926 & #932.
  • Integrate with:
    • pager. Fixes issue #884.
    • columnSelector. Fixes issue #905.
• SortTbodies (beta)
  • Add new widget to allow the sorting of tbodies based on a primary row.
  • Fixes pull #195 & issue #833.
  • Documentation & demo page added: http://mottie.github.io/tablesorter/docs/example-widget-sort-tbodies.html
• StickyHeaders
  • Replace window resize trigger. See issue #912.
  • Fix javascript error. See issue #920.
• Zebra
  • Target non-info block tbodies in extra tables.
• Grunt
  • Update grunt modules.
  • Remove moot "version" property from bower.json. See pull #941, thanks @kkirsche!
  • Don't update bower.json in Gruntfile.js.
  • Check for old IE issue in pull #949, thanks @Herst!

Version 2.22.1 (5/17/2015)

• Filter: fix issue with searches always looking for parsed content in numeric columns.

Version 2.22.0 (5/17/2015)

• Docs
  • Lots of minor version updates, spelling corrections & clarifications in wording.
  • Update box-sizing styles (ref).
  • Update characterEquivalents cross-reference to correctly match the code of the plugin.
  • Add Build table widget example resulting HTML for the json example.
• Grunt build
  • package.json files now points to the entire "dist" folder. See issue #881.
  • Add grunt quick build to only update widget & parser files; it skips updating the dates in the widgets & combined files.
• Core
  • The isDigit function now reports false on empty strings. See issue #865.
  • Add pointer events options (pointerClick, pointerDown and pointerUp). Fixes issue #885.
  • Prevent js error when using the computeColumnIndex function on empty tables (used by the math widget). Fixes issue #889.
  • Prevent js error when sortList includes an out-of-bounds column. Fixes issue #908.
  • Centralize extractor & parser code; this code is used by the main build cache loop and the "addRows" & "updateCell" methods.
  • Child row content is now properly stored in row data as an array of arrays.
  • Add "o" to sortLocaleCompare replacement table & update docs.
  • Replace all instances of using jQuery each with plain javascript. Fixes issue #827.
• Editable
  • Modify trimContent option & use HTML to modify text. Fixes issue #886.
  • Fix selectAll & change tbody mouseleave to complete editing to thead mouseenter. Fixes issue #848.
  • Only make table cell child div/span contenteditable. See issue #900.
  • Add remove widget code & allow dynamic updating if the "no-edit" class changes. Fixes issue #900.
• Filter
  • Regex filter searches now cache the created regex object for each query to optimize speed & a regex search now properly uses case-sensitive content
  • Add data parameter to filter_functions. This is the same data used by the filter search type functions. See issue #891.
  • Any match searches which target specific columns will no longer save each filter to its respective column; see "AnyMatch Searches" documentation.
  • Operator filter searchs now ignore empty strings (because "" < 10 is true).
  • Clean up parseFilter function.
  • Add filter_childByColumn option.
    • Setting this to true allows searching through the child rows by column.
    • When false, the search behaves as before and all child row content is included in the search of every column.
    • See a demo here.
    • Fixes issues #396 & #574.
  • Code cleanup - added a bunch of whitespace & forced line wraps at around 120.
  • Prevent setFilter function from setting the same filters after an update. Fixes issues #903 & #733.
• Grouping
  • Add keyboard accessibility to group headers. See issue #260.
• Math
  • Fix issues with isNaN('') // false. See issue #873.
  • Reapply column indexing after updates & prevent js error on empty tables. Fixes issue #889.
  • Reduce update time to 20ms. See issue #898.
  • Exclude ignored cells even if math_ignore is empty. Fixes issue #896.
• Output
  • Add BOM back to downloaded file. Fixes issue #862.
  • Add output_hiddenColumns option. Fixes issue #869.
  • Add known issues section about downloading in Safari.
• Pager (addon & widget)
  • Replace all instances of using jQuery each with plain javascript. Fixes issue #827.
• Resizable
  • Refreshing the widget will now preserve the storage. See issue #874.
• Scroller
  • Set overflow-x auto & apply border-box to scroller. See issue #135.
  • Remove pointer-events: none from fixed column. See issue #878.
  • Hide fixed column scrollbar in IE9 & older. See issue #135.
  • Update pointer-events and tabbing accessibility. See issue #135.
  • setFixedColumnSize now properly updates with no set size.
  • Add scroller_addFixedOverlay
    • When true, a fixed column overlay is added for additional styling. See issue #887.
    • It includes css pointer-events set to none to allow interaction with elements underneath; make sure your browser supports it!
  • Fix selector issue in the remove function.
  • Properly refresh column size after an update. Fixes the third part of issue #906.
• Parsers
  • Add "inputs-numeric" parser. Fixes issue #888.
  • Add jQuery Globalize date & number parsers.
  • "namedNumbers" parser: ignores adjacent puncutation. Fixes issue #890.
  • input-select parsers:
    • Clean up & add event namespaces.
    • Now return an empty string if the value is empty; previously, it would return the cell text when the value was empty.
  • Network "MAC" parser:
    • Return the original string if the address is grossly invalid. Fixes issue #895.
    • No longer auto-detect as iPv6. See issue #895.
• Themes
  • Declare font-weight separately. Thanks nikolas (pull #866)!
  • Update Boostrap v2.x theme, and add a Bootstrap v2.x demo.