Hope you enjoy!

Release notes for DataTables 1.7.1:

• New: Language callback function for the information element. This can be used to customise the language shown in the information element beyond what is possible with the built in language string options (for example plurals). The arguments are fnInfoCallback( oSettings, iStart, iEnd, iMax /*no filter*/, iTotal /*after filter*/, sOut /*DT rendered string*/ ) - 2520
• New: Cookie callback function (can be passed as an initialisation parameter) called fnCookieCallback, which allows the developer to modify the information stored in the cookie. Takes four arguments (sName, oData, sExpires, sPath) and expects a complete cookie string to be returned (with name, value, expires and path correctly formatted). - 2510

• Updated: Complex headers have been relaxed such that TH elements no longer need to be unique. There does need to be the correct TH elements with colspans and rowspans which add up, and each column requires at least one TH element for itself, but it is now possible to have two (or more) TH elements for each column.
• Updated: Warning when adding a new row when the length doesn't match the known number of columns has been updated to indicate the known columns and what was added. Thanks to Adam Sah for this.
• Updated: Now use jQuery's JSON parse function (in jQuery 1.4) rather than JSON.js
• Updated: Altered fnClearTable to clear the data arrays in a cleaner manner - 2476

• Fixed: State saving cookie used single quote strings in places (in correct JSON). This has now been addressed, and a work around in place (replace) until a sufficient period has passed
• Fixed: Removed unnecessary white space from state saving cookies
• Fixed: When displaying full data set with server-side processing (_iDisplayLength = -1), this would incorrectly be shown in the table information - 2440
• Fixed: Rows with HTML entities and BR tags in them could break filtering in IE and Opera - 2512
• Fixed: Columns with zero length strings only in them and with a given width would be missed from the width calculations - 2530
• Fixed: Typo for tfoot, should be tbody - "Sanity check that there is a thead and tfoot. If not let's just create them"
• Fixed: Setting a negative width in IE results in an error (fair enough) - so stop this from happening - 2544
• Fixed: The second parameter for fnServerData was being passed as null when used without server-side processing. It makes much more sense to pass an empty array - 2553
• Fixed: The width of the table is now not fixed to the width of the container when scrolling is not applied (this is the same behaviour as 1.6-) - 2530
• Fixed: fnDestroy didn't restore columns which had been hidden by DataTables, resulting in these columns being completely lost - 2569
• Fixed: Sorting classes weren't being removed in Firefox 3.0 (3.1+ were fine) - 2449
• Fixed: Themeroller 1.8 introduced a few changes from 1.7 (main fg-button* > ui-button) which was causing 1.8 themes to not show correctly. This release updates DataTables to use ThemeRoller 1.8 themes by default, but retains 1.7 backwards compatibility for now (to be removed in future) - 1559

Download DataTables 1.7.1

After a beta cycle which saw eight releases, I wish to offer a huge thank you to everyone who has been testing it and reporting issues back to me. DataTables 1.7 boasts a number of enhancements for both the end user's final view of the table, and for you, the developer, to make your life easier.

I hope you enjoy this release!

Release notes for DataTables 1.7.0:

• No changes from 1.7 beta 8. As a recap of the new features in the 1.7 series:
• New: X and Y scrolling! A table can now be constrained in both height and width, allowing scrolling to view hidden content. This works with or without pagination, and all other DataTables functions as would be expected. To accommodate this new feature the initialisation parameters iScrollX and iScrollY have been added which will take the height and width of the table (they are fully independent, you do not need to define both). Note that this feature is off by default but is there if you want to use it.
• New: aoColumnDefs - it is now possible to use this initialisation option to give column specific information (sClass etc) for one or more columns, by targeting a column using it's position or a class name (on the TH element), or all columns, and no longer need to specific aoColumns which had to match the exact column length, and could be very annoying for dynamic width tables.
• New: Big overhaul to the filtering interface - it is no longer a pain in the neck to work with!
  • bEscapeRegex has now been replaced with bRegex (which is basically a NOT of the old var)
  • Can now enable and disable smart filtering (where DataTables tries to be smart with user input)
  • Smart filtering is available on individual column filtering now
  • When entering a global filter using fnFilter, the search text will now be displayed in the table's filter input (unless you overrule this by passing false as the 5th parameter to fnFilter)
