1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
|
<?xml version="1.0" encoding="UTF-8" ?>
<dt-api group="core">
<name>$()</name>
<summary>Perform a jQuery selection action on the full table.</summary>
<since>1.10</since>
<type type="function">
<signature>$( selector [, modifier ] )</signature>
<description>Perform a jQuery selector on the rows and contents of the rows in the tables' `dt-tag tbody` elements.</description>
<parameter type="node|jQuery|string" name="selector">
[jQuery selector](http://api.jquery.com/jQuery/#jQuery1) to perform on the nodes inside the table's tbody tag.
</parameter>
<parameter type="selector-modifier" name="modifier" default="">
Option used to specify how the content's of the selected columns should be ordered, and if paging or filtering in the table should be taken into account. This is only useful for operations which involve rows, such as `dt-api column().nodes()` and `dt-api column().data()`.
</parameter>
<returns type="jQuery">jQuery object with the matched elements in its result set.</returns>
</type>
<description>
DataTables makes heavy use of DOM manipulation, removing rows from the document for paging and searching, and removing columns from the document for column visibility, among other actions. jQuery will not find these removed DOM elements when using a standard jQuery statement since it uses the document as the root element and some nodes under DataTables' control have been removed from the document.
To provide an easy method to continue using jQuery on these elements, so you can select elements regardless of searching, paging or any other feature of DataTables this method is provided.
The selector given to the `dt-api $()` method will be run on all of the `dt-tag tr` elements in the table, and their descendent elements, with the found elements being returned as a jQuery object.
</description>
<example title="Find all cells with content's 'High' and add a class"><![CDATA[
var table = $('#example').DataTable();
table
.$(':contains("High")')
.addClass('important');
]]></example>
</dt-api>
|
