tablesorter/README.markdown
2011-07-21 23:40:00 -05:00

2.9 KiB

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.

See Alpha-numeric sort Demo & Full Documentation

###Features

  • Multi-column sorting.
  • Parsers for sorting text, alphanumeric text, URIs, integers, currency, floats, IP addresses, dates (ISO, long and short formats), time. Add your own easily
  • 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+.
  • Small code size.
  • Works with jQuery 1.2.3+

###Documentation

Included all original document pages with updates from my blog post on undocumented options.

###Licensing

###Change Log

View the complete listing here.

Version 2.0.8 (2011-07-21)

  • Fixed parsers for currency and digits to work with number values separated by commas. Thanks to Josh Renaud for the information!
  • Fixed "lockedOrder" header option and added documentation and an example on how to use it.
  • Made the sort order "desc" only trigger off of the first letter, so any word/abbreviation starting with "d" will set the descending sort order, all other letters will set the order to ascending (shhh, because I'm a bad speller :P)
  • Modified the "sortInitialOrder" option so it can also be set in the headers option.

Version 2.0.7 (2011-07-17)

  • Added "pagerChange" and "pagerComplete" events to the pager plugin which trigger on the table. See the pager demo for an example on how to bind to them.
  • Added the "sortAppend" since the option was there, but apparently the code wasn't.
  • Added missing documentation from my blog post
  • This included a few new example pages: apply widgets, child rows, render header, sort append and zebra widget.
  • Added a methods and events table.
  • Fixed the minified version. Apparently sorting functions called by the eval were removed by the Google Closure Compiler. Resolved by using "Whitespace only" optimization.
  • Fixed syntax highlighting; updated Chili.