Release notes for TableTools 1.1.4:

• Fixed: Remove comma from init object that stops initialisation in IE

Download TableTools 1.1.4

Release notes for DataTables 1.6.2:

• Updated: Now comes with jQuery 1.4.2

• Fixed: Warning message about number of TD elements got the information in the message the wrong way around!
• Fixed: State saving was missing 'desc' sorting, due to a bug introduced with the new handling of sorting (aaSorting and asSorting)
• Fixed: When using full_numbers pagination and jQuery UI, the 'Next' and 'Previous' button had the wrong classes assigned to them, making them look active.
• Fixed: fnPageChange more or less didn't work as advertised... It does now!
• Fixed: _fnAddData (internal function used by fnAddData as well as Ajax sourced data) had type detection algorithm wrong (like the fix in 1.6.1)
• Fixed: fnSetColumnVis now supports nested tables in a DataTable. Could probably do with a rewrite to be more flexible at some point...
• Fixed: When state saving, and the new table is longer than the old one, DataTables would show an empty table. Now it will roll back to the start
• Fixed: Auto calculation of column width could be dodgy when considering padding etc. Thanks to 'scottsb' in the forum for this fix (discussion id 1316)
• Fixed: Sorting classes (in the tbody) could be applied incorrectly when the cell has nested table(s) (forum discussion 1332)
• Fixed: A small performance increase in the adding of sorting classes due to algorithm change
• Fixed: Set a default of 'sorting_disabled' for sSortableNone (where sorting has been disabled on a column)
• Fixed: When attempting to use the pagination buttons which were disabled, DataTables would redraw the table (particularly noticeable with server-side processing). It now won't

Download DataTables 1.6.2

Release notes for FixedHeader 2.0.1:

• Fixed: Left and right fixed columns incorrectly referenced this.nTable, and it should have been s.nTable. Only noticeable if you had two or more tables 'fixed'.

Download FixedHeader 2.0.1

Release notes for KeyTable 1.1.3:

• Fixed: Assign tab index to hidden input correctly, for 'form tables'

Download KeyTable 1.1.3

Release notes for TableTools 1.1.3:

