library-mirrors/tablesorter
1
0
Fork 0
mirror of https://github.com/Mottie/tablesorter.git synced 2024-11-15 23:54:22 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

doc updates & version bump

Browse Source
This commit is contained in:
Mottie 2013-05-27 08:38:55 -05:00
parent 17ebc25fbb
commit f721cef683
13 changed files with 115 additions and 50 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

99
README.md
View File

@ -1,9 +1,9 @@
tablesorter is a jQuery plugin for turning a standard HTML table with THEAD and TBODY tags into a sortable table without page refreshes. 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. tablesorter can successfully parse and sort many types of data including linked data in a cell.
### [Documentation](http://mottie.github.com/tablesorter/docs/) ### [Documentation](http://mottie.github.io/tablesorter/docs/)
* See the [full documentation](http://mottie.github.com/tablesorter/docs/). * See the [full documentation](http://mottie.github.io/tablesorter/docs/).
* All of the [original document pages](http://tablesorter.com/docs/) have been included. * All of the [original document pages](http://tablesorter.com/docs/) have been included.
* Information from my blog post on [undocumented options](http://wowmotty.blogspot.com/2011/06/jquery-tablesorter-missing-docs.html) and lots of new demos have also been included. * Information from my blog post on [undocumented options](http://wowmotty.blogspot.com/2011/06/jquery-tablesorter-missing-docs.html) and lots of new demos have also been included.
* Change log moved from included text file into the [wiki documentation](https://github.com/Mottie/tablesorter/wiki/Change). * Change log moved from included text file into the [wiki documentation](https://github.com/Mottie/tablesorter/wiki/Change).
@ -11,17 +11,17 @@ tablesorter can successfully parse and sort many types of data including linked
### Demos ### Demos
* [Basic alpha-numeric sort Demo](http://mottie.github.com/tablesorter/). * [Basic alpha-numeric sort Demo](http://mottie.github.com/tablesorter/).
* Links to demo pages can be found within the main [documentation](http://mottie.github.com/tablesorter/docs/). * Links to demo pages can be found within the main [documentation](http://mottie.github.io/tablesorter/docs/).
* More demos & playgrounds - updated in the [wiki pages](https://github.com/Mottie/tablesorter/wiki). * More demos & playgrounds - updated in the [wiki pages](https://github.com/Mottie/tablesorter/wiki).
### Features ### Features
* Multi-column alphanumeric sorting. * Multi-column alphanumeric sorting.
* Multi-tbody sorting - see the [options](http://mottie.github.com/tablesorter/docs/index.html#options) table on the main document page. * Multi-tbody sorting - see the [options](http://mottie.github.io/tablesorter/docs/index.html#options) table on the main document page.
* Parsers for sorting text, alphanumeric text, URIs, integers, currency, floats, IP addresses, dates (ISO, long and short formats) & time. [Add your own easily](http://mottie.github.com/tablesorter/docs/example-parsers.html). * Parsers for sorting text, alphanumeric text, URIs, integers, currency, floats, IP addresses, dates (ISO, long and short formats) & time. [Add your own easily](http://mottie.github.io/tablesorter/docs/example-parsers.html).
* Support for ROWSPAN and COLSPAN on TH elements. * Support for ROWSPAN and COLSPAN on TH elements.
* Support secondary "hidden" sorting (e.g., maintain alphabetical sort when sorting on other criteria). * Support secondary "hidden" sorting (e.g., maintain alphabetical sort when sorting on other criteria).
* Extensibility via [widget system](http://mottie.github.com/tablesorter/docs/example-widgets.html). * Extensibility via [widget system](http://mottie.github.io/tablesorter/docs/example-widgets.html).
* Cross-browser: IE 6.0+, FF 2+, Safari 2.0+, Opera 9.0+. * Cross-browser: IE 6.0+, FF 2+, Safari 2.0+, Opera 9.0+.
* Small code size. * Small code size.
* Works with jQuery 1.2.6+ (jQuery 1.4.1+ needed with some widgets). * Works with jQuery 1.2.6+ (jQuery 1.4.1+ needed with some widgets).
@ -43,6 +43,73 @@ tablesorter can successfully parse and sort many types of data including linked
View the [complete listing here](https://github.com/Mottie/tablesorter/wiki/Change). View the [complete listing here](https://github.com/Mottie/tablesorter/wiki/Change).
#### <a name="v2.10.1">Version 2.10.1</a> (5/14/2013)
* Core fixes
* Fixed `updateAll` function to properly refresh the widgets.
* Added keyboard accessibility
* Header cells can now be accessed using the tab key and sorted by pressing enter when they have "focus".
* Thanks to [debugwand](https://github.com/debugwand) for sharing the code!
* Filter widget updates:
* Added `filter_onlyAvail` option
* Updated main &amp; filter demo page docs.
* Updated [custom filter demo](http://mottie.github.io/tablesorter/docs/example-widget-filter-custom.html) (see the Discount column).
* Fixes [issue #292](https://github.com/Mottie/tablesorter/issues/292).
* Thanks to [The Sin-](https://github.com/TheSin-) for sharing the idea and code!
* Added `compare` option to various filter formatter functions
* This addition was made to the "uiSpinner", "uiSlider", "html5Range", "html5Number" and the new "uiDateCompare" functions
* So, for example the html5Number function can be set up as follows:
```js
filter_formatter : {
0: function($cell, indx) {
return $.tablesorter.filterFormatter.html5Number( $cell, indx, {
value: 1,
min: 1,
max: 100,
delay: true,
addToggle: false,
exactMatch: false,
compare: '>='
})
}
}
```
now the number type input will allow filtering rows with values greater than or equal to the selected value.
* Thanks to [The Sin-](https://github.com/TheSin-) for sharing the idea and code in [issue #304](https://github.com/Mottie/tablesorter/issues/304).
* The jQuery UI Datepicker range filter formatter code has been updated:
* Use the new `uiDateCompare` filter formatter for one input comparisons, or use this `uiDatepicker` update to do comparisons within the two inputs.
* The two input now functions so that when the "to" input is empty, all dates greater than the "from" date are shown.
* If the "from" input is empty, all dates less than the "to" input date are shown.
* Added options `textFrom` (default is `from`) and `textTo` (default is `to`) to allow changing the text label language.
* Modified the logical "or" search such that it tries to find an exact match for each "or". For example:
* If `"1|2|3"` is entered into the filter, only column cells that exactly match `1`, `2`, or `3` will be visible.
* If `"Mike|Br|John"` is entered, only cells with `Mike`, `Br` and `John` will be visible. If you want to include `Bruce`, then use a wild card: `"Mike|Br*|John"`.
* To only match content using the logical "or" search, simply add the class name `filter-match` to the header cell, then `"1|2|3"` will show cells with `1`, `11`, `12`, etc.
* Updated the [basic filter widget demo](http://mottie.github.io/tablesorter/docs/example-widget-filter.html) to include a "filter-match" column toggle.
* Fixed javascript error from improper reference to the "dateFormat". Fixes [issue #306](https://github.com/Mottie/tablesorter/issues/306).
* Fixed `$.tablesorter.getFilters()` and `$.tablesorter.setFilters()` functions to work properly when the `filter_columnFilters` option is `false` (do not build filter row).
* Fixed filter widget numeric range error introduces in v2.10.0. Sorry =(.
* Fixed filter search delay issue, again. =(
* Fixed filter widget data comparisons, so now you can type in the filter something like `> 1/1/2010` (using the same date format as the column).
* Filter search input placeholders can now be set using jQuery data:
* Previously, only a data attribute could contain the filter placeholder text `data-placeholder="Enter something..."`
* Another method using script can now be used: `$('.tablesorter th:eq(0)').data('placeholder', 'Enter something...');` (where `eq()` contains a zero-based index of the column).
* Optimized filter queries to search already filtered rows if the previous search is contained within the current search. Fulfills part of [issue #313](https://github.com/Mottie/tablesorter/issues/313).
* Added a caution note in the filter widget (basic) demo stating the issue with Chrome not rendering search input text properly when previously hidden.
* For now, I set the `filter_hideFilters` option to `false` until the source of this problem is determined.
* Check out [this demo](http://jsfiddle.net/Mottie/Mjbab/1/) to see the issue (in Chrome); but I think I'm the only one seeing it.
* Updated the `$.tablesorter.storage()` function
* The update is to checking for localStorage browser support.
* It should now work properly in iOS with private browsing protection.
* Check out [this great summary](https://gist.github.com/paulirish/5558557) of [Modernizr](http://modernizr.com/) updates by Paul Irish.
* Documentation fixes
* Removed `console.log` from the documentation script. Fixes [issue #309](https://github.com/Mottie/tablesorter/issues/309).
* Updated all `<button>` elements in the documentation to include a type (`<button type="button">`) to prevent IE from triggering a form submit. Fixes [issue #285](https://github.com/Mottie/tablesorter/issues/285#issuecomment-17991235).
#### <a name="v2.10">Version 2.10</a> (5/8/2013) #### <a name="v2.10">Version 2.10</a> (5/8/2013)
* Core changes: * Core changes:
@ -151,7 +218,7 @@ View the [complete listing here](https://github.com/Mottie/tablesorter/wiki/Chan
// and no need to trigger an update method, it's done internally // and no need to trigger an update method, it's done internally
return [ total, $(rows), headers ]; return [ total, $(rows), headers ];
} }
}, }
``` ```
* Build the table yourself (just return the total number of rows): * Build the table yourself (just return the total number of rows):
@ -182,7 +249,7 @@ View the [complete listing here](https://github.com/Mottie/tablesorter/wiki/Chan
table.config.$tbodies.eq(0).html(rows); table.config.$tbodies.eq(0).html(rows);
return [ total ]; return [ total ];
} }
}, }
``` ```
* Tablesorter unit testing updates; tests for the following have been added: * Tablesorter unit testing updates; tests for the following have been added:
@ -225,7 +292,7 @@ View the [complete listing here](https://github.com/Mottie/tablesorter/wiki/Chan
* The `uitheme` widget is the first to be applied (priority of `10`) because other widgets that copy/clone the table will need the jQuery UI/Bootstrap class names already applied to the table. * The `uitheme` widget is the first to be applied (priority of `10`) because other widgets that copy/clone the table will need the jQuery UI/Bootstrap class names already applied to the table.
* The sticky headers widget (priority `60`) is applied after the filter widget (priority `50`), so that it knows to update the filters within the sticky header. * The sticky headers widget (priority `60`) is applied after the filter widget (priority `50`), so that it knows to update the filters within the sticky header.
* Priorities are *optional*, and any widget applied without a priority value will automatically be assigned a priority of `10`. * Priorities are *optional*, and any widget applied without a priority value will automatically be assigned a priority of `10`.
* Updated the [writing custom widgets](http://mottie.github.com/tablesorter/docs/example-widgets.html) demo to show how to add a widget priority. * Updated the [writing custom widgets](http://mottie.github.io/tablesorter/docs/example-widgets.html) demo to show how to add a widget priority.
* I was planning on adding this in version 3.0, but the need arose sooner with the additions of all of the new widgets. * I was planning on adding this in version 3.0, but the need arose sooner with the additions of all of the new widgets.
* **Updated Filter widget** * **Updated Filter widget**
@ -247,7 +314,7 @@ View the [complete listing here](https://github.com/Mottie/tablesorter/wiki/Chan
* **Updated Resizable widget** * **Updated Resizable widget**
* Added `resizable_addLastColumn` option which allows you to make the last column resizable, essentially making a non-full width table resizable. * Added `resizable_addLastColumn` option which allows you to make the last column resizable, essentially making a non-full width table resizable.
* Updated [the resizable demo](http://mottie.github.com/tablesorter/docs/example-widget-resizable.html) to show this option. * Updated [the resizable demo](http://mottie.github.io/tablesorter/docs/example-widget-resizable.html) to show this option.
* The resizable demo also now highlights the non-resizable "Age" column to make it more obvious. * The resizable demo also now highlights the non-resizable "Age" column to make it more obvious.
* **Updated Sticky headers widget** * **Updated Sticky headers widget**
@ -289,10 +356,10 @@ View the [complete listing here](https://github.com/Mottie/tablesorter/wiki/Chan
``` ```
* Make a table cell uneditable by added the class `no-edit`, set in the `editable_noEdit` option. * Make a table cell uneditable by added the class `no-edit`, set in the `editable_noEdit` option.
* Added a [content editable widget demo](http://mottie.github.com/tablesorter/docs/example-widget-editable.html). * Added a [content editable widget demo](http://mottie.github.io/tablesorter/docs/example-widget-editable.html).
* **Added Repeat headers widget** * **Added Repeat headers widget**
* This widget has always been the example used in the [Writing custom widgets](http://mottie.github.com/tablesorter/docs/example-widgets.html) demo. * This widget has always been the example used in the [Writing custom widgets](http://mottie.github.io/tablesorter/docs/example-widgets.html) demo.
* It has been updated and now follows the same format as the widget template for tablesorter version 2.9+ * It has been updated and now follows the same format as the widget template for tablesorter version 2.9+
* As written, it will no longer work with tablesorter versions older than 2.8. * As written, it will no longer work with tablesorter versions older than 2.8.
* Only one option for this widget is available: * Only one option for this widget is available:
@ -322,10 +389,10 @@ View the [complete listing here](https://github.com/Mottie/tablesorter/wiki/Chan
}); });
``` ```
* Added a [scroller widget demo](http://mottie.github.com/tablesorter/docs/example-widget-scroller.html). * Added a [scroller widget demo](http://mottie.github.io/tablesorter/docs/example-widget-scroller.html).
* **Updated Pager Plugin** * **Updated Pager Plugin**
* Added all pager plugin options within the [widget options table](http://mottie.github.com/tablesorter/docs/index.html#Widget-options) on the main documentation page. * Added all pager plugin options within the [widget options table](http://mottie.github.io/tablesorter/docs/index.html#Widget-options) on the main documentation page.
* Added a better example of how to use the `customAjaxUrl` function. * Added a better example of how to use the `customAjaxUrl` function.
* Updated the `{page}` tag used withing the `ajaxUrl` option: * Updated the `{page}` tag used withing the `ajaxUrl` option:
* Previously `{page}` was replaced with a zero-based index of the targetted page number, now this format can also be used `{page+1}`. * Previously `{page}` was replaced with a zero-based index of the targetted page number, now this format can also be used `{page+1}`.
@ -341,7 +408,7 @@ View the [complete listing here](https://github.com/Mottie/tablesorter/wiki/Chan
* **General documentation cleanup &amp; updates** * **General documentation cleanup &amp; updates**
* Grouping widget corrections * Grouping widget corrections
* Updated the [repeat headers widget](http://mottie.github.com/tablesorter/docs/example-widgets.html) to use the newest widget template. * Updated the [repeat headers widget](http://mottie.github.io/tablesorter/docs/example-widgets.html) to use the newest widget template.
#### <a name="v2.8.2">Version 2.8.2</a> (3/28/2013) #### <a name="v2.8.2">Version 2.8.2</a> (3/28/2013)
@ -349,7 +416,7 @@ View the [complete listing here](https://github.com/Mottie/tablesorter/wiki/Chan
* Renamed the parser to "ignore-articles" * Renamed the parser to "ignore-articles"
* Added language support and a few languages * Added language support and a few languages
* Added a method to add custom articles. * Added a method to add custom articles.
* Please see the [updated demo](http://mottie.github.com/tablesorter/docs/example-parsers-ignore-articles.html) (also renamed) * Please see the [updated demo](http://mottie.github.io/tablesorter/docs/example-parsers-ignore-articles.html) (also renamed)
* Thanks for [thezoggy](https://github.com/thezoggy) for feedback. * Thanks for [thezoggy](https://github.com/thezoggy) for feedback.
* Fixed a bug in the grouping widget demo: * Fixed a bug in the grouping widget demo:
* The "priority (letter)" column was incorrectly parsing the data which, for some reason, worked in some browsers. * The "priority (letter)" column was incorrectly parsing the data which, for some reason, worked in some browsers.

2
component.json
View File

@ -1,6 +1,6 @@
{ {
"name": "tablesorter", "name": "tablesorter",
"version": "2.10.0", "version": "2.10.1",
"dependencies": { "dependencies": {
"jquery": ">=1.2.6" "jquery": ">=1.2.6"
} }

9
css/filter.formatter.css
View File

@ -92,12 +92,6 @@
top: 3px; top: 3px;
display: inline-block; display: inline-block;
} }
.tablesorter .color-controls-wrapper .button {
top: -5px;
}
.tablesorter .color-controls-wrapper .currentColor {
top: -8px;
}
.tablesorter .button label { .tablesorter .button label {
cursor: pointer; cursor: pointer;
@ -112,6 +106,7 @@
-webkit-box-shadow: inset 0px 1px 1px rgba(0,0,0,0.5), 0px 1px 0px rgba(255,255,255,1); -webkit-box-shadow: inset 0px 1px 1px rgba(0,0,0,0.5), 0px 1px 0px rgba(255,255,255,1);
-moz-box-shadow: inset 0px 1px 1px rgba(0,0,0,0.5), 0px 1px 0px rgba(255,255,255,1); -moz-box-shadow: inset 0px 1px 1px rgba(0,0,0,0.5), 0px 1px 0px rgba(255,255,255,1);
box-shadow: inset 0px 1px 1px rgba(0,0,0,0.5), 0px 1px 0px rgba(255,255,255,1); box-shadow: inset 0px 1px 1px rgba(0,0,0,0.5), 0px 1px 0px rgba(255,255,255,1);
background: #45484d;
background: -webkit-linear-gradient(top, #222 0%, #45484d 100%); background: -webkit-linear-gradient(top, #222 0%, #45484d 100%);
background: -moz-linear-gradient(top, #222 0%, #45484d 100%); background: -moz-linear-gradient(top, #222 0%, #45484d 100%);
background: -o-linear-gradient(top, #222 0%, #45484d 100%); background: -o-linear-gradient(top, #222 0%, #45484d 100%);
@ -128,7 +123,7 @@
position: absolute; position: absolute;
width: 8px; width: 8px;
height: 8px; height: 8px;
background: #00bf00; background: #55f;
background: -webkit-linear-gradient(top, #aaf 0%, #55f 100%); background: -webkit-linear-gradient(top, #aaf 0%, #55f 100%);
background: -moz-linear-gradient(top, #aaf 0%, #55f 100%); background: -moz-linear-gradient(top, #aaf 0%, #55f 100%);
background: -o-linear-gradient(top, #aaf 0%, #55f 100%); background: -o-linear-gradient(top, #aaf 0%, #55f 100%);

3
docs/css/jq.css
View File

@ -50,7 +50,8 @@ table, p.small {font-size:small;}
p.small {padding-left: 25px;} p.small {padding-left: 25px;}
p.tip em, div.tip em {padding: 2px; background-color: #6cf; color: #fff;} p.tip em, div.tip em {padding: 2px; background-color: #6cf; color: #fff;}
span.tip em {padding: 0 2px;background-color: #00ce53; color: #fff; font-size:90%; } span.tip em {padding: 0 2px;background-color: #00ce53; color: #fff; font-size:90%; }
span.tip.old em { background-color: #ce5300;} span.tip.old em { background-color: #cfd; color: #000; }
span.warn em { background-color: #ce5300; }
div.digg {float: right;} div.digg {float: right;}
.next-up { padding-top: 10px; font-size: 90%; } .next-up { padding-top: 10px; font-size: 90%; }
.narrow-block { width: 50%; margin: 50px auto; } .narrow-block { width: 50%; margin: 50px auto; }

2
docs/example-widget-filter-formatter-1.html
View File

@ -62,7 +62,7 @@
// add any of the jQuery UI Slider options here // add any of the jQuery UI Slider options here
value : 1, value : 1,
min : 1, min : 1,
max : 15, max : 65,
delayed : false, delayed : false,
valueToHeader : false, valueToHeader : false,
exactMatch : false, exactMatch : false,

7
docs/example-widget-filter.html
View File

@ -71,7 +71,7 @@
// if true, filters are collapsed initially, but can be revealed by hovering over the grey bar immediately // if true, filters are collapsed initially, but can be revealed by hovering over the grey bar immediately
// below the header row. Additionally, tabbing through the document will open the filter row when an input gets focus // below the header row. Additionally, tabbing through the document will open the filter row when an input gets focus
filter_hideFilters : true, filter_hideFilters : false, // true, (see note in the options section above)
// Set this option to false to make the searches case sensitive // Set this option to false to make the searches case sensitive
filter_ignoreCase : true, filter_ignoreCase : true,
@ -113,6 +113,7 @@
txt = $(this).data('filter-text'); // text to add to filter txt = $(this).data('filter-text'); // text to add to filter
filters[col] = txt; filters[col] = txt;
// using "table.hasFilters" here to make sure we aren't targetting a sticky header
$.tablesorter.setFilters( $('table.hasFilters'), filters, true ); // new v2.9 $.tablesorter.setFilters( $('table.hasFilters'), filters, true ); // new v2.9
/** old method (prior to tablsorter v2.9 *** /** old method (prior to tablsorter v2.9 ***
@ -222,7 +223,7 @@ $(function(){
<li><code>filter_filteredRow : 'filtered'</code> - css class name added to filtered rows (rows that are not showing); needed by pager plugin.</li> <li><code>filter_filteredRow : 'filtered'</code> - css class name added to filtered rows (rows that are not showing); needed by pager plugin.</li>
<li><code>filter_formatter : null</code> - add custom filter elements to the filter row.</li> <li><code>filter_formatter : null</code> - add custom filter elements to the filter row.</li>
<li><code>filter_functions : null</code> - add custom filter functions using this option.</li> <li><code>filter_functions : null</code> - add custom filter functions using this option.</li>
<li><code>filter_hideFilters : false</code> - if true, filters are hidden initially, but can be revealed by clicking on the filter icon.</li> <li><code>filter_hideFilters : false</code> - if true, filters are hidden initially, but can be revealed by clicking on the filter icon <span class="remark">*</span>.</li>
<li><code>filter_ignoreCase : true</code> - if true, make all searches case-insensitive.</li> <li><code>filter_ignoreCase : true</code> - if true, make all searches case-insensitive.</li>
<li><code>filter_liveSearch : true</code> - if true, search column content while the user types (with a delay). If false, the user must press enter to start the search. If set to a number, when the length of the input text reaches this minimum length, a search will initiate.</li> <li><code>filter_liveSearch : true</code> - if true, search column content while the user types (with a delay). If false, the user must press enter to start the search. If set to a number, when the length of the input text reaches this minimum length, a search will initiate.</li>
<li><code>filter_onlyAvail : 'filter-onlyAvail'</code> - a header with a select dropdown &amp; this class name will only show available (visible) options within that drop down.</li> <li><code>filter_onlyAvail : 'filter-onlyAvail'</code> - a header with a select dropdown &amp; this class name will only show available (visible) options within that drop down.</li>
@ -232,6 +233,7 @@ $(function(){
<li><code>filter_startsWith : false</code> - if true, filter start from the beginning of the cell contents.</li> <li><code>filter_startsWith : false</code> - if true, filter start from the beginning of the cell contents.</li>
<li><code>filter_useParsedData : false</code> - filter all data using parsed content.</li> <li><code>filter_useParsedData : false</code> - filter all data using parsed content.</li>
</ul> </ul>
<span class="alert">Caution</span>: In my testing, it appears that Chrome does not properly render a previously hidden search input text properly (<a href="http://jsfiddle.net/Mottie/Mjbab/1/">demo</a>), so for now, I'm changing this demo's <code>filter_hideFilters</code> option to <code>false</code> until the source of this problem is determined.
</div> </div>
<h3><a href="#">Classes</a></h3> <h3><a href="#">Classes</a></h3>
@ -314,6 +316,7 @@ $.tablesorter.setFilters( $('table'), [ '', '', '', '', '', '2?%' ], true );</pr
<table class="tablesorter"> <table class="tablesorter">
<thead> <thead>
<tr> <tr>
<!-- you can also add a placeholder using script; $('.tablesorter th:eq(0)').data('placeholder', 'hello') -->
<th data-placeholder="" class="filter-false">Rank</th> <th data-placeholder="" class="filter-false">Rank</th>
<th data-placeholder="Try B*{space} or alex|br*|c" class="filter-match">First Name (<span></span> filter-match )</th> <th data-placeholder="Try B*{space} or alex|br*|c" class="filter-match">First Name (<span></span> filter-match )</th>
<th data-placeholder="Try <d">Last Name</th> <th data-placeholder="Try <d">Last Name</th>

3
docs/example-widgets.html
View File

@ -96,13 +96,14 @@
<li>Set the widget priority using any number; think of it like setting the css z-index.</li> <li>Set the widget priority using any number; think of it like setting the css z-index.</li>
<li>This tells the plugin the order in which to run the widgets, lowest number priority first.</li> <li>This tells the plugin the order in which to run the widgets, lowest number priority first.</li>
<li>The default widgets have priorities set in intervals of 10 (see the <a href="index.html#Widget-options"> widget priority table</a>), so to run your custom widget before a specific widget, set your widget priority to less than that number.</li> <li>The default widgets have priorities set in intervals of 10 (see the <a href="index.html#Widget-options"> widget priority table</a>), so to run your custom widget before a specific widget, set your widget priority to less than that number.</li>
<li>If no priority is specified, it defaults to <code>10</code>.</li>
</ul> </ul>
</li> </li>
<li>The <code>options</code> block (<span class="version">v2.8</span>): <li>The <code>options</code> block (<span class="version">v2.8</span>):
<ul> <ul>
<li>Include any widget options to be automatically be extended with any set widgetOptions (from <code>table.config.widgetOptions</code>).</li> <li>Include any widget options to be automatically be extended with any set widgetOptions (from <code>table.config.widgetOptions</code>).</li>
<li>This block was added in tablesorter v2.8 and is not supported in older versions!</li> <li>This block was added in tablesorter v2.8 and is not supported in older versions!</li>
<li>As of v2.8, no included widgets will be using this to maintain backwards compatibility with older versions. This will change when v3.0 is released.</li> <li>As of v2.8, no included widgets will be using this to maintain backwards compatibility with older versions. This changed when v2.9 was released.</li>
<li>This block is optional.</li> <li>This block is optional.</li>
</ul> </ul>
</li> </li>

6
docs/js/docs.js
View File

@ -92,10 +92,12 @@ function showProperty(){
if (h === '#csschildrow') { if (h === '#csschildrow') {
$('#root .tablesorter-childRow').show(); $('#root .tablesorter-childRow').show();
} }
// move below sticky header // move below sticky header; added delay as there could be some lag
setTimeout(function(){
if (/options/.test(prop.closest('table').attr('id') || '')) { if (/options/.test(prop.closest('table').attr('id') || '')) {
$(window).scrollTop( prop.position().top - 30 ); $(window).scrollTop( prop.position().top - 28 );
} }
}, 200);
} }
} }
} }

8
js/jquery.tablesorter.js
View File

@ -746,7 +746,7 @@
e.stopPropagation(); e.stopPropagation();
var i, rows = $row.filter('tr').length, var i, rows = $row.filter('tr').length,
dat = [], l = $row[0].cells.length, dat = [], l = $row[0].cells.length,
tbdy = $this.find('tbody').index( $row.closest('tbody') ); tbdy = $this.find('tbody').index( $row.parents('tbody').filter(':last') );
// fixes adding rows to an empty table - see issue #179 // fixes adding rows to an empty table - see issue #179
if (!c.parsers) { if (!c.parsers) {
buildParserCache(table); buildParserCache(table);
@ -1390,11 +1390,7 @@
format: function(s, table, cell, cellIndex) { format: function(s, table, cell, cellIndex) {
if (s) { if (s) {
var c = table.config, ci = c.headerList[cellIndex], var c = table.config, ci = c.headerList[cellIndex],
format = ci.dateFormat; format = ci.dateFormat || ts.getData( ci, c.headers[cellIndex], 'dateFormat') || c.dateFormat;
if (typeof format === 'undefined') {
// cache header formatting so it doesn't getData for every cell in the column
format = ci.dateFormat = ts.getData( ci, c.headers[cellIndex], 'dateFormat') || c.dateFormat;
}
s = s.replace(/\s+/g," ").replace(/[\-.,]/g, "/"); // escaped - because JSHint in Firefox was showing it as an error s = s.replace(/\s+/g," ").replace(/[\-.,]/g, "/"); // escaped - because JSHint in Firefox was showing it as an error
if (format === "mmddyyyy") { if (format === "mmddyyyy") {
s = s.replace(/(\d{1,2})[\/\s](\d{1,2})[\/\s](\d{4})/, "$3/$1/$2"); s = s.replace(/(\d{1,2})[\/\s](\d{1,2})[\/\s](\d{4})/, "$3/$1/$2");

6
js/jquery.tablesorter.widgets-filter-formatter.js
View File

@ -186,7 +186,7 @@ $.tablesorter.filterFormatter = {
range = val[0] === o.min && val[1] === o.max ? '' : val[0] + ' - ' + val[1]; range = val[0] === o.min && val[1] === o.max ? '' : val[0] + ' - ' + val[1];
if (o.valueToHeader) { if (o.valueToHeader) {
// add range indication to the header cell above (if not using the css method)! // add range indication to the header cell above (if not using the css method)!
$cell.closest('thead').find('th[data-column=' + indx + ']').find('.currange').html(' (' + range + ')'); $cell.closest('thead').find('th[data-column=' + indx + ']').find('.currange').html(' (' + val[0] + ' - ' + val[1] + ')');
} else { } else {
// add values to the handle data-value attribute so the css tooltip will work properly // add values to the handle data-value attribute so the css tooltip will work properly
$cell.find('.ui-slider-handle') $cell.find('.ui-slider-handle')
@ -231,7 +231,7 @@ $.tablesorter.filterFormatter = {
}, },
/*************************\ /*************************\
jQuery UI Datepicker compare (1 inputs) jQuery UI Datepicker compare (1 input)
\*************************/ \*************************/
uiDateCompare: function($cell, indx, defDate) { uiDateCompare: function($cell, indx, defDate) {
var o = $.extend({ var o = $.extend({
@ -413,7 +413,7 @@ $.tablesorter.filterFormatter = {
rangeSupported = $range.attr('type') === 'range' && $range.val() !== 'test', rangeSupported = $range.attr('type') === 'range' && $range.val() !== 'test',
updateRange = function(){ updateRange = function(){
/*jshint eqeqeq:false */ /*jshint eqeqeq:false */
var v = $cell.find('.range').val(); console.log(v, v == o.min); var v = $cell.find('.range').val();
$cell.find('input[type=hidden]') $cell.find('input[type=hidden]')
// add equal to the beginning, so we filter exact numbers // add equal to the beginning, so we filter exact numbers
.val( ( o.compare ? o.compare + v : (v == o.min ? '' : (o.exactMatch ? '=' : '') + v ) ) ) .val( ( o.compare ? o.compare + v : (v == o.min ? '' : (o.exactMatch ? '=' : '') + v ) ) )

2
package.json
View File

@ -1,7 +1,7 @@
{ {
"name": "tablesorter", "name": "tablesorter",
"title": "tablesorter", "title": "tablesorter",
"version": "2.10.0", "version": "2.10.1",
"description": "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.\n\nThis 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.", "description": "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.\n\nThis 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.",
"author": { "author": {
"name": "Christian Bach", "name": "Christian Bach",

2
tablesorter.jquery.json
View File

@ -1,7 +1,7 @@
{ {
"name": "tablesorter", "name": "tablesorter",
"title": "tablesorter", "title": "tablesorter",
"version": "2.10.0", "version": "2.10.1",
"description": "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.\n\nThis 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.", "description": "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.\n\nThis 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.",
"author": { "author": {
"name": "Christian Bach", "name": "Christian Bach",

4
test.html
View File

@ -259,11 +259,11 @@
c1.sortLocaleCompare = true; c1.sortLocaleCompare = true;
c1.ignoreCase = false; c1.ignoreCase = false;
c1.usNumberFormat = false; c1.usNumberFormat = false;
th0.shortDateFormat = c1.dateFormat = "ddmmyyyy"; th0.dateFormat = c1.dateFormat = "ddmmyyyy";
report(sample2); report(sample2);
c1.usNumberFormat = true; c1.usNumberFormat = true;
th0.shortDateFormat = c1.dateFormat = "yyyymmdd"; th0.dateFormat = c1.dateFormat = "yyyymmdd";
report(sample3); report(sample3);
// undocumented sortValue // undocumented sortValue