Other improvements include a new ajax.submitAs option which tells DataTables if data should be submitted to the server as HTTP parameters or JSON.

Furthermore, there are various fixes and performance improvements. See the release notes below for full details.

New

• on option which can be used to listen for events during the DataTables initialisation.
• titleRow option (replaces orderCellsTop). This provides the ability to make any row in the header the "title" row.
• ajax.submitAs option to control if data should be submitted as HTTP parameters (default), or a JSON string. This replaces ajax.data being used as a function and returning a string (which is still possible, but not recommended and won't work with SearchPanes and others).
• ordering.handler option which can be used to enable/disable the default column header click-to-order listener.
• ordering.indicator option which can be used to enable/disable the ordering icons in the table's header cells. Both of these options are useful when working with the new ColumnControl extension to allow maximum flexibility of the UI.
• language.lengthLabels option, allowing the options in the page length dropdown to be specified by the language options (including a language file).
• column().name() and columns().names() methods. These are useful if you use columns.name to help identify columns.
• order.listener() can now accept an array of columns to apply multi-column ordering to when activated.
• columnOrder option for selector-modifier to give control of column ordering when using columns().
• Header and footer cell layout now uses flexbox. This involves a new wrapper div in the cells.

Updates

• Safari 8+ supported (it was released in 2014, inline with the DataTables 10 year policy)
• When using titleRow (or the legacy orderCellsTop) columns.title is written to only the title target row.
• destroy() method for updated header / footer
• Table footer content now uses the same flexbox layout as the header

Fixes

• Don't append span.dt-column-order to header rows / cells with data-dt-order=disable.
• Make the DataTable container position: relative for all styling integrations.
• Performance - Faster column selectors. Only building title / name data when needed, and optimised to get the header cells.
• Performance - Header rendered will only run on ordering cells when column-visibility is triggered.
• column().search.fixed() when getting a search that doesn't exist should return null.
• When restoring an ordering state using column names, if a name isn't found, don't use column index 0, just ignore.
• If a draw action happens before data is loaded, the table should still show a loading message.
• After ordering triggered via the API with a named column, column header click to order didn't follow in the expected sequence.
• Possible "Maximum call stack size exceeded." with loading thousands of rows from the DOM.
• Define and document the order that column selectors will resolve to. In short, the order is that specified in the selector array, while a string selector (CSS) will resolve to the index order.
• Fomantic UI workaround for thead > tr > td cells being unstyled

Typescript

• layout didn't account for functions, nodes or jQuery.
• Tighten types for selector-modifier so the strings are explicit in the values they can take.
• OrderArray was missing an empty string option for the direction.
• Improve types of reduce() and reduceRight()
• Add this type to callback functions
• Make args optional in trigger()
• Correct stateLoadCallback type

Docs

• Add note about removing diacritic normalisation
• Correction to parameter types for column-visibility
• Clarify the top level selectors ignore what has gone before

Download DataTables 2.3.0

Core

Fixes

• CSS files should be made up of ASCII characters only, with UTF8 characters consisting of an escaped Unicode code point.
• autocomplete was closing the dropdown before an option could be selected if used in inline mode.
• If datetime is specified with wireFormat and you select a date from the picker, then delete it with the keyboard, the selected date would be submitted.

Node.js

Fixes

• When label and value are the same in an Options instance, don't attempt to read them twice from the db.

PHP

Fixes

• For Mjoin apply the main JOIN before any left joins
• Rename Options->include() to Options->inc() - this is required for PHP 5 compatibility.
• Update return information from Database->insert() to clarify that only insertId should be used from the return.
• When label and value are the same in an Options instance, don't attempt to read them twice from the db.

.NET

Fixes

• Guid (uniqueidentifier) columns could throw an error when writing out JSON to the client-side.
• Manually added options would result in an error being thrown. Updated: New Options.Add(Dictionary) method which can be used to add options with the same structure as the database result and allows the options to be passed through the rendering function. Adding using the other Options.Add() overloads will not be passed through the rendering function.
• When label and value are the same in an Options instance, don't attempt to read them twice from the db.

Download Editor 2.4.2

Fixes

• Performance - faster button look up by storing a node reference rather than traversing the DOM
• Make dropdown scrollable for long lists (Fomantic UI)
• Improve performance for button selection and column visibility
• For styling integrations that wrap container buttons (e.g. Bootstrap), after remove() the container would be left.
• CSS files should be made up of ASCII characters only, with UTF8 characters consisting of an escaped Unicode code point.

Typescript

• Add bom parameter for CSV export
• Correct customizeData option in export options
• Add callback to the button action function signature

Download Buttons 3.2.3

Updated

• Make use of DataTable.use() to get the bootstrap library (requires DT 2.2 and only relevant for Bootstrap 5 in ESM).

Fixes

• Responsive hidden columns with a colspan followed by a rowspan could render incorrectly.
• Only print the colon if the title is not empty
• tabindex for keyboard accessibility wasn't being applied correctly
• tabindex could incorrectly be applied to the final column when Ajax loading data

Download Responsive 3.0.4

Core

Updated

• ajaxData option for tags and autocomplete which can be used to specify additional, custom, data that should be sent to the server as part of the Ajax requests for the field.

Node.js

Fixes

• Error when getting SearchPane and SearchBuilder options

PHP

Fixes

• Editor->actionName() wasn't correctly used for general form submission

Download Editor 2.4.1

Fixes

• Account for null data in Buttons.stripData
• PDF export footer wasn't being styled as a footer, but as a header.
• Add missing semi-colon.

Download Buttons 3.2.2

New

• searchBuilder.rebuild() now has an optional second parameter that will indicate if the DataTable should be drawn when called or not. Default remains to redraw the table.

Fixes

• Dropdowns in Bulma dark mode where white in Chrome
• Array search functions
• Server-side processing with dates and times wasn't working (DT2)
• Dates which were rendered locale specific (DataTable.render.date()) were not treated as dates by SearchBuilder.

Download SearchBuilder 1.8.2

Fixes

• CSS output is ASCII only now - unicode characters are encoded
• Remove @charset from non-minified CSS file (it already wasn't present in the minified file)
• destroy() wasn't removing the extra markup used by DataTables for headers and sorting
• destroy() wasn't removing automatic column classes
• destroy() wasn't removing attributes that had been added to the header cells.
• aria-label for sorting should be on the element with role=button
• ready() would run with the wrong context if it had to wait for init.
• Possible ResizeObserver thrown error due to the height of the table container changing during a column width recalculation.
• If a column data type is null when it is sorted, it should be resolved. This could happen after data has been invalidated (e.g. after column reordering).

Docs

• Add note to some order examples that they are v2 specific

Examples

• Update flexible width example for how DataTables 2.2 works
• Add lang="en" to html tag

Download DataTables 2.2.2