![[Show/Hide Right Column]](pics/icons/orightcol.png "[Show/Hide Right Column]"){kind=icon}
Plugin Split
This Wiki Plugin can be used to generate an html table without all the tags. Ideal for creating two or more columns in a wiki page, this plugin allows for wiki syntax and line breaks within the cells of a table, unlike the simple table? syntax. It also supports the inclusion of (multiple) other pages within a table framework and Edit by Section in the wiki.Required parameters are in bold
Preferences required: wikiplugin_split
| Parameters | Accepted Values | Description | Default | Since |
| joincols | y n |
Generate the colspan attribute if columns are missing | y | |
| fixedsize | y n |
Generate the width attribute for the columns | y | |
| colsize | Specify all column widths in number of pixels or percent, separating each width by a pipe (|) | |||
| first | col line |
Cells specified are ordered first left to right across rows (default) or top to bottom down columns | line | |
| edit | y n |
Display edit icon for each section | n | |
| customclass | Add a class to customize the design |
Syntax
Plugin command: {SPLIT(fixedsize=__, colsize=__, joincols=__, first=__ )}additional syntax:
--- separates columns
@@@ separates rows
Parameters: Split uses the following parameters:
joincols=y|n|0|1 : if it is true 'colspan' attribute will be generated if there are cells missing in a row. - default 'y'
fixedsize=y|n|0|1 : 'width' attribute will be generated for TDs - default 'y'
colsize=>size1|size2|...: are the size in pixels by default
or
colsize=>percent%|percent| : using % tiki will take the values as the relative percentage size of each table cell. Numbers that add up to more than 100 will be proportional.
In 1.10:
first=> col|line : col is the editorial way: the column is filled first, line is the html way, the row is filled first e.g.
{SPLIT(first=col)}r1c1---r2c1---r3c1@@@r1c2---r2c2{SPLIT} {SPLIT(first=>line)}r1c1---r1c2@@@r2c1---r2c2{SPLIT}
padding? - the split plugin does not use a cellpadding parameter, but colsize can be used to create narrow "spacer" columns.
In 3.0:
customclass => className : for customizing the design
Examples
To split a page in two or more columns, use --- as the separator:Example:
{SPLIT()} -=hey=- one two three --- -=hoy=- foo bar test {SPLIT}
Produces:
| one two three |
foo bar test |
If you want to do another row, use @@@:
Example:
{SPLIT()} -=hey=- one two three --- -=hoy=- foo bar test @@@ next line1--- next line2{SPLIT}
Produces:
|
one two three | foo bar test |
| next line1 | next line2 |
note: If you want to use the horizontal rule in a split cell ---, you have to use more than 3 dashes ----
In tikiwiki1.10 : There are 2 additional parameters
- first=col|line. The default is line , the behaviour of 1.9 or the html table behavior. First=col enables you to describe first the first column, second the second column.. It is more appropriate for an editorial behavior.
Ex:
{SPLIT(first=col)}r1c1---r2c1---r3c1@@@r1c2---r2c2{SPLIT}
- edit=y to be able to edit the split section (if you have the perms of course). The parameter works only if first=col has been choosen and on a wiki page. It will create a little edit icon in the corner of the split section and will allow you to edit the section without the rest.
FAQ
- How do i make the border disappear?
Bugs
Bugs: Content within the table doesn't seem to be parsed for all tiki markup, it doesn't work for italics, in any case.More Examples
{SPLIT(colsize=300|100|300)}r1c1---r2c1---r3c1@@@r1c2---r2c2{SPLIT}
| r1c1 | r2c1 | r3c1 |
| r1c2 | r2c2 | |
{SPLIT(fixedsize=y, colsize=300|100|300)}r1c1---r2c1---r3c1@@@r1c2---r2c2{SPLIT}
| r1c1 | r2c1 | r3c1 |
| r1c2 | r2c2 | |
{SPLIT(fixedsize=n, colsize=300|100|300)}r1c1---r2c1---r3c1@@@r1c2---r2c2{SPLIT}
| r1c1 | r2c1 | r3c1 |
| r1c2 | r2c2 | |
{SPLIT(fixedsize=n, colsize=20|60|10|10)}r1c1---r2c1---r3c1--r4c1@@@r1c2---r2c2{SPLIT}
| r1c1 | r2c1 | r3c1--r4c1 |
| r1c2 | r2c2 | |
{SPLIT(fixedsize=y, colsize=20|60|10|10)}r1c1---r2c1---r3c1--r4c1@@@r1c2---r2c2{SPLIT}
| r1c1 | r2c1 | r3c1 | r4c1 |
| r1c2 | r2c2 | ||
{SPLIT(fixedsize=y, colsize=20%|60|10|10)}r1c1---r2c1---r3c1--r4c1@@@r1c2---r2c2{SPLIT}
| r1c1 | r2c1 | r3c1 | r4c1 |
| r1c2 | r2c2 | ||
{SPLIT(fixedsize=y, colsize=20|60%|10|10)}r1c1---r2c1---r3c1--r4c1@@@r1c2---r2c2{SPLIT}
| r1c1 | r2c1 | r3c1 | r4c1 |
| r1c2 | r2c2 | ||
{SPLIT(fixedsize=n, colsize=20|60|10|10, joincols=n)}r1c1---r2c1---r3c1--r4c1@@@r1c2---r2c2{SPLIT}
| r1c1 | r2c1 | r3c1--r4c1 |
| r1c2 | r2c2 | |
- What you can see, fixedsize has no importance if colsize is specified.
- If one colsize has a % , the table gets the class normal → 100% width
,
,
,
,
,
,
,
![[toggle]](javascript:icntoggle('mod-DocUserMenul1','module.png'); "[toggle]"){kind=small}
In Progress