New

• Bookmarkable states! The new stateRestore.bookmark configuration option can be used to control how StateRestore can load a state identified by the page URL, allowing the end user to create custom states and bookmark them, or for you to be able to create links to a table in a specific state. See the examples for a full run through of what is possible with this new feature.

Examples

• Added SearchPanes example

Download StateRestore 2.2.0

Please note as well that SearchPanes is now a DataTables Plus extension.

New

• SearchPanes is now part of DataTables Plus
• Remove jQuery dependency
• Support DataTables 3 (requires 3.1+)
• CSS variables for controlling the focus cell styling

Updates

• ES6 output target from TypeScript
• SearchPanes can now be evaluated in a windowless environment without executing browser DOM code. This allows it to be imported in React Server Components and SSR frameworks such as Next.js.
• -searchPanes.container() will now return a DataTable.Dom instance, rather than a jQuery instance.

Examples

• Update to remove remaining jQuery initialisation version of each example, and focus on the Vanilla JS code for simplicity and consistency throughout the DataTables examples.

Docs

• Updated for the more consistent naming convention used for DataTables' defined types in DT3

Download SearchPanes 3.0.0

Security

• Resolve prototype pollution potential in util.assignDeep and util.assignDeepObject

Fixes

• Dom.prototype.prepend() did not prepend elements if a jQuery object was passed in
• On destroy, any hidden columns should be made visible again.
• Typescript - jQuery interface was giving an error in the types file
• Typescript - Match jQuery interface to jQuery's own, so there isn't a conflict

Download DataTables 3.1.4

Fixes

• A table overflowing its container wouldn't match the table and column widths when switching into floating mode (in Chrome).
• Tables which collapse their width due to horizontal overflow could result in misalignment of the header when "fixed".

Download FixedHeader 5.1.2

New

• New: columns.widthCalc option which can be used to limit the column width calculations to use the data from the current page only. This is particularly useful for React / Vue integration, which can have child components that require to be rendered before display.

Updates

• Update: Typescript - formally export the types for column data and render options.

Fixes

• Fix: A column which was initially hidden wasn't then click orderable when made visible
• Fix: Address error when sizing a table (columns().widths()) when used with DOMPurify.
• Fix: Smooth scrolling with a trackpad wasn't smooth (scrollX)
• Fix: Typescript definition for columns should allow null entries

Download DataTables 3.1.3

Fixes

• Nuget package versioning requirements for the styling packages
• NPM packages for the styling packages now include a style export for easy resolving of CSS from just the module name when used with a CSS bundler.

Download Editor 3.1.1

Fixes

• Nuget package versioning requirements for the styling packages
• NPM packages for the styling packages now include a style export for easy resolving of CSS from just the module name when used with a CSS bundler.

Download StateRestore 2.1.1

Fixes

• Nuget package versioning requirements for the styling packages
• NPM packages for the styling packages now include a style export for easy resolving of CSS from just the module name when used with a CSS bundler.
• Types: add select property to the DataTables state object

Download Select 4.1.1

Fixes

• Nuget package versioning requirements for the styling packages
• NPM packages for the styling packages now include a style export for easy resolving of CSS from just the module name when used with a CSS bundler.
• Types: include searchBuilder property in the AjaxData interface for DataTables' ajax requests

Download SearchBuilder 2.1.1

Fixes

• Nuget package versioning requirements for the styling packages
• NPM packages for the styling packages now include a style export for easy resolving of CSS from just the module name when used with a CSS bundler.
• Types: table saved state object interface was missing the scroller property

Download Scroller 3.1.1

Fixes

• Nuget package versioning requirements for the styling packages
• NPM packages for the styling packages now include a style export for easy resolving of CSS from just the module name when used with a CSS bundler.

Download RowReorder 2.1.1

Fixes

• Nuget package versioning requirements for the styling packages
• NPM packages for the styling packages now include a style export for easy resolving of CSS from just the module name when used with a CSS bundler.

