Docs: Add when not to use headers. See #1524

This commit is contained in:
Rob Garrison 2018-05-01 14:08:40 -05:00
parent e5592a7101
commit f92fa2aff2

View File

@ -1001,6 +1001,7 @@
(<span class="version updated">v2.17.1</span>) (<span class="version updated">v2.17.1</span>)
<div class="collapsible"> <div class="collapsible">
<br> <br>
<span class="label label-warning">Warning</span> <strong>Do not</strong> use this option if your header contains multiple rows or any <code>colspan</code> or <code>rowspan</code>. Instead add a data-attribute or class name to the header (see the first demo for an example).<br>
For example, to disable sorting on the first two columns of a table: <code>headers: { 0: { sorter: false}, 1: {sorter: false} }</code>.<br> For example, to disable sorting on the first two columns of a table: <code>headers: { 0: { sorter: false}, 1: {sorter: false} }</code>.<br>
<br> <br>
The plugin attempts to detect the type of data that is contained in a column, but if it can't figure it out then it defaults to alphanumeric. You can easily override this by setting the header argument (or column parser). The plugin attempts to detect the type of data that is contained in a column, but if it can't figure it out then it defaults to alphanumeric. You can easily override this by setting the header argument (or column parser).