fnFilterAll
Apply a common filter to all DataTables on a page
- Author: Kristoffer Karlström
- Deprecated: This plug-in has been deprecated and replaced with other functionality. Please see the detailed description below for more information.
Apply the same filter to all DataTable instances on a particular page. The
function call exactly matches that used by fnFilter()
so regular expression
and individual column sorting can be used.
DataTables 1.10+ provides this ability through its new API, which is able to
to control multiple tables at a time.
$('.dataTable').DataTable().search( ... )
for example will apply the same
filter to all tables on the page. The new API should be used in preference
to this older method if at all possible.
Use
This plug-in can be obtained and used in multiple different ways.
Browser
This plug-in is available on the DataTables CDN:
The plug-in will then automatically register itself against a global DataTables instance. This file can also be used if you are using an AMD loader such as Require.js.
Note that if you are using multiple plug-ins, it can be beneficial in terms of performance to combine the plug-ins into a single file and host it on your own server, rather than making multiple requests to the DataTables CDN.
NPM
The plug-ins are all available on NPM (which can also be used with Yarn or any other Javascript package manager) as part of the datatables.net-plugins
package. To use this plug-in, first install the plug-ins package:
npm install datatables.net-plugins
ES modules
Then, if you are using ES modules, import datatables.net
, any other DataTables extensions you need, and the plug-in:
import DataTable from 'datatables.net';
import 'datatables.net-plugins/api/fnFilterAll.mjs';
CommonJS
If you are using a CommonJS loader for Node (e.g. with older versions of Webpack, or non-module Node code) use the following method to require
the plug-in:
var $ = require('jquery');
var DataTable = require('datatables.net');
require('datatables.net-plugins/api/fnFilterAll.js');
Example
$(document).ready(function() {
var table = $(".dataTable").dataTable();
$("#search").keyup( function () {
// Filter on the column (the index) of this element
table.fnFilterAll(this.value);
} );
});
Version control
If you have any ideas for how this plug-in can be improved, or spot anything that is in error, it is available on GitHub and pull requests are very welcome!
- This plug-in: fnFilterAll.js
- Full DataTables plug-ins repository: DataTables/Plugins