wiki:datatables_plugin

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
wiki:datatables_plugin [2023/02/18 06:44] – removed - external edit (Unknown date) 127.0.0.1wiki:datatables_plugin [2023/02/18 06:44] (current) – ↷ Page moved from contributing:datatables_plugin to wiki:datatables_plugin suedunham
Line 1: Line 1:
 +====== DataTables plugin ======
  
 +[[doku>plugin:datatables|DataTables plugin page]]
 +
 +This plugin makes regular DokuWiki tables sortable and searchable. It's written by the same developer as the ''bootstrap3'' theme, ''Bootstrap Wrapper'', and ''Advanced'' plugins, so it works well in that milieu.
 +
 +===== Basic use =====
 +
 +In the default case, simply enclose a standard table in ''%%<datatables>%%'' tags, as follows:
 +
 +<code>
 +<datatables>
 +^ Make table ^ As usual ^
 +| 123        | 456      |
 +</datatables>
 +</code>
 +
 +===== Particular use cases =====
 +
 +In HârnWiki, this is often used with several options included in the opening tag. For instance, the [[harn:kaldor:]] and [[works:atlas_kelestia:]] pages look like this.
 +
 +<code>
 +<datatables info="false" paging="false">
 +</code>
 +
 +The ''info="false"'' option suppresses the "Showing 1 thru X of X entries" message below the table, and the ''paging="false"'' forces all lines to be displayed rather than the first 10 along with buttons to navigate further.
 +
 +On the [[works:atlas_harnica:]] page, another option is in evidence.
 +
 +<code>
 +<datatables info="false" paging="false" order='[[0, "asc"]]'>
 +</code>
 +
 +This may not strictly be necessary anymore, since this is merely the default  value for the ''order'' setting. However—though it's been some time and memory fades—it may have been useful earlier, before all of the pages in that column had been created, to force the proper sorting of present and missing ones.
 +
 +===== Alternative plugins =====
 +
 +Other plugins have been considered for this role and may very well be preferable in some instances, should circumstances allow. They are discussed on their own pages, [[sortablejs_plugin]] and [[database2_plugin]].