====== tablelayout Plugin ======

---- plugin ----
description: Set the width of table columns, freeze header rows, float the table, integrates with edittable plugin
author     : Michael Große 
email      : dokuwiki@cosmocode.de 
type       : syntax, action
lastupdate : 2022-03-28
compatible : Hogfather, Greebo, Frusterick Manners, Igor
depends    : 
conflicts  : datatables, tabinclude, tablewidth, template:bootstrap3
similar    : datatables, tablewidth, wrap
tags       : tables

downloadurl: https://github.com/cosmocode/dokuwiki-plugin-tablelayout/zipball/master
bugtracker : https://github.com/cosmocode/dokuwiki-plugin-tablelayout/issues
sourcerepo : https://github.com/cosmocode/dokuwiki-plugin-tablelayout/
donationurl: 

screenshot_img : 
----

[[https://travis-ci.org/cosmocode/dokuwiki-plugin-tablelayout|{{https://travis-ci.org/cosmocode/dokuwiki-plugin-tablelayout.png?branch=master&recache}}]]

[[https://www.cosmocode.de/en/open-source/dokuwiki-plugins/|{{ https://www.cosmocode.de/static/img/dokuwiki/dwplugins.png|A CosmoCode Plugin}}]]

===== Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Examples/Usage =====

The following example syntax will make the first fixed and show about 2 other rows in a scrollable container below. It will make the first column 20px wide and the second 30px. The table itself will be floating to the right.
<code>
{{tablelayout?colwidth="20px,30px"&rowsHeaderSource=1&rowsVisible=2&float=right}}
^ header 1 ^ header 2 ^
| cell A1 | cell B1 |
| cell A2 | cell B2 |
| cell A3 | cell B3 |
</code>

===== Syntax =====
The basic boilerplate is ''%%{{tablelayout?%%//options//%%}}%%''. The options are specified like URL parameters:

==== Column widths ====
The option is ''colwidth'' and it expects a ''%%"%%''-wrapped, '',''-separated list of column-widths including the ''px'' unit. If you do not want to define the width of an element use ''-''.

==== fixed header rows ====
You have to specify the two options ''rowsHeaderSource'' and ''rowsVisible''. The first expects a positive integer specifying the number of rows that are fixed at the top. ''rowsVisible'' sets the number of rows that are visible below the fixed rows.

''rowsHeaderSource'' can be set to ''Auto''.

==== Floating ====
The option ''float'' takes one of three possible values: ''left'', ''right'', ''center''. ''left'' and ''right'' let the table float to the left or right, ''center'' centers the table on the page.

==== Search ====
By setting ''%%tableSearch=1%%'' fields will be added above every column and one for the entire table.

==== Sort ====
By setting ''%%tableSort=1%%'' sort buttons will be added for every column.

==== Print ====
By setting ''%%tablePrint=1%%'' a print button is added below the table, that opens only the table in a new window and triggers the browser's print dialog.

===== Development =====



==== Commit-Ticker ====

{{rss>https://github.com/cosmocode/dokuwiki-plugin-tablelayout/commits/master.atom date}}

**Releases:**
{{rss>https://github.com/cosmocode/dokuwiki-plugin-tablelayout/releases.atom description author}}


===== Tips =====

  * Making this work with Internet Explorer requires a polyfill for javascripts ''repeat()'' function. \\ The easiest way i know is adding the content of [[https://gist.github.com/warlock/a614334cad7ffa4fccbeec69afe5a82b]] to the file ''conf/userscript.js'' (create the file if it doesn't exist).