mirror of
https://github.com/Mottie/tablesorter.git
synced 2024-11-15 23:54:22 +00:00
Github fork of Christian Bach's tablesorter plugin + awesomeness ~
addons/pager | ||
css | ||
docs | ||
js | ||
changelog.txt | ||
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
- Copyright (c) 2007 Christian Bach
- Main Examples and docs at: http://tablesorter.com
- Dual licensed under the MIT and GPL licenses:
###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 } });
- Updated the Dealing with markup inside cells demo.
- Thanks to Eugene Ivakhiv for bringing this issue to my attention in my blog.
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 theheaders
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 theheaders
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 anoutput
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
andcssDisabled
options:- When
pagerArrows
is true, the first and previous pager arrows have the css class name contained in thecssDisabled
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.
- When
- Removed the