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
35
36
37
38
39
|
<?xml version="1.0" encoding="UTF-8" ?>
<dt-option group="option">
<name>orderCellsTop</name>
<summary>Control which cell the order event handler will be applied to in a column</summary>
<since>1.10</since>
<type type="boolean" />
<default>false</default>
<description><![CDATA[
Allows control over whether DataTables should use the top (`true`) unique cell that is found for a single column, or the bottom (`false` - default) to attach the default order listener. This is useful when using complex headers.
Consider for example the following HTML header:
```html
<thead>
<tr>
<td rowspan="2">1</td>
<td>2.1</td>
</tr>
<tr>
<td>2.2</td>
</tr>
</thead>
```
In this case, when `dt-init orderCellsTop` is `false` (default) the cells `string 1` and `string 2.2` will have the order event listener applied to them. If `dt-init orderCellsTop` is `true` then `string 1` and `string 2.1` will have the order event listeners applied to them.
]]></description>
<example title="Use the top cells in a complex header for ordering"><![CDATA[
$('#example').dataTable( {
"orderCellsTop": true
} );
]]></example>
<related type="option">ordering</related>
<related type="option">order</related>
<related type="api">order()</related>
</dt-option>
|