• New: Ability to set if the BOM should be included for XLS and / or CSV export
• New: IMG tags are now replaced by their ALT attribute rather than just stripping them out. Thanks to Loic Bistuer for this feature
• New: Now compiled with the free mxmlc compiler (don't need a Flash license now :-) )

• Fixed: The alert which notes the number of rows copied was always one less than it should have been.
• Fixed: Printing feature didn't interact well with DataTables pagination. Would start are current page start, rather than table start

Download TableTools 1.1.3

Release notes for TableTools 1.1.2:

• Fixed: Data export was broken in IE due to the nodeValue stripping \n\t.

Download TableTools 1.1.2

Release notes for TableTools 1.1.1:

• New: TableToolsInit.sPrintInfo option added to the settings object. You can now customise the message about the print view (i.e. press escape to return to normal) using this parameter
• New: TableTools will now export the table footers as well as the header. This can be disabled using TableToolsInit.bIncFooter=false.

• Fixed: Large data sets can now be exported due to a work around of a browser limiting feature in nodeValue
• Fixed: Removed 'KeyTable' events information from the HTML table which was left over from copy/paste

Download TableTools 1.1.1

It is worth noting that I've put in new algorithms for parts of DataTables, so there is the potential that things might break (as with all new software releases). 1.6.1 passes clean through my unit tests, but if you do spot anything, please do jump into the forum and let me know!

Release notes for DataTables 1.6.1:

• Updated: fnOpen now returns the TR node that was created

• Fixed: Cookie contents were not escaped. As a return ';' and other characters could cause issues.
• Fixed: Type detection was incorrectly only looking at the first row (under certain circumstances).
• Fixed: Type detection could get confused if a column contained (only) date and numeric information.
• Fixed: If asSorting was defined (but not aaSorting) then we should use the first sorting option for a column in asSorting rather than the default.
• Fixed: The examples index in the distribution had a few wrong links in it

• Optimisation: Sorting classes (bSortClasses) was very slow when removing previously assigned classes. An optimisation for this as reduced initialisation time for large data sets by up to 90%!
  • - Test set, 500 rows with 9 columns
  • - Safari 4 - 4500mS to 400mS
  • - Firefox 3.5 - 2500mS to 600mS
  • - IE 8 - 'Unresponsive script' to 1500mS
• Optimisation 2: Not quite happy with the sorting classes still, so removed the use of jQuery's removeClass and selector to do direct DOM manipulation. We can do this here since we directly control the table and "know" it's structure ahead of time.
  • - Test set, 2000 rows with 9 columns
  • - Safari 4 - 1500mS to 300mS
  • - Firefox 3.5 - 1100mS to 370mS
  • - IE8 - 'Unresponsive script' to 600mS
• Optimisation: Sorting classes (bSortClasses) was slow when adding the required sorting classes. Using direct DOM manipulation the draw has be substantially improved:
  • - Test set, 2000 rows with 9 columns
  • - Safari 4 - 2200mS to 1100mS
  • - Firefox 3.5 - 2800mS to 2100mS
  • - IE8 - 'Unresponsive script' to 10300mS
• Optimisation: Fixed table width (required so pagination doesn't have a chance to cause the table width to 'jump') is now done at the end of the first draw. The advantage of this is that the browser need only 'size' the table with the initial number of DataTables rows (10 by default) rather than the unenhanced table (2000 rows in this test)
  • - Test set, 2000 rows with 9 columns
  • - Safari 4 - 1100mS to 660mS
  • - Firefox 3.5 - 2100mS to 1500mS
  • - IE8 - 10300mS to 3100mS
• Optimisation: Very minor (but welcome all the same) draw time speed up by altering the algorithm for removing and then adding rows
  • - Test set, 57 rows with 5 columns, draw 100 rows and then 10, looped 1000 times
  • - Safari 4 - 2000mS to 1800mS
  • - Firefox 3.5 - 11000mS to 9600mS
  • - IE8 - not tested
• Optimisation: Change method for reading in the data from the DOM for _fnGatherData.
  • - Test set, 2000 rows with 9 columns
  • - Safari 4 - 550mS to 440mS
  • - Firefox 3.5 - 1300mS to 1000mS
  • - IE8 - 4100mS to 3500mS

Download DataTables 1.6.1

Enjoy!

Release notes for DataTables 1.6.0:

• New: fnVersionCheck API function which can be used by plug-ins to check if DataTables is at a suitable version for them to be supported
• New: fnPageChange API function. This is to simplify paging, both internally and externally.
• New: Now ships with jQuery 1.4 in the package
• New: A warning is alert()ed when you try to re-initialise a table now as this is unsupported behaviour. Use the API to make any required changes. This is basically a sanity check
• New: KeyTable is now included in the DataTables distribution (under the extras directory)
• New: ReadMe in the extra directory explaining the various plug-ins
• New: fnDeleteRow, fnUpdate and fnGetData now accept either an aoData index, or the TR element as the target parameter (aoData index was required before, which required looking up the position before calling either of these functions).

• Fixed: The 'alert' errors that DataTables gives have been modified to clearly indicate that they come from DataTables
• Fixed: DataTables and it's content could "disappear" in IE7/8 due to the position:relative on .dataTables_wrapper. Adding zoom:1 fixes this. With special thanks to Tobias Bathge for his kind assistance with this!
• Fixed: api/row_details.html, api/select_single_row.html, server_side/row_details.html example shows the new use of fnGetData with a TR element being passed. Clear and easier to understand.
• Fixed: server_side/select_rows.html had a memory leak in it. Now uses $.live() event handler and the updated syntax for fnGetData
• Fixed: The sorting icons are now png8 files, with transparent backgrounds. Suitable for easier integration. The source psd is also included
• Fixed: Paging plug-in example updated for the new pagination API in DataTables 1.6
• Fixed: Initialisation of aaSorting, could result in poor interaction behaviour if not used in combination with aoColumns.asSorting (e.g. double click required to reverse sorting). Now automatically initialised to the correct sorting interaction order.
• Fixed: There was an extraneous call to _fnSortingClasses (which is quite a heavy function) in _fnInitalise
• Fixed: Removed instances of iSortDir_ in the code examples to match the API change
• Fixed: Plug-ins are given their own section in the 'examples'

Download DataTables 1.6.0

Release notes for FixedHeader 2.0.0:

• New: Massive changes - basically a complete re-write
• New: Ability to fix the header, the footer, the left most column and right most column! Each can be enabled or disabled independently
• New: Five more examples to show how FixedHeader can be customised now
• New: Much more efficient in terms of Javascript processing == smoother display
• New: Multiple tables can have FixedHeader applied to them
• New: FixedHeader can be applied to standard HTML tables as well as DataTables (i.e. DataTables is optional)
• New: Now requires DataTables 1.6.x
• New: Support multi-column sorting (shift-click)

Download FixedHeader 2.0.0

Release notes for TableTools 1.1.0:

• New: Unicode support!
• New: Excel output is now saved as UTF-16LE, which allows unicode to work. CSV output is saved as UTF-8. The BOM is included in both cases.
• New: Information in hidden columns (bVisible:false) can now be included in the exported data by setting the TableToolsInit.bIncHiddenColumns parameter
• New: Data is automatically trimmed when exported (csv, xsl or clipboard). This is done to account for white space which is often present in HTML tables
• New: Ability to save files larger than 64KiB. There is a limitation in the Javascript / Flash bridge, which has been worked around in this release for large data sets.

• Fixed: Demo now notes that TableToolsInit.sSwfPath might need to be set by the developer
• Fixed: Type issue when used with server-side processing, Ajax or aaData sources.
• Fixed: Strip invalid characters from the titles. Note it's fairly brutal when detailing with ACSII characters. This is the ensure maximum compatibility.
• Fixed: The csv export doesn't account for existing commas in the table cells. Now use a field boundary for CSV (default is a single quote '), which is read from TableToolsInit.sCsvBoundary
• Fixed: Passes JSLint
• Fixed: HTML entities are now decoded (for example '&' will come out as '&' in the exported file and clipboard now)
• Known limitation: Note that due to limitations in Javascript engines it would appear that this support is limited to the "Basic Multilingual Plane"

Download TableTools 1.1.0

Release notes for KeyTable 1.1.2:

• Fixed: The return key needed to 'stopPropagation()' etc
• Fixed: There was a console.log debug statement left in which of course broke IE and other browsers
• Fixed: Editable example is updated to use the new event attaching syntax - much more efficient
• Fixed: Passes JS Lint (replacing some questionable scripting...)

Download KeyTable 1.1.2

So what are the major features you expect in 1.6? Nothing revolutionary, but certainly evolutionary:

• Support for multiple instances of sDom elements. What this means is that you can have two (or more!) filter boxes, pagination elements or any other table control!v
• Stable sorting. Particularly important in Google Chrome, the table will retain it's original sorting order if items match value.
• A bit more speed :-)