Download RowGroup 2.1.1

Fixes

• Nuget package versioning requirements for the styling packages
• NPM packages for the styling packages now include a style export for easy resolving of CSS from just the module name when used with a CSS bundler.

Download Responsive 4.1.1

Fixes

• Nuget package versioning requirements for the styling packages
• NPM packages for the styling packages now include a style export for easy resolving of CSS from just the module name when used with a CSS bundler.
• Types: add keyTable property to DataTables' state object

Download KeyTable 3.1.1

Fixes

• Nuget package versioning requirements for the styling packages
• NPM packages for the styling packages now include a style export for easy resolving of CSS from just the module name when used with a CSS bundler.
• Fix: When there was a nested table in the host DataTable, the headers would clash, resulting in rendering errors

Download FixedHeader 5.1.1

Fixes

• Nuget package versioning requirements for the styling packages
• NPM packages for the styling packages now include a style export for easy resolving of CSS from just the module name when used with a CSS bundler.
• Types: DataTables API wasn't being correctly extended with the fixedColumns() method.

Download FixedColumns 6.1.1

Fixes

• NPM packages for the styling packages now include a style export for easy resolving of CSS from just the module name when used with a CSS bundler.

Download DateTime 2.1.2

Fixes

• Nuget package versioning requirements for the styling packages
• NPM packages for the styling packages now include a style export for easy resolving of CSS from just the module name when used with a CSS bundler.
• Types: Add interface information for ColumnControl's Ajax and State integration with DataTables

Download ColumnControl 2.1.2

Fixes

• Nuget package versioning requirements for the styling packages
• NPM packages for the styling packages now include a style export for easy resolving of CSS from just the module name when used with a CSS bundler.
• Types: state save object doesn't have the colReorder property

Download ColReorder 3.1.2

Fixes

• Nuget package versioning requirements for the styling packages
• NPM packages for the styling packages now include a style export for easy resolving of CSS from just the module name when used with a CSS bundler.
• Types: state save object doesn't have the cardView property

Download CardView 1.1.2

Fixes

• Nuget package versioning requirements for the styling packages
• NPM packages for the styling packages now include a style export for easy resolving of CSS from just the module name when used with a CSS bundler.

Download Buttons 4.1.2

Fixes

• Nuget package versioning requirements for the styling packages
• NPM packages for the styling packages now include a style export for easy resolving of CSS from just the module name when used with a CSS bundler.

Download AutoFill 3.1.2

Fixes

• Types: Ajax as a function now has its data parameter typed and additional Ajax interfaces exported
• Types: column().nodes() was returning an array in an API result set, rather than just the nodes in the result set.
• Types: Exporting the order interface types
• Types: Improve types for state loading and saving callbacks to make use of the State and StateLoad interfaces (rather than just object)
• Nuget package versioning requirements for the styling packages
• NPM packages for the styling packages now include a style export for easy resolving of CSS from just the module name when used with a CSS bundler.

Download DataTables 3.1.2

Fixes

• npm package didn't include the dist files

Download DateTime 2.1.1

This release also supports evaluation of the code in a windowless environment (e.g. directly in Node.js) and is released alongside DataTables 3.1, upon which it depends to support this.

There are also improvements in the code to help with using Editor in a Next.js environment. For full details, please see below.

New

• table will now accept a React, Vue or Angular reference to the host DataTable.
• Editor can now be evaluated in a windowless environment without executing browser DOM code. This allows it to be imported in React Server Components and SSR frameworks such as Next.js.

Fixes

• for attribute in label elements shouldn't have a # prefix
• Update styling integration type files to use the global npm package

Download Editor 3.1.0

This release also supports evaluation of the code in a windowless environment (e.g. directly in Node.js) and is released alongside DataTables 3.1, upon which it depends to support this.

Updates

• StateRestore can now be evaluated in a windowless environment without executing browser DOM code. This allows it to be imported in React Server Components and SSR frameworks such as Next.js.