• New: fnDestory API function which will delete a DataTable, restoring the table to it's original 'unenhanced' state.
• New: Now using Closure compiler, rather than YUIcompressor. This results a saving of 1/3 file size in the minified version!
• New: null can be given to DataTables for display (as part of JSON data). When null is found in supplied data, DataTables will now treat it as if it were an empty string.
• Mew: aLengthMenu - initialisation option to specify the lengths that you want to be visible in the user selectable length menu. This is backwards compatible with the old way of replacing _MENU_ with whatever you want, but this behaviour is now recommended if you want to change only the length display options. Can be a 1D array, or 2D array (for separate language and value options).
• New: The scope of execution (this) for all of the callback functions (fnDrawCallback, fnHeaderCallback, fnFooterCallback, fnInitComplete, fnRowCallback and fnServerData) is now the DataTables object - as such you do not need to use 'oTable' (or whatever you call it) inside the callback functions - just use 'this'. The change also makes it possible to use API functions in the callback during initialisation.
• New: The built in date and numeric sorting both now allow blank values for the input. For example you could have a column of dates, with some being empty strings, which will still be sorted by date, rather then by string as would have been prior to 1.7.
• New: Automatic type detection of HTML content (for sorting a filtering). No longer need to specify sType:html for these columns
• New: Data is trimmed (be it from the DOM or a Javascript based array source) which allows data with white-space around it to be correctly sorted and dealt with (2230).

Download DataTables 1.7.0

Release notes for DataTables 1.7 beta 8:

• Fixed: When dealing which hidden column, the wrong calculate column width could be applied, resulting in odd looking tables (specifically seen in IE8) - 2398
• Fixed: IE7 would show an x-scroll bar when only y-scrolling was enabled
• Fixed: bDestroy would cause a Javascript error in beta 7. Bug was introduced in beta 6 ("potential memory leak")

Download DataTables 1.7 beta 8

Release notes for DataTables 1.7 beta 7:

• Updated: Examples - new scrolling tables example with jQuery UI tabs
• Updated: fnAdjustColumnSizing will now automatically redraw the table when called. This can be stopped by passing 'false' to the function
• Updated: oSettings.iScrollWidth has been moved to oSettings.oScroll.iBarWidth for consistency
• Updated: The alert "Added data does not match known number of columns" will now only be shown once every draw rather than once for every row