Note that there have been a few API changes so you will have to make changes to use DataTables 1.6 if you use:

• Server-side processing: iSortDir_{x} has been renamed to sSortDir_{x} to reflect that it's a string
• A custom pagination plug-in: The fnInit function now takes three arguments. Please see the release notes.

Also note that the current releases of TableTools and FixedHeader are not currently compatible with 1.6.beta. New versions will be available soon.

As always, feedback is most welcome - please post any bugs and comments in the forum. Also, please remember to make a donation if you are using and enjoying DataTables :-)

1.6.beta examples

Release notes for DataTables 1.6 beta 1:

• API Change: Server-side processing, iSortDir_{x} changed to sSortDir_{x}
• API Change: Pagination plug-ins: fnInit now takes three arguments: 1. settings object, 2. container node, 3, draw callback function. The insertion of 2. is new.
• API Change: Plug-ins are no longer required to return a node (using sDom features). Features can now be added in this way for Javascript only functions as well.
• API Change: oSettings.fnDrawCallback has been renamed oSettings.aoDrawCallback and is now an array of objects with parameters 'fn' and 'sName'. No external change needed unless you are developing plug-ins
• New: Stable sorting - the original order is maintained when rows match (when the value is checked for sorting). This is particularly noticeable in Google Chrome)
• New: fnServerData can now be used to modify the Ajax data pull, in exactly the same way as it can be for server-side processing
• Fixed: Now fully pass jslint - no warnings
• Fixed: Column sorting classes would be applied on the server-side when bSortClasses was false
• Fixed: fnAddData will simply ignore an empty array that is passed into it
• Changed: Code ordering - now grouped into features
• Changed: Draw speed is increased through improved row striping. aoData._sRowStripe is a new internal variable for tracking this
• Changed: Due to the option of multiple instances of a 'feature' in sDom, the ID attributes are applied only to the first instance of a new element (for example the information div). It is recommended that classes are used for styling.
• To do: The beta will break TableTools and FixedHeader

Download DataTables 1.6 beta 1

Release notes for KeyTable 1.1.1:

• Fixed: Event handler positioning was incorrect when used with DataTables paging

Download KeyTable 1.1.1

Hand-in-hand with this leap forward in development usability is the new inclusion of three API functions which will give you the position of the currently focused cell (fnGetCurrentPosition), the data from the currently focused cell (fnGetCurrentData) and the TD node that is currently focused (fnGetCurrentTD).

Enjoy!

Release notes for KeyTable 1.1.0:

• New: "Live" events. You can now pass either null for either (or both) the x or y coordinates for an event handler to mean "all" of the that row or column. This means that you can now have a single event handler for an entire row, column or every cell, rather than doing it individually.
• New: The callback function for the event handler now passes in three parameters: 1. The node in question (as before), 2. the node's x coordinate and 3. the node's y coordinate.
• New: Added API function fnGetCurrentPosition() to get the current position of the focus (array [x,y] is returned)
• New: Added API function fnGetCurrentData() to get the data from the currently focused cell
• New: Added API function fnGetCurrentTD() to get the currently focused TD element
• New: Updated DataTables distribution to 1.5.6. Might integrate into the DataTables 'extra' directory in future

• Fixed: Only worked with two_button paging type previously. Now works with all paging types
• Fixed: Use 'jQuery' variable rather than '$' to avoid conflict with other libraries
• Fixed: When attempting to add events using incorrect formatting, an alert is now given

