Fullscreen
[Show/Hide Right Column]

Easily arrange content on a page into rows and columns (Cached)
Refresh Print

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.

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:
hey
one two three
hoy

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:
hey
one
two
three
hoy
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?
The table created with a split has a class wikiplugin-split and a class normal if the table with be 100% width

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


Image
  • 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


Alias


Contributors to this page: olinuxx128 points  , Gary Cunningham-Lee1513 points  , DesertWolf858 points  , lindon5653 points  , dieeg114 points  , Marc Laporte8178 points  , aproulx341 points  , mlpvolt4266 points  , Alison49 points  , Xavi64690 points  , xavidp1209 points  and sylvie7160 points  .
Page last modified on Monday 14 February, 2011 17:40:28 UTC by olinuxx128 points .
The content on this page is licensed under the terms of the Creative Commons Attribution-ShareAlike License.

SourceHistorySlideshow

Site Language

Reference Guide

Keywords

These keywords serve as "hubs" for navigation within the Tiki documentation. They correspond to development keywords (bug reports and feature requests):



Tiki Newsletter

Delivered fresh to your email inbox!
Newsletter subscribe icon
Don't miss major announcements and other news!
Contribute to Tiki