Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Github fork of Christian Bach's tablesorter plugin: http://tablesorter.com

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 addons
Octocat-spinner-32 css
Octocat-spinner-32 docs
Octocat-spinner-32 js
Octocat-spinner-32 README.markdown
Octocat-spinner-32 changelog.txt
Octocat-spinner-32 index.html
README.markdown

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.12 (2011-08-19)

  • Updated the textExtraction functionality

    • The original textExtraction function was only able to be applied to all cells.
    • Apparently the ability to define textExtraction on a per column basis was misinterpreted by me, so now I've added it.
    • Use the option as follows:
    $("table").tablesorter({
     textExtraction: {
       0: function(node) { return $(node).find(selector1).text(); },
       1: function(node) { return $(node).find(selector2).text(); },
       // etc
     }
    });
    

Version 2.0.11 (2011-08-04)

  • Added the ability to set a column parser using a class name
    • When setting the parser, start the class name with "sorter-" followed by the parser name, e.g. "sorter-text" or "sorter-digit"
    • The column can be disabled by setting the class name to "sorter-false"
    • Demo page included.
    • Custom parsers can also be used - see the updated writing custom parsers demo.

Version 2.0.10 (2011-07-31)

  • Modified the numeric sort with a new method to deal with non-numeric content:
    • When sorting columns with numeric values, by default any non-numeric or empty cells are treated as if they have a zero value. This puts the text between negative and positive values in a column.
    • Adding string : "max+" to the headers option will now treat any non-numeric table cells as if they have a maxiumum positive value (a value greater than the maximum positive value in the column).
    • Adding string : "max-" to the headers option will now treat any non-numeric table cells as if they have a maxiumum negative value (a value greater than the maximum negative value in the column).
    • See the "Dealing with text strings in numeric sorts" demo for a better visual example.
  • Changed UI theme widget code to use "ui-widget-header" instead of "ui-widget-default" to better match the themes.
  • Renamed changelog.markdown to changelog.txt to prevent downloading when clicking on the link

Version 2.0.9 (2011-07-27)

  • Added a jQuery UI theme and widget example. To apply the jQuery UI theme:
    • Include any jQuery UI theme on your page.
    • Add the base tablesorter ui theme (located in css/ui directory)
    • Add the jQuery UI theme widget code found on this example page. This demo page includes the UI theme switcher.
  • Added a header index to the onRenderHeader function to make it easier to target specific header cells for modification. See the render header example for an example.
  • Pager plugin updates:
    • Removed the separator option and added an output option which allows you to completely customize the output string.
    • In the output string, include any of the following variables:
      • {page} is replaced with the current page number.
      • {totalPages} is replaced with the total number of pages.
      • {startRow} is replaced with the number of the visible start row of the pager.
      • {endRow} is replaced with the number of the visible end row of the pager.
      • {totalRows} is replaced with the total number of rows.
    • The cssPageDisplay option can now target any element; in previous versions, this element was an input of type text.
    • Added a pagerArrows and cssDisabled options:
      • When pagerArrows is true, the first and previous pager arrows have the css class name contained in the cssDisabled option applied when the first row is visible.
      • The next and last pager arrows will be have the cssDisabled class applied when the last row is visible.
      • Additionally, if the number of table rows is less than the pager size, the pager will get the cssDisabled class name applied.
      • If false (the default setting), the pager arrows class names will not change.
      • Please see the updated pager demo to see this working.
Something went wrong with that request. Please try again.