• Fixed: iDisplayStart would "rewind" incorrectly when server-side processing can change the page length from a longer length to a shorter one - 2071
• Fixed: The column parameter passed to fnSetColumnVis had to be a number of type Number, now it can be a string (containing a number!)
• Fixed: Any setting of style.height or style.width is now passed through _fnStringToCss to sanity check the setting (i.e. don't try and set "nullpx", which was possible when dealing with hidden tables)

Download DataTables 1.7 beta 7

Release notes for DataTables 1.7 beta 6:

• New: You can now tell DataTables to throw an exception rather than show an alert() when it hits a "level 0" log entry (i.e. it has encountered a critical error). To do this set $.fn.dataTableExt.sErrMode = "throw". This is useful for automated testing, where an alert would interrupt the flow.

• Fixed: sScrollXInner did not have the correct unit applied, depending on the user input
• Fixed: The sizing table could be appended to a node which was not it's direct parent, which could result in incorrect sizing
• Fixed: If using custom DOM or some complex CSS, it is possible that the table width is more constrained that when it originally measured. This would result in horizontal scroll bars appearing incorrectly. We now check for this and take corrective action at the end of initialisation.
• Fixed: Typo for bDestroy - I had bDestory being checked for in the code. Sorry!
• Fixed: If y-scrolling (without x-scrolling) and the table has only a few records in it (few enough to fit into the visible area) the table didn't take up as much width as it should do - space was left for the scroll bar, which wasn't needed). This could look some visual displays look slightly odd with a gap down the right.
• Fixed: When scroll collapsed was enabled, and x-scrolling enable but not actively required (i.e. no scrollbar) there would be a gap between the table body and the footer to allow the scrollbar to be placed
• Fixed: Clicking to sort could selected the text which looks fairly ugly. DataTables had code to not do this, but it was only applied when the shift key was pressed. Removed this check. Thanks to OuT.
• Fixed: Backwards compatibility issue with sZeroRecords and sEmptyTable. Now if sEmptyTable is not given (as it is generally not, since it wasn't support in pre 1.7), then sZeroRecords will be used instead (assuming it is given).
• Fixed: When x-scrolling, if the scroll needed more than 50% extra above the width of the container element, then the table header would stop scrolling before the body did.
• Fixed: Column sizes are now recalculated when the fnSetColumnVis API function is used
• Fixed: When setting x-scroll to 100% and the table fits into the given viewport, it would still xscroll due to the y scroll bar
• Fixed: It was possible to have 'nullpx' assigned to a column's sWidth property - possibly caused by checking width on hidden elements or not using $(document).ready(). Added checks to stop this.
• Fixed: Potential memory leak when another 'process' is adding and removing tables from the DOM and DataTables is being used on these tables. If the element we are initialising has the same ID as a table which was previously initialised, but the table nodes don't match (from before) then we destory the old instance by simply deleting it.
• Fixed: When using a tfoot element with multiple TR elements in it, DataTables will now effectively ignore the extra rows, rather than breaking on them!

Download DataTables 1.7 beta 6

Release notes for FixedHeader 2.0.3:

• Fixed: FixedHeader is not supported with scrolling enabled in DataTables 1.7. An alert() warning is now created when trying this to make it clear that this will not currently work.

Download FixedHeader 2.0.3

Release notes for KeyTable 1.1.6:

• New: KeyTable now supports scrolling in DataTables 1.7. No extra initialisation is required for this, it just works.

Download KeyTable 1.1.6

Release notes for DataTables 1.7 beta 5:

• New: console.log warnings are generated if the requirements aren't met to align the table columns correctly when scrolling

• Fixed: Fixed alignment of column where column width is constrained

Download DataTables 1.7 beta 5

Release notes for DataTables 1.7 beta 4:

• New: Automatic type detection of HTML content (for sorting a filtering). No longer need to specify sType:html for these columns
• New: Data is trimmed (be it from the DOM or a Javascript based array source) which allows data with white-space around it to be correctly sorted and dealt with (2230).
• New: Functions for afnSortData now get three parameters, the (new) third one is the visible column index
• New: sScrollXInner is a new initialisation property which allows you to specify the width of the table inside the scroller (this in instead of setting the width of the table to be too width)

• Fixed: Removed erroneous comment in fnOpen about old server-side specific code
• Fixed: Row strip removal (prior to DataTables adding it's own) was operating on child tables as well as the DataTable - 2182
• Fixed: Scrolling collapse could add a little extra height if x scrolling is not enabled
• Fixed: Slight optimisation on the code which removes row striping classes if the table already has one - 2182
• Fixed: When a column target in aoColumnDefs[].aTarget is given as 0+ and there is no matching column - then columns are added as needed. This allows aoColumnDefs to completely replace aoColumns.
• Fixed: Now use the first row in the body
• Fixed: An check for IE was incorrect in the scrolling (jQuery bug 6777) so now use a different check. This was causing Firefox issues
• Fixed: When adding a number to a column to a column which has been detected as a string you could get an error. The answer is to ensure all data held internally in a string and treat it accordingly (2249)
• Fixed: Optimisation of _fnNodeToDataIndex. When looking for a node, we now search through the visible part of aiDisplay and try match the given node to the elements on the page before battering through the whole aoData array. This will typically make look ups much faster since they tend to come from the visible information (events, selectors) (2261)
• Fixed: fnDestroy will now restore the odd/even classes of the original table (note this is not 100% fool proof, see the code, but it optimised to the majority of cases)
• Fixed: When autowidth is disabled _fnAjustColumnSizing now takes no action

Download DataTables 1.7 beta 4

Release notes for DataTables 1.7 beta 3:

• New: A 'static' function $.fn.dataTableExt.fnVersionCheck is now provided to allow version checking without a DataTables instance
• New: API function called fnAdjustColumnSizing(). Which would most likely be used with a scrolling table whose content has changed and the table needs updating to keep the header, footer and body all insync size wise. You will typically want to do a draw after this function is called to keep everything in-sync.
• New: Feature variable for scrolling tables "bScrollCollapse" - this will cause the table container height to shrink to that of the table if the result set shown is "shorter" than the height used for y-scrolling
• New: fnUpdate has been given a 5th parameter (bAction) to indicate if pre-draw actions (column size calculation and filter array building) should occur or not. Can be disabled to improve performance when adding many rows, but remember to perform these actions once all data has been updated!
• New: DataTables will detect when a given table will not fit into a specific area (when y-scrolling is enabled) and give a warning that you should be aware that this will likely cause the columns to be misaligned. This is because the scroll bar takes 15-18px to be displayed.

• Fixed: The algorithm used to calculate column widths has been completely reworked (this was probably the old code in DataTables, and well due for an update!). It is a lot more accurate, as needed by scrolling, but a little bit slower. The slower method is only used if you specify an 'sWidth' for a column.
• Fixed: HTML entities in text could cause filtering to return incorrect results
• Fixed: TD elements are now correctly dealt with in the thead when doing scrolling
• Fixed: Multiple TR rows are now accepted in thead when doing scrolling
• Fixed: When filtering is disabled fnFilter will now not do anything - just a straight return.

Download DataTables 1.7 beta 3

Release notes for DataTables 1.7 beta 2:

• New: Footer TH elements can be given a class using sFooterTH (is the classes object). This is useful for jQuery UI theming where the default is to give a suitable class for the background.
• New: Example showing how a type detection plug-in can be used for HTML columns
• New: Scrolling tables can now have a tfoot in them as well

• Fixed: Table alignment when using scrolling could go a bit bonkers.
• Fixed: Before a table is fully loaded, if you click on a link, you would most likely get an alert saying that the columns and rows don't match. This is due to browser behaviour, see WebKit bug 39683 and Mozilla bug 568050. As a work around, DataTables will now send this message to console.log if available, otherwise it will simply ignore the error.
• Fixed: Table captions using <caption> tag are now moved into the table used for the header. (thread: 2022).
• Fixed: Scrolling tables could get their alignment wrong at times. This should now be addressed.
• Fixed: The ID from clone nodes for scrolling header wasn't removed, which could result in a table being incorrectly re-initialised.
• Fixed: Changing column visibility with fnSetColumnVis was broken when using scrolling.

Download DataTables 1.7 beta 2

• New features in DataTables 1.7
• Upgrading from 1.6

While this is a first beta release, it should perform well and prove to be very stable. There may of course be bugs found - if you do spot any, please post a message in the forums.

Release notes for DataTables 1.7 beta:

• New: Now using Closure compiler, rather than YUIcompressor. This results a saving of 1/3 file size in the minified version!
• New: fnDestory API function which will delete a DataTable, restoring the table to it's original 'unenhanced' state.
• New: null can be given to DataTables for display (as part of JSON data). When null is found in supplied data, DataTables will now treat it as if it were an empty string.
• New: DataTables will now send a random number to the server when making an Ajax call for data (either Ajax sourced or server-side process) in order to defeat caching of XHR requests in IE6-7.
• New: fnDeleteRow now as an option to not redraw the table on call like most of the other API functions (useful for deleting large numbers of rows) - thanks to 'kalakudu' in the forum.
• Mew: aLengthMenu - initialisation option to specify the lengths that you want to be visible in the user selectable length menu. This is backwards compatible with the old way of replacing _MENU_ with whatever you want, but this behaviour is now recommended if you want to change only the length display options. Can be a 1D array, or 2D array (for separate language and value options).
• New: aoColumnDefs - it is now possible to use this initialisation option to give column specific information (sClass etc) for one or more columns, by targeting a column using it's position or a class name (on the TH element), or all columns, and no longer need to specific aoColumns which had to match the exact column length, and could be very annoying for dynamic width tables.
• New: DataTables will display an 'alert()' error when JSON from the server-side (Ajax source, or server-side processing) is incorrectly formatted.
• New: Ability to format numbers in the 'information' display into an easily readable format, using the new initialisation function fnFormatNumber. The default function is to format numbers using commas for every third order of magnitude (i.e. "1,000,000").
• New: Can now specify the prefix of the cookie using the initialisation parameter "sCookiePrefix".
• New: It is now possible to retrieve table objects which have already been created using the jQuery selector, so you don't need to store a variable reference to the table object to use the API functions. For example "$('#example').dataTable(); $('#example').dataTable().fnDraw();" will now work, where as before it would throw an error. Note that the object is returned if no arguments are passed to dataTable(), or bRetrieve has been set. Alternatively you can fully reinitialise the table by setting bDestory to true, which will destroy the old table and initialise the new one (there are usually more optimal ways to modify the table).
• New: Big overhaul to the filtering interface - it is no longer a pain in the neck to work with!
  • bEscapeRegex has now been replaced with bRegex (which is basically a NOT of the old var)
  • Can now enable and disable smart filtering (where DataTables tries to be smart with user input)
  • Smart filtering is available on individual column filtering now
  • When entering a global filter using fnFilter, the search text will now be displayed in the table's filter input (unless you overrule this by passing false as the 5th parameter to fnFilter)
• New: The scope of execution (this) for all of the callback functions (fnDrawCallback, fnHeaderCallback, fnFooterCallback, fnInitComplete, fnRowCallback and fnServerData) is now the DataTables object - as such you do not need to use 'oTable' (or whatever you call it) inside the callback functions - just use 'this'. The change also makes it possible to use API functions in the callback during initialisation.
• New: New language variable called sEmptyTable which is shown when the table is truly empty (not just filtered to the point of being empty - where sZeroRecords is shown).
• New: The built in date and numeric sorting both now allow blank values for the input. For example you could have a column of dates, with some being empty strings, which will still be sorted by date, rather then by string as would have been prior to 1.7.
• New: X and Y scrolling! A table can now be constrained in both height and width, allowing scrolling to view hidden content. This works with or without pagination, and all other DataTables functions as would be expected. To accommodate this new feature the initialisation parameters iScrollX and iScrollY have been added which will take the height and width of the table (they are fully independent, you do not need to define both). Note that this feature is off by default but is there if you want to use it.

• Updated: fnDeleteRow no-longer has a 'null' option - it will actually remove the data from DataTables permanently now.
• Updated: aoData can no longer accept null as a value. fnDeleteRow was the only function which could cause this to occur, and that function has now been updated to not just null data. This may have a knock on effect if you have a plug-in which clones the display arrays (I'm not aware of any public ones).
• Updated: Single logging function for all alerts / warnings
• Updated: fnServerData default is no longer $.getJSON. It is now a call to $.ajax with some more suitable options for DataTables. fnServerData parameters and returns still function exactly as they did before.
• Updated: Calling the $.dataTable function on an already initialised table will now not return the settings object, but rather than DataTables object itself.
• Updated: Performance - improved the draw time when attaching nodes by using a document fragment. Thanks to hkdennis2k for this tip.
• Updated: sZeroRecords can now have the _MAX_ replacement macro used in it to indicate how many rows the filtering has been applied on, and no results found if you wish.
• Updated: Performance - improved the draw time by moving the body to a document fragment before removing nodes
• Updated: Unit tests modified to take account of changes

• Fixed: The TD element created when there are zero records to display could have the wrong colspan when there were hidden columns in the table. Thanks to Anthony Smith.
• Fixed: fnUpdate was not redrawing the table due to an incorrect check on bRedraw: 1741
• Fixed: Quote escaping in some server processing scripts was wrong
• Fixed: sDom handing for 'H' and 'F' wasn't very smart, just blindly replacing those two characters. As such something like '<"myHeader">t<"myFooter">' would fall apart. This is now handled correctly.
• Fixed: A no-cache variable is now sent to the server-side when loading data. IE could cache GET requests incorrectly, resulting in failed data loading - this should no longer happen.
• Fixed: iDisplayStart was broken when being used with server-side processing
• Fixed: It was possible to get into a situation where if the table had 'odd' and 'even' classes on the TR elements before the table was initialised, then you could get both classes applied to the table at the same time - resulting in no stripes.
• Fixed: fnClose will now work with server-side processing as well as client-side
• Fixed: Cookies now use the path a little more cleverly, which will mean that tables won't hit the 4KiB cookie upper limit quiet so quickly. Thanks to vex for this patch.
• Fixed: State saving in a cookie is now a bit smarter - DataTables will look for and delete an old (the oldest) cookie created by DataTables in the current path (due to the above fix) if it is about to exceed the 4KiB limit. This does have the effect of losing old data (approximately 8 pages can be stored without this cookie deletion being enacted), but means that the server won't run into a 500 error situation.
• Fixed: For some unknown reason IE would on rare occasions throw an error when inserting the information text. Thank you jQuery.html() for providing a fallback :-)
• Fixed: nodeName is case sensitive in XML documents, but always upper case in HTML. This could cause issues due to the use of nodeName checking in DataTables. toUppoerCase() is now used
• Fixed: When sorting on an empty array, there could be a reference to a javascript array element which didn't exist

• Known issue: If a link is clicked on before document loading is complete, an alert about the number of cell appears. This is due to the fact that the DOMContentReady event is fired before the DOM is actually ready. On going discussion in Webkit bug 39683 and Mozilla bug 568050.

Download DataTables 1.7 beta

Release notes for KeyTable 1.1.5:

• New: Added fnSetPosition function - takes ether (int,int) as coordinates, or (node) and will set the currently focused cell based on that.

Download KeyTable 1.1.5

Release notes for KeyTable 1.1.4:

• Fixed: Hidden columns in a DataTable caused a JS error due to incorrect counting

Download KeyTable 1.1.4

Release notes for FixedHeader 2.0.2:

• Fixed: Scrolling within a scrolling element is now supported
• Fixed: version check wasn't great for older versions of DataTables
• Fixed: Sorting on a column was causing a JS error to pop up (although after the sort had completed)

Download FixedHeader 2.0.2

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