Difference between revisions of "Template:Column templates"
|  (→See also:  Split out the list of others to a sub-template, so it can more easily be re-used) | Tom Neiser  (Talk | contribs)  m (19 revisions: Column template) | ||
| (16 intermediate revisions by 11 users not shown) | |||
| Line 1: | Line 1: | ||
| {{#switch:{{lc:{{PAGENAME}}}} | {{#switch:{{lc:{{PAGENAME}}}} | ||
| − | | col-2 = The [[Template:Col-2]] sets column width for each of  | + | | col-2 = The [[Template:Col-2]] sets column width for each of two columns, with align=left, valign=top. The width, align or valign can be changed: <nowiki>{{col-2 |width=40%|align=right|valign=center}}</nowiki>.<br/><br/> | 
| − | | col-3 = The [[Template:Col-3]] sets column width for each of  | + | | col-3 = The [[Template:Col-3]] sets column width for each of three columns, with align=left, valign=top. The width, align or valign can be changed: <nowiki>{{col-3 |width=25%|align=right|valign=center}}</nowiki>.<br/><br/> | 
| − | | col-4 = The [[Template:Col-4]] sets column width for each of  | + | | col-4 = The [[Template:Col-4]] sets column width for each of four columns.<br/><br/> | 
| − | | col-5 = The [[Template:Col-5]] sets column width for each of  | + | | col-5 = The [[Template:Col-5]] sets column width for each of five columns.<br/><br/> | 
| − | | col-6 = The [[Template:Col-6]] sets column width for each of  | + | | col-6 = The [[Template:Col-6]] sets column width for each of six columns, with align=left, valign=top. The width, align or valign can be changed: <nowiki>{{col-6 |width=20%|align=right|valign=center}}</nowiki>.<br/><br/> | 
| − | | col-start=The [[Template:Col-start]] begins a wikitable (same as <nowiki>{{col-begin}}</nowiki>).<br><br> | + | | col-start=The [[Template:Col-start]] begins a wikitable (same as <nowiki>{{col-begin}}</nowiki>).<br/><br/> | 
| }} | }} | ||
| + | {{Template:Column Templates Navbox}} | ||
| + | |||
| The {{tl|col-begin}}, {{tl|col-break}} and {{tl|col-end}} templates control columns of text on a page: | The {{tl|col-begin}}, {{tl|col-break}} and {{tl|col-end}} templates control columns of text on a page: | ||
| − | :*<nowiki>{{col-begin}}</nowiki>  | + | :*<nowiki>{{col-begin}}</nowiki>: starts a table (followed by <nowiki>{{col-break}}</nowiki> for 1st column) | 
| − | :*<nowiki>{{col-break}}</nowiki>  | + | :*<nowiki>{{col-break}}</nowiki>: triggers the start of each column | 
| − | :*<nowiki>{{col-end}}</nowiki>  | + | :*<nowiki>{{col-end}}</nowiki>: ends the multi-column table. | 
| The widths of columns can be specified by using various additional codes. See below for examples. | The widths of columns can be specified by using various additional codes. See below for examples. | ||
| − | + | == Usage == | |
| − | :: <nowiki>{{col-begin|width=70%}}</nowiki>  | + | :: <nowiki>{{col-begin|width=70%}}</nowiki>: start table with width. | 
| − | :: <nowiki>{{col-break|width=66%}}</nowiki>  | + | :: <nowiki>{{col-break|width=66%}}</nowiki>: start column-1 as 66% wide. | 
| :: This is text in col-1. | :: This is text in col-1. | ||
| − | :: <nowiki>{{col-break|width=33%}}</nowiki>  | + | :: <nowiki>{{col-break|width=33%}}</nowiki>: start column-2 as 33% wide. | 
| :: Text column-2. | :: Text column-2. | ||
| :: <nowiki>{{col-end}}</nowiki> | :: <nowiki>{{col-end}}</nowiki> | ||
| − | The table will have  | + | The table will have two columns, with column 1 twice (2×) the width of column 2. | 
| − | A border of 2px (1px width on each side) corresponds to a 5%. Therefore, with a 2px  | + | A border of 2px (1px width on each side) corresponds to a 5%. Therefore, with a 2px border—for example, as in [[Wikipedia:Tutorial/Wrap-up and more info]]—the width needs to be 95% for the table to fit within the screen. Since it's possible that some tables might not have a border, correction on the individual page could be made after substitution. Another way to create a two column table is like this: | 
| {| | {| | ||
| Line 38: | Line 40: | ||
| {{col-begin}} | {{col-begin}} | ||
| − | + | {{col-break}} | |
| − | {{col- | + | |
| − | + | ||
|   {{tl|Col-begin}} |   {{tl|Col-begin}} | ||
|   {{tl|Col-2}} |   {{tl|Col-2}} | ||
| Line 47: | Line 47: | ||
|   Column 2 here |   Column 2 here | ||
|   {{tl|Col-end}} |   {{tl|Col-end}} | ||
| − | + | {{col-break|gap=2em}} | |
| − | {{col- | + | |
| − | + | ||
|   {{tl|Col-begin}} |   {{tl|Col-begin}} | ||
|   {{tl|Col-3}} |   {{tl|Col-3}} | ||
| Line 58: | Line 56: | ||
|   Column 3 here |   Column 3 here | ||
|   {{tl|Col-end}} |   {{tl|Col-end}} | ||
| − | + | {{col-break|gap=2em}} | |
| − | {{col- | + | and so on, up to {{tl|Col-5}} | 
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| {{col-end}} | {{col-end}} | ||
| {{col-begin}} | {{col-begin}} | ||
| − | + | {{col-break}} | |
| − | {{col- | + |   {{[[Template:Col-begin|Col-begin]]}} | 
| − | + | ||
| − |   {{[[Template:Col-begin|Col-begin]] | + | |
|   {{tl|Col-break}} |   {{tl|Col-break}} | ||
|   Column 1 here |   Column 1 here | ||
| Line 96: | Line 76: | ||
|   Column 6 here |   Column 6 here | ||
|   {{tl|Col-end}} |   {{tl|Col-end}} | ||
| − | + | {{col-break|gap=2em}} | |
| − | {{col- | + | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
|   {{[[Template:Columns-start|Columns-start]]|num=3}} |   {{[[Template:Columns-start|Columns-start]]|num=3}} | ||
|   Column 1 here |   Column 1 here | ||
| Line 114: | Line 84: | ||
|   Column 3 here |   Column 3 here | ||
|   {{tl|Columns-end}} |   {{tl|Columns-end}} | ||
| + | {{col-end}} | ||
| − | {{col- | + | {{col-begin}} | 
| − | + | {{col-break|width=50%}} | |
|   {{tl|Multicol}} |   {{tl|Multicol}} | ||
|   Column 1 here |   Column 1 here | ||
| Line 126: | Line 97: | ||
|   Column 4 here |   Column 4 here | ||
|   {{tl|Multicol-end}} |   {{tl|Multicol-end}} | ||
| − | |||
| {{col-end}} | {{col-end}} | ||
| ===Examples=== | ===Examples=== | ||
| − | + | * See: [[Template:Col-break/examples]] | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | == | + | == See also == | 
| − | + | {{Column-generating template families}} | |
| − | + | ||
| − | + | == External links == | |
| + | * [http://www.htmlcodetutorial.com/_MULTICOL.html HTML MULTICOL Code Tutorial] | ||
| + | * [http://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Using_multi-column_layouts Using CSS multi-column layouts] | ||
| − | <noinclude> | + | {{Selfref|This [[Wikipedia:Template|template]] is a [[Wikipedia:Avoid self-references|self-reference]] and so is part of the Wikipedia project rather than the encyclopedic content.}}<noinclude> | 
| − | [[Category: | + | [[Category:Multi-column templates| ]] | 
| + | [[Category:Template documentation]] | ||
| </noinclude> | </noinclude> | ||
Latest revision as of 06:06, 5 September 2016
The Template:Tl, Template:Tl and Template:Tl templates control columns of text on a page:
- {{col-begin}}: starts a table (followed by {{col-break}} for 1st column)
- {{col-break}}: triggers the start of each column
- {{col-end}}: ends the multi-column table.
 
The widths of columns can be specified by using various additional codes. See below for examples.
| Contents | 
[edit] Usage
- {{col-begin|width=70%}}: start table with width.
- {{col-break|width=66%}}: start column-1 as 66% wide.
- This is text in col-1.
- {{col-break|width=33%}}: start column-2 as 33% wide.
- Text column-2.
- {{col-end}}
 
The table will have two columns, with column 1 twice (2×) the width of column 2.
A border of 2px (1px width on each side) corresponds to a 5%. Therefore, with a 2px border—for example, as in Wikipedia:Tutorial/Wrap-up and more info—the width needs to be 95% for the table to fit within the screen. Since it's possible that some tables might not have a border, correction on the individual page could be made after substitution. Another way to create a two column table is like this:
| 
{{col-begin|width=95%}}
|-
| 
Left column
|
Right column
|}
 | 
| Template:Tl Template:Tl Column 1 here Template:Tl Column 2 here Template:Tl | Template:Tl Template:Tl Column 1 here Template:Tl Column 2 here Template:Tl Column 3 here Template:Tl | and so on, up to Template:Tl | 
| {{Col-begin}}
Template:Tl
Column 1 here
Template:Tl
Column 2 here
Template:Tl
Column 3 here
Template:Tl
Column 4 here
Template:Tl
Column 5 here
Template:Tl
Column 6 here
Template:Tl
 | {{Columns-start|num=3}}
Column 1 here
Template:Tl
Column 2 here
Template:Tl
Column 3 here
Template:Tl
 | 
| Template:Tl Column 1 here Template:Tl Column 2 here Template:Tl Column 3 here Template:Tl Column 4 here Template:Tl | 
[edit] Examples
[edit] See also
[edit] Column-generating template families
| Family | Type | Template:Longitem | Start template | Column divider | End template | 
|---|---|---|---|---|---|
| "Col" | Table | style="text-align:center;" Template:Yes | Template:Tl or Template:Tl | Template:Tl Template:Tl .. Template:Tl | Template:Tl | 
| "Columns" | Table | style="text-align:center;" Template:No | Template:Tl | – | – | 
| "Multicol" | Table | style="text-align:center;" Template:Yes | Template:Tl | Template:Tl | Template:Tl | 
| "Col-float" | CSS float | style="text-align:center;" Template:Yes | Template:Tl | Template:Tl | Template:Tl | 
| "Columns-start" | CSS float | style="text-align:center;" Template:Yes | Template:Tl | Template:Tl | Template:Tl | 
| "Div col" | CSS columns | style="text-align:center;" Template:Yes | Template:Tl – Template:Tl (wrapper) | Template:Tl | Template:Tl | 
Template:Sup I.e., can the columns handle the wiki markup {| | || |- |} used to create tables? If not, templates that produce these elements (such as Template:Tl, Template:Tl, Template:Tl, Template:Tl, Template:Tl) and/or HTML tags (Template:Tag, Template:Tag, etc.) will need to be used instead.

