diff --git a/README.md b/README.md index bc5a671a..856b31f1 100644 --- a/README.md +++ b/README.md @@ -47,6 +47,62 @@ tablesorter can successfully parse and sort many types of data including linked View the [complete listing here](https://github.com/Mottie/tablesorter/wiki/Change). +#### Version 2.15.6 (3/7/2014) + +* Doc + * Added docs for `$.tablesorter.language` which contains the text used in the `aria-label` for the header + * Update `isValueInArray` & `sortAppend` docs. + +* Core + * Destroy now unbinds the `updateCache` method properly + * Update `$.tablesorter.isValueInArray` function & `sortAppend` option. Fixes [issue #523](https://github.com/Mottie/tablesorter/issues/523). + * All test dates are now time zone & DST independent. Fixes [issue #516](https://github.com/Mottie/tablesorter/issues/516). + * Added tests for `sortForce`, `sortAppend`, `sortMultiSortKey` and `sortResetKey`. + * Cache natural sort regex. + * Date parsers now return the original cell text instead of an empty string when encountering invalid dates. Sort of fixes [issue #531](https://github.com/Mottie/tablesorter/issues/531). + * Event fixes: + * Sort events will now only show when the table is being sorted; previously when updating an unsorted table, sort events would fire. + * The `updateComplete` event now fires after every triggered update (`update`, `updateRows`, `updateAll`, `updateCell` & `addRows`) + * Updated pager to correctly trigger the `updateComplete` event when using ajax. + * Added unit tests to ensure these events fire on an empty table. + * Fixes [issue #532](https://github.com/Mottie/tablesorter/issues/532) + +* ColumnSelector widget + * Make column disable, visible & invisible methods consistent. Fixes [issue #519](https://github.com/Mottie/tablesorter/issues/519) + +* Filter widget + * Preset filter searches (set by `data-value` on the header) work again. Fixes issues [#511](https://github.com/Mottie/tablesorter/issues/511) & [#525](https://github.com/Mottie/tablesorter/issues/525). + * Add note to docs about adding a placeholder. Fixes [issue #522](https://github.com/Mottie/tablesorter/issues/522). + * Filter build select function no longer causes a javascript error on empty tables. Fixes [issue #528](https://github.com/Mottie/tablesorter/issues/528). + +* Grouping widget + * The `collapsed` option once again shows the group headers. Fixes issues [#514](https://github.com/Mottie/tablesorter/issues/514) & [533](https://github.com/Mottie/tablesorter/issues/533) + * Add `group_saveGroups` & `group_saveReset` options: + * The `group_saveGroups` option (`true` by default) saves the group name of any collapsed groups (requires `group_collapsible` to be `true`) + * The `group_saveReset` option (`null` by default) contains a jQuery selector string or jQuery object pointing to an element to be used to clear the saved groups. + * Both of these options require the storage utility script contained within the `jquery.tablesorter.widgets.js` file. + * Fullfils feature request of [issue #514](https://github.com/Mottie/tablesorter/issues/514). + * Added details about using regular expressions within the `group_separator` option. + +* Header Titles widget (headerTitles) + * New widget which adds the current sort to the header title attribute. + * It distinguishes between a text and numeric sort and includes the current sort direction + * A prefix can be included. + * By default, an ascending sort shows either "A - Z" or "0 - 9", or "Z - A" or "9 - 0" for descending sorts. + * Note that date columns will show as numeric + * Fixes [issue #529](https://github.com/Mottie/tablesorter/issues/529). + +* Pager (addon & widget) + * Ensure empty array `[]` and array of empty strings `['', '', '']` evaluate as the same when checking if the filters have changed. Fixes [issue #202](https://github.com/Mottie/tablesorter/issues/202) (again). + * Compare `totalRows` vs. `totalPages` when preventing an ajax call. + * Changes to make the `updateComplete` event fire, but because of the asynchronous nature of ajax, it fires before any `sortEnd` events. It may take some more work to resolve this, if it becomes a concern. + * Attempted to fix pager row count issue. See [issue #455](https://github.com/Mottie/tablesorter/issues/455). + +* Miscellaneous + * Pager custom controls (beta) now shows no pages on a single page. Fixes [issue #518](https://github.com/Mottie/tablesorter/issues/518) + * Increase Bootstrap 3 theme css specificity. See [issue #515](https://github.com/Mottie/tablesorter/issues/515) + * Checkbox parser no longer causes a js error when a checkbox doesn't exist. + #### Version 2.15.5 (2/23/2014) * Pager widget now initializes properly when using ajax. Fixes [issue #510](https://github.com/Mottie/tablesorter/issues/510). @@ -77,143 +133,3 @@ View the [complete listing here](https://github.com/Mottie/tablesorter/wiki/Chan * Added `delayInit` demo ([pull #504](https://github.com/Mottie/tablesorter/issues/473)) - thanks [Infeligo](https://github.com/Infeligo)! * Fixed some markup issues & rearranged some links * Updated minified widget file date. Fixes [issue #505](https://github.com/Mottie/tablesorter/issues/505) - -#### Version 2.15.1 (2/19/2014) - -* Filter widget - * Switched method of saving last search times, as cloned table parts would not include saved data - * Fixes [issue #473](https://github.com/Mottie/tablesorter/issues/473). - -#### Version 2.15.0 (2/19/2014) - -* Core - * Add accessibility attributes to tablesorter (aria). - * Make header's `bindEvent` function public to allow easier binding to cloned table headers. - * Add an unsorted header class name option `cssNone` (empty string by default) and now all unsorted headers will have a class name of `tablesorter-headerUnSorted` applied; updated destroy method to remove header unsorted class name. - * Ensure only "updateRow" is triggered within the pager plugin to prevent issues with Proptype.js, see [issue #217](https://github.com/Mottie/tablesorter/issues/217). - * Clean up all public API functions to accept `table` as either a DOM element or a jQuery table object. - * The log will now display console errors and/or warnings based on those key words. - * Consolidated all default class names used by the plugin within `$.tablesorter.css` - these are class names that are not set by the options. - -* Docs - * Organize the examples section to make it easier to find the desired sort demo. - * Add associated tablesorter option (with link) with the appropriate examples. - * Add a "Custom parsers" section instead of lumping it in with the widgets. - * Add a "Work-in-progress" section for some beta demos. - * Add indicators to show which widgets are contained within the `jquery.tablesorter.widgets.js` file. - * Add an "API" section which gives details on how to use tablesorters available public variables & functions in both the core and widgets. - * Colorize the left border of code blocks to differentiate HTML, CSS and javascript. - * Update & consolidate jQuery UI accordion code. - * Miscellaneous demo fixes. - -* Parsers - * The "shortDate" parser now works properly with header colspans. Fixes [issue #474](https://github.com/Mottie/tablesorter/issues/474). - * The "currency" parser will now properly detect currencies which include a plus or minus sign. - * The "checkbox" parser (contained in the `parser-input-select.js` file) will now toggle a class name of `checked-#` (`#` is the column index) on the row. - * A new `parsed` parameter has been added to the parser code block. - * This parameter is set with a boolean value (i.e. `true` or `false`), to signal the filter widget to only search through parsed data when `true`. - * All parsers within the "parser-input-select.js" file now include a `parsed:true` parameter. - * The [parsers](http://mottie.github.io/tablesorter/docs/example-parsers.html) and [parsers-advanced](http://mottie.github.io/tablesorter/docs/example-parsers-advanced.html) demos have been updated to reflect this addition. - -* css Sticky headers widget: - * Add `cssStickyHeaders_zIndex` option. Fixes [issue #466](https://github.com/Mottie/tablesorter/issues/466). - * Browser will now scroll to table top after filtering. Fixes [issue #482](https://github.com/Mottie/tablesorter/issues/482). - -* Column selector widget (new!) - * This widget can make a table responsive. It uses similar parameters as those used by jQuery mobile to set priorities for hiding columns (uses "data-priority" attribute). - * The column priorities range from 1 to 6, with 1 having the highest priority. As the browser window shrinks, lower priority (higher numbers) columns will be hidden first until all numbered priority columns are hidden. - * Any named data-priority, other than the numbers 1 - 6, (e.g. "critical" or "persistent") will be treated as a column which *will not be included* in the column selector. - * With the addition of some basic selector markup and css, this widget will also allow selecting (hiding or showing) table columns. - * Popups can also be targetted for addition of these selectors; [the demo](http://mottie.github.io/tablesorter/docs/example-widget-column-selector.html) includes a Bootstrap popover sample. - * Css selectors are used to hide/show columns for optimal speed and therefore will not work in IE8 and older browsers. - * jQuery version 1.7+ and tablesorter verison 2.8+ are needed for this widget to work properly. - * Check out the [demo](http://mottie.github.io/tablesorter/docs/example-widget-column-selector.html) with more details on how to setup this widget! - -* Editable widget - * Refresh other widgets after a cell has been edited. Fixes [issue #487](https://github.com/Mottie/tablesorter/issues/487). - -* Filter widget: - * Make operator match higher priority than exact matching. Fixes [issue #465](https://github.com/Mottie/tablesorter/issues/465). - * Fix " OR " is now matched case insensitive. - * The `filter_cssFilter` option can now contain an array of class names to be applied to each filter input; added in addition to the "tablesorter-filter" class name. - * Start filter values are now preserved. Fixes [issue #452](https://github.com/Mottie/tablesorter/issues/452). - * Filter formatter demo: Update jQuery UI & stylesheet - fixes UI spinner. - * Fix child rows always visible when filtering. - * Update beta demo - [select2 external table filters demo](http://mottie.github.io/tablesorter/beta-testing/example-external-filters-using-select2.html), thanks to [mohitmayank](https://github.com/mohitmayank); see [pull request #469](https://github.com/Mottie/tablesorter/pull/469). - * Add `filter_hideEmpty` option - * Set this option to false to always show the filter row. - * By default, the filter row is completely hidden when no rows exist within the tbody (previous behavior) - * Fixes [issue #450](https://github.com/Mottie/tablesorter/issues/450) - * Rewrite filter match any column code - * Removed `filter_anyMatch` option - sorry about not deprecating this first! - * Added a `filter_external` option which is set to a jQuery selector string of inputs, outside of the table, to be used for searching table content. - * External inputs must have a `data-column="x"` attribute where `"x"` is the associated column to filter; `"x"` can also be set as `"any"` to match any column. - * All filters, internal and external, now automatically update and be used with the `$.tablesorter.getFilters` and `$.tablesorter.setFilters` functions. - * Please refer to the documentation for the [`filter_external` option](http://mottie.github.io/tablesorter/docs/index.html#widget-filter-external) for more details. - * Also check out the updated [filter widget external option](http://mottie.github.io/tablesorter/docs/example-widget-filter-any-match.html) and [filter widget external inputs](http://mottie.github.io/tablesorter/docs/example-widget-filter-external-inputs.html) demos. - * This fixes issues [#114](https://github.com/Mottie/tablesorter/issues/114), [#370](https://github.com/Mottie/tablesorter/issues/370), [#471](https://github.com/Mottie/tablesorter/issues/471) and [#490](https://github.com/Mottie/tablesorter/issues/490). - * Parsers with a `parsed: true` flag will now automatically force the filter widget to only search through parsed data instead of actual table cell data - * This is needed specifically for parsers of input, textarea and select elements. - * All parsers within the "parser-input-select.js" file have been updated with this parameter. - * This flag is essentially does the same thing as adding a class name of `filter-parsed` to the column header, or `filter: "parsed"` setting to the [`headers` option](http://mottie.github.io/tablesorter/docs/#headers). - -* Filter Formatter (Filter widget extension): - * These updated filter widget functions are not completely backward compatible with older versions of the filter widget. Please update both! - * Added `compare` & `selected` options: - * These options allow the adding of a comparison operator selector to the cell (e.g. `>`, `>=`, `<`, `<=`, etc). - * If any `cellText` is included, it is now wrapped in a label with a class name of "compare-select-label" and "compare-select-label#" (where "#" is the column index). - * The selector has a class name of "compare-select" and "compare-select#" (where "#" is the column index) - * Whichever type of input that is added to the cell is then wrapped in a div with class "compare-select-wrapper" and "compare-select-wrapper#" (where "#" is the column index). - * These class names allow styling of an individual filter to keep elements in line, or however you wish to style it. - * Filter reset now sets these filters to their default values, not an empty string. - * Updated to now properly restore saved filters. - * Added `endOfDay` option for jQuery UI Datepicker. - * When `true` search dates will include all times from the date chosen when a comparison is made of dates "less than" the set date. - * Example 1: if a table entry has a date of "Jan 14, 2014 11:23 AM" and the filter search is set to `<= 1/14/2014`, the table entry will be included in the search; the default set time would otherwise be "1/14/2014 00:00:00" and not include the entry from "11:23 AM". So, the `endOfDay` option sets the time to "23:59:59". - * Example 2: if searching for one specific date, this option will now search for all times within that day. For example, searching for `=1/20/2014`, and the results will include dates from 1/20/2014 00:00:00 to 1/20/2014 23:59:59. - * When comparing dates greater than the set date, the time will be set to midnight; so this option will not be applied. - * Example 3: in two date inputs, the `endOfDay` time is only applied to the "to" input; search for `1/20/2014 - 1/20/2014` - * This option is available in both the comparison (one input) and range (two inputs; "to" date input only) date pickers. - * Fixes [issue #325](https://github.com/Mottie/tablesorter/issues/325) and [issue #430](https://github.com/Mottie/tablesorter/issues/430). - -* Group widget: - * Attempt to fix ajax issue. See [issue #437](https://github.com/Mottie/tablesorter/issues/437). - * Combining group widget with pager should now work properly. Fixes [isse #437](https://github.com/Mottie/tablesorter/issues/437). - * The widget will now find the correct header cell when multiple thead rows are present. - -* Pager (plugin & widget): - * Fixed pager issues with empty tables - * When existing rows are removed from the table, the pager display will no properly update to show zero total rows. - * When starting from an empty table and content is added, all widgets are refreshed - * When updating the table via an update method, the filter search will now be applied properly. - * Fixes issues [#426](https://github.com/Mottie/tablesorter/issues/426) & [#455](https://github.com/Mottie/tablesorter/issues/455) - * Correct page calculation. Fixes [issue #468](https://github.com/Mottie/tablesorter/issues/468). - * Added custom storage keys. Thanks to [eire1130](https://github.com/eire1130); see [pull request #480](https://github.com/Mottie/tablesorter/pull/480) & [issue #481](https://github.com/Mottie/tablesorter/issues/481). - * Added a public show error function `$.tablesorter.showError( table, message );` - * Pass this function the table DOM element or jQuery object in `table` - * The message can either be a string with a message ("table refuses to cooperate") - * or, the message can be an HTML string of an entire table row (`'