Download KeyTable 1.1.0

Release notes for DataTables 1.5.6:

• Fixed: sDom issues in IE

Download DataTables 1.5.6

Release notes for DataTables 1.5.5:

• New: Two new sDom constants: H and F for jQuery UI theme header and footer (a long string of classes). Done like this to allow easier accessibility of sDom when used with jQueryUI theming
• New: bSortable_{i} and bSearchable_{i} have been added as parameters sent to the server-side (when server-side processing is used). This allows for the client and server-sides to be more flexible

• Updated: jEditable demo now has IDs in the TD elements which are also submitted.

• Fixed: iCookieDuration was missing from the initialisation parameters
• Fixed: State saving did not restore pagination state when bFilter was false
• Fixed: When sorting disabled (either by an individual column, or globally with bSort) classes were not applied to the table header cells, resulting in a poor visual effect, particularly with jQuery UI themeing enabled
• Fixed: When sName defined for the column but sColumns not returned by the server, there would be a Javascript error

Download DataTables 1.5.5

Of these new features, the biggest is a new API for sorting, which allows a table to be sorted based on live information in the DOM - an example is worth a thousand words. Also two flags have been added to the DataTables settings object which are used to indicate if either filtering or sorting have been applied in the latest redraw, allowing you to take appropriate actions: for example updating an index column.

Release notes for DataTables 1.5.4:

• New: New API for sorting data (specifically indented for DOM variable data such as form elements)
• New: Filtering and sorting are now (individually) flagged has having occurred, when appropriate, such that fnDrawCallback can be used as a hook when sorting and/or filtering has occurred. The new parameters are in oSettings as bSorted and bFiltered.
• New: Example - api/counter_column.html
• New: Example - api/dom_sorting.html

• Updated: Documentation updated for new sorting API and example data source sorting functions added to plug-ins page.

• Fixed: jQuery classes were not applied to thead elements which had sorting disabled on them

Download DataTables 1.5.4

Release notes for DataTables 1.5.3:

• New: Default sorting direction is now controllable
• New: You can limit sorting to a single direction, or add complex behaviour as required
• New: fnRender object now also included oSettings
• New: fnDraw API function now accepts a single argument (boolean) to indicate if the redraw should be complete (i.e. re-sort and re-filter), which has the side effect of resetting the pagination, or just update the display as it is.

• Updated: The jQuery UI classes for sorting have been updated to take account of the new sorting direction control feature. This involves the use of a mix of triangle and chevron icons to make it clear what sorting can be controlled.

• Fixed: If the auto width calculation has found a table width of 0, it is not applied to the table. The reason being is that this can occur when the table is not in the documents, display flow.
• Fixed: Pressing return in the search box could cause a form to be submitted
• Fixed: JUI themes: insert span for the sorting direction in the header as the first element in the TH - makes it suitable for display:block styling. Thanks to TomC for this fix
• Fixed: fnOpen() will now work for elements which are not on the current page.
• Fixed: Child-tables could cause issues with the width calculation were to many TD elements were being selected
• Fixed: Selectors checked and improved for dealing with child-tables
• Fixed: When changing the number of columns in a table, and having bStateSave enabled, this could cause DataTables to expect the wrong number of columns. Now it will expect what is in the data source, and throw away the state information if it is out of date.
• Fixed: When showing all records (-1 length) the 'Next' and 'Previous' buttons weren't being disabled
• Fixed: When showing all records (-1 length) some of the buttons could cause 'odd' behaviour when clicked, even although nothing should have happened
• Fixed: _fnReDraw was missing from oApi
• Fixed: Adding a column to an empty table element with the column initially hidden and then shown would result in the column title failing to be to displayed (the cell would be)

Download DataTables 1.5.3

Release notes for FixedHeader 1.0.1:

• Updated: Much improved speed of rendering
• Updated: The fnUpdate() function will update cached DOM information now

Download FixedHeader 1.0.1

Release notes for FixedHeader 1.0.0:

• Initial release

Download FixedHeader 1.0.0

Release notes for DataTables 1.5.2:

• New: Full support for jQuery UI's Theme Roller (using the bJQueryUI initialisation parameter)
• New: Custom classes names for all elements can now be defined
• New: In full numbers paging, the 'permanent' buttons (first, next etc) now have their classes updated to be 'active' when they can be clicked on.

• Fixed: When using sAjaxSource with state saving, the paginging number was not retained
• Fixed: Internal naming for 'first' span for full_numbers paging was incorrect
• Fixed: _fnGetTrNodes, _fnGetDataMaster and fnGetPosition did not consider nulls in aoData (as a result of fnDelete)
• Fixed: Column detection did not take account of TD elements mixed in with the THs

Download DataTables 1.5.2