Fixes

• Header for DT default styling file had incorrect naming

Download StateRestore 2.1.0

This release also supports evaluation of the code in a windowless environment (e.g. directly in Node.js) and is released alongside DataTables 3.1, upon which it depends to support this.

Updates

• Select can now be evaluated in a windowless environment without executing browser DOM code. This allows it to be imported in React Server Components and SSR frameworks such as Next.js.

Fixes

• Typescript options in DataTables' initialisation object weren't working correctly

Download Select 4.1.0

This release also supports evaluation of the code in a windowless environment (e.g. directly in Node.js) and is released alongside DataTables 3.1, upon which it depends to support this.

Updates

• SearchBuilder can now be evaluated in a windowless environment without executing browser DOM code. This allows it to be imported in React Server Components and SSR frameworks such as Next.js.

Download SearchBuilder 2.1.0

This release also supports evaluation of the code in a windowless environment (e.g. directly in Node.js) and is released alongside DataTables 3.1, upon which it depends to support this.

Updates

• Scroller can now be evaluated in a windowless environment without executing browser DOM code. This allows it to be imported in React Server Components and SSR frameworks such as Next.js.

Fixes

• Typescript options in DataTables' initialisation object weren't working correctly

Download Scroller 3.1.0

This release also supports evaluation of the code in a windowless environment (e.g. directly in Node.js) and is released alongside DataTables 3.1, upon which it depends to support this.

Updates

• RowReorder can now be evaluated in a windowless environment without executing browser DOM code. This allows it to be imported in React Server Components and SSR frameworks such as Next.js.

Fixes

• Typescript options in DataTables' initialisation object weren't working correctly

Download RowReorder 2.1.0

This release also supports evaluation of the code in a windowless environment (e.g. directly in Node.js) and is released alongside DataTables 3.1, upon which it depends to support this.

Updates

• RowGroup can now be evaluated in a windowless environment without executing browser DOM code. This allows it to be imported in React Server Components and SSR frameworks such as Next.js.

Fixes

• Security: The default renderer will now escape HTML to prevent possible XSS attacks

Download RowGroup 2.1.0

This release also supports evaluation of the code in a windowless environment (e.g. directly in Node.js) and is released alongside DataTables 3.1, upon which it depends to support this.

Updates

• Responsive can now be evaluated in a windowless environment without executing browser DOM code. This allows it to be imported in React Server Components and SSR frameworks such as Next.js.

Download Responsive 4.1.0

This release also supports evaluation of the code in a windowless environment (e.g. directly in Node.js) and is released alongside DataTables 3.1, upon which it depends to support this.

Updates

• KeyTable can now be evaluated in a windowless environment without executing browser DOM code. This allows it to be imported in React Server Components and SSR frameworks such as Next.js. fatal: No names found, cannot describe anything.

Fixes

• Typescript options in DataTables' initialisation object weren't working correctly

Download KeyTable 3.1.0

This release also supports evaluation of the code in a windowless environment (e.g. directly in Node.js) and is released alongside DataTables 3.1, upon which it depends to support this.

Updates

• FixedHeader can now be evaluated in a windowless environment without executing browser DOM code. This allows it to be imported in React Server Components and SSR frameworks such as Next.js.

Fixes

• Typescript options in DataTables' initialisation object weren't working correctly
• Rename header comment for FixedHeader module

Download FixedHeader 5.1.0

This release also supports evaluation of the code in a windowless environment (e.g. directly in Node.js) and is released alongside DataTables 3.1, upon which it depends to support this.

Updates

• FixedColumns can now be evaluated in a windowless environment without executing browser DOM code. This allows it to be imported in React Server Components and SSR frameworks such as Next.js.

Fixes

• Typescript options in DataTables' initialisation object weren't working correctly

Download FixedColumns 6.1.0

This release also supports evaluation of the code in a windowless environment (e.g. directly in Node.js) and is released alongside DataTables 3.1, upon which it depends to support this.

Updates

• DateTime can now be evaluated in a windowless environment without executing browser DOM code. This allows it to be imported in React Server Components and SSR frameworks such as Next.js.

Download DateTime 2.1.0

Fix

• Add missing void types file for CSS imports to styling packages

Download ColumnControl 2.1.1

Fix

• Add missing void types file for CSS imports to styling packages

Download ColReorder 3.1.1

Fix

• Add missing void types file for CSS imports to styling packages

Download CardView 1.1.1

Fix

• Add missing void types file for CSS imports to styling packages

Download Buttons 4.1.1

Fix

• Add missing void types file for CSS imports to styling packages

Download AutoFill 3.1.1

Fix

• Add missing void types file for CSS imports to styling packages

Download DataTables 3.1.1

This release also supports evaluation of the code in a windowless environment (e.g. directly in Node.js) and is released alongside DataTables 3.1, upon which it depends to support this.

Updates

• ColReorder can now be evaluated in a windowless environment without executing browser DOM code. This allows it to be imported in React Server Components and SSR frameworks such as Next.js.

Fixes

• Fix: When a table is completely empty, the first header row created will no longer automatically be marked as data-dt-order=disable.

Download ColumnControl 2.1.0

This release also supports evaluation of the code in a windowless environment (e.g. directly in Node.js) and is released alongside DataTables 3.1, upon which it depends.

Updates

• ColReorder can now be evaluated in a windowless environment without executing browser DOM code. This allows it to be imported in React Server Components and SSR frameworks such as Next.js.

Download ColReorder 3.1.0

This release also supports evaluation of the code in a windowless environment (e.g. directly in Node.js) and is released alongside DataTables 3.1, upon which it depends.

Updates

• CardView can now be evaluated in a windowless environment without executing browser DOM code. This allows it to be imported in React Server Components and SSR frameworks such as Next.js.

Fixes

• If state saving wasn't used, and in card view at table init time, the page length wouldn't be changed automatically to fit.
• Example: The specific data template example used CSS variables that weren't available for all style libraries

Download CardView 1.1.0

This release also supports evaluation of the code in a windowless environment (e.g. directly in Node.js) and is released alongside DataTables 3.1, upon which it depends.

Updates

• Buttons can now be evaluated in a windowless environment without executing browser DOM code. This allows it to be imported in React Server Components and SSR frameworks such as Next.js.

Download Buttons 4.1.0

This release also supports evaluation of the code in a windowless environment (e.g. directly in Node.js) and is released alongside DataTables 3.1, upon which it depends.

Updates

• AutoFill can now be evaluated in a windowless environment without executing browser DOM code. This allows it to be imported in React Server Components and SSR frameworks such as Next.js.

Download AutoFill 3.1.0

• Support for evaluation in window-less environments. This is to make it much easier to use DataTables in React server side components (e.g. with Next.js and similar)
• Improvements to the npm packaging to allow Node and bundlers to use the ESM files natively (rather than falling back to the module flag.

There are a couple of fixes, but no significant changes to the actual functional code of DataTables.

New

• DataTables can now be loaded in a windowless environment such as Next.js.
• Dom.on() static method for listening to events in a windowless environment (used by most extensions to listen for initialisation of a DataTable)
• NPM packaging:
  • Improved ESM loading. Now uses exports so Node and bundlers will see the ESM modules natively.
  • CSS target in exports so you can now do import 'datatables.net-bs5/css'; for example
  • Void types file for CSS so Typescript doesn't give an error on them

Updated

• Altering the trial flow to be more explicit and less confusing

Fixes

• If the page had an element with the id jQuery and jQuery wasn't loaded, the element would be used as the jQuery library! This of course resulted in an error.
• When nested tables are present, the column width calculations could be wrong, resulting in one column gaining more width than it should.
• Use explicit ./ prefix for paths in npm packaging

Download DataTables 3.1.0

Fixes

• statesRemoveAll was incorrectly aliased

Download StateRestore 2.0.1

Editor - 3.0.1 to HEAD

Core

• Update: Submitting without a key will show an error
• Fix: Add columns.editField to the Typescript types for DataTables' columns
• Fix: Delete message wasn't visible if the modal was used after inline editing

.NET

• New: Support for StateRestore 2 with a new StateRestore class that can be used to provide an end point for reading, creating, editing and deleting states.

Node.js

• New: Support for StateRestore 2 with a new StateRestore class that can be used to provide an end point for reading, creating, editing and deleting states.

PHP

• New: Support for StateRestore 2 with a new StateRestore class that can be used to provide an end point for reading, creating, editing and deleting states.

Python

• New: Support for StateRestore 2 with a new StateRestore class that can be used to provide an end point for reading, creating, editing and deleting states.
• Fix: Arrays were not being correctly parsed into Lists

Download Editor 3.0.2

Fixes

• Fix: Column widths with Ajax sourced tables were not optimised
• Fix: DataTable.util.object.assignDeepObjects() will recursively use the same array handling now, rather than deep copying nested arrays. This allows DataTable.defaults.column to now be set correctly.
• Fix: titleRow when used with a header that has rowspan attributes would result in some header cells being missed for the ordering icons and handler.
• Fix: Setting DataTable.defaults.ordering as an object could result in auto initialisation of ordering for a second table, even if it was disabled.
• Fix: :visible selector with a multi-row header could result in the wrong columns being selected.
• Fix: Bootstrap - when using table-sm width a text alignment class could result in no spacing for the ordering icons

Download DataTables 3.0.4

Please see the blog post for further information about this new release, and the upgrade notes if you are updating from v1.

Please note as well that StateRestore is now a DataTables Plus extension.

New

• Table UI for state management (statesTable)
• Ability to set a default state
• First class Ajax support, with the server-side libraries providing a StateRestore helper class for an end point to handle all requests.
• Ability to share states when using Ajax
• Options to include, exclude or let the user decide each state property
• Minified file is 50% smaller that v1

Download StateRestore 2.0.0

Fixes

• Date search when auto-locale formatted with Moment or Luxon was not matching values
• Typescript options in DataTables' initialisation object weren't working correctly
• Update for DataTables 3 exported types naming
• Use a debounce mechanism when searchDelay is enabled, rather than a throttle.
• Docs - Updating for use of Dom rather than jQuery

Download SearchBuilder 2.0.1

Fixes

• Dark mode in Chrome - the search operation type select's were bright white.
• When colReorder is used, while attached to the header cells, rather than to a ColumnControl button, a JS error could occur while reordering columns.
• Typescript options for DataTables options (main and columns) were incomplete (requires DataTables 3.0.3 for the columns).

Download ColumnControl 2.0.2

Fixes

• State wasn't reloading if state() was used as a setter
• Typescript types didn't extend the correct interface name from DataTables core

Download ColReorder 3.0.2

Fixes

• State wasn't reloading if state() was used as a setter
• Typescript types didn't extend the correct interface name from DataTables core

Download CardView 1.0.3

Fixes

• Typescript interface for DataTables configuration options and defaults

Download AutoFill 3.0.1

Fixes

• Keyboard activation of Buttons wasn't working
• Typescript definition for language options extended the wrong DataTables core interface name

Download Buttons 4.0.3

Fix

• Using a control column could cause an index offset, resulting in data that should be shown not (typically the final cell in a row).

Download Responsive 4.0.3

Fixes

• ^$ regex search should match empty strings
• For DataTable.ajax() with dataType: 'json' add an Accept header giving weight to JSON content type. This matches jQuery.ajax().
• Improvements to typing for stateSaveCallback.
• stateLoadCallback can accept a partial start (StateLoad)
• Negative numbers when used with the render.number() rendering helper would display incorrectly
• On JSON parsing error, thea typo prevented the correct status text from being set
• Child row state saving could be lost on reload
• Typescript - stateLoadCallback now allows either an undefined return (for async actions) or a partial state response.

Docs

• Add number type to scrollY
• Document DataTable.State as its own type

Download DataTables 3.0.3

Fixes

• Fix: The flag indicating an automatic change on the change events from input elements in the form was not triggering.

Docs

• Correct links for buttons.

Download Editor 3.0.1

Updates

• Updated: Formalise the :visible selector for DataTable.ColumnSelector. The ability to prefix the pseudo selector with any DOM selector string is now part of the documentation and testing. Selector code relaxed to allow other pesudo selectors to prefix this one (although :visible must come last in the sequence).

Fixes

• Column sizing could be incorrect when using scrollX. This was particularly noticeable with ColReorder, but also apparent when adding new data with long strings.
• If setting a key before the body has loaded, an error could be thrown.
• Infinite loop of requesting data if a check for invalidated data types triggers a draw, which happens in ColumnControl's date filter.
• on event handlers should have a DataTableEvent type, as they have the .dt property available on the event object for API access.
• When used in http: (i.e. non-secure connection) the APIs for DataTables Plus key are not available. A message is now shown for this specific case with a link that details how to resolve this by including the new "Key Validator Shim" package in the download builder.

Download DataTables 3.0.2

Fixes

• When invalidating a row (from data, not HTML) and a cell in the row uses the select checkbox renderer, it would incorrectly show as checked.

Download Select 4.0.1

Fixes

• Modal for Bootstrap and Bulma integrations would throw a JS error

Download Responsive 4.0.2

Fixes

• Only rerun search on date type change if client-side processing

Docs

• Clarify searchDropdown and how it inherits config options

Download ColumnControl 2.0.1

Fixes

• Dragged element positioning is ineffectual due to missing css units
• Error when using automatic state save and restore

Download ColReorder 3.0.1

New

• Full support for DataTables' column visibility and a new example showing that.

Fixes

• Auto display wouldn't show cards when resized down
• Column visibility changes in table mode weren't propagated to card view
• When resizing down to trigger card view, the cards were not shown
• When used with processing enabled in the DataTable, when switching from card to table view, the processing indicator would show indefinitely.

Download CardView 1.0.2

Fixes

• buttons.info() popover wasn't displaying (resulting in no confirmation message for the copy export).
• Background for fixed layout popover in DataTables styling didn't have a dark mode colour.
• Bulma does not require FontAwesome, so we need to provide a fallback for the dropdown arrow indicator when it hasn't been loaded.

Download Buttons 4.0.2

Fixes

• Plus upgrade notice was shown when a valid Editor license was used
• If ajax is used as a function and doesn't return an XMLHttpRequest, an error shouldn't be thrown when calling ajax.reload().
• When the page length was set to -1, the paging control wasn't correctly updated
• ? would be appended to a URL when making an Ajax request, even if there were no query parameters. No functional impact, but untidy.

Types

• Expose CellMeta and ColumnRenderFunction types for use with columns.render as a function.
• Add typeDetect option to initialisation options
• Fix: Expose type detection interface types
• Fix: Table events which are added with on() or one() have a custom dt property available on the event object to allow easy access to the table's API for the event. This is now present in the TypeScript event for those functions.
• Fix: row().child() allows boolean values in the first parameter to hide / show an existing child row.
• Fix: row().child() returns a Dom interface, not jQuery in v3.

Docs

• Correct 404 links
• Update for unique property naming
• Update some inaccurate JSDoc @param items in the code

Download DataTables 3.0.1

• Resizing a card view table would cause an exessive number of redraws
• Page length wasn't being retored when using CardView with stateSave

Download CardView 1.0.1

Fixes

• The default child row renderer would not remove the final column when the table is made wider again.

Download Responsive 4.0.1

Fixes

• Bootstrap 4 - dropdown wasn't showing

Download Buttons 4.0.1