Jump to a page by searching for data from a column
- Author: Allan Jardine
- Requires: DataTables 1.10+
It can be quite useful to jump straight to a page which contains a certain piece of data (a user name for example). This plug-in provides exactly that ability, searching for a given data parameter from a given column and immediately shifting the paging of the table to jump to that point.
If multiple data points match the requested data, the paging will be shifted to show the first instance. If there are no matches, the paging will not change.
Note that unlike the core DataTables API methods, this plug-in will
draw() to redraw the table with the current page
This plug-in can be obtained and used in multiple different ways.
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.
datatables.net-plugins package. To use this plug-in, first install the plug-ins package:
npm install datatables.net-plugins
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';
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');
var table = $('#example').DataTable();
table.page.jumpToData( "Allan Jardine", 0 );
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!