Template:Col-begin

Template documentation[view] [edit] [history] [purge]

The {{col-begin}}, {{col-break}} and {{col-end}} 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.

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 |}

{{Col-begin}}
{{Col-2}}
Column 1 here
{{Col-2}}
Column 2 here
{{Col-end}}

{{Col-begin}}
{{Col-3}}
Column 1 here
{{Col-3}}
Column 2 here
{{Col-3}}
Column 3 here
{{Col-end}}

{{Col-begin}}
{{Col-4}}
Column 1 here
{{Col-4}}
Column 2 here
{{Col-4}}
Column 3 here
{{Col-4}}
Column 4 here
{{Col-end}}

and so on, up to {{Col-7}}

{{Col-begin|class=references-small}}
{{Col-break}}
Column 1 here
{{Col-break}}
Column 2 here
{{Col-break}}
Column 3 here
{{Col-break}}
Column 4 here
{{Col-break}}
Column 5 here
{{Col-break}}
Column 6 here
{{Col-end}}

{{Columns-start|num=3}}
Column 1 here
{{Column}}
Column 2 here
{{Column}}
Column 3 here
{{Columns-end}}

{{Multicol}}
Column 1 here
{{Multicol-break}}
Column 2 here
{{Multicol-break}}
Column 3 here
{{Multicol-break}}
Column 4 here
{{Multicol-end}}

{{Top}}
Column 1 here
{{Mid}}
Column 2 here
{{Bottom}}

Examples

• See: Template:Col-break/examples

See also

Column-generating template families

Family	Wiki table codeFile:Dagger-14-plain.png	Starting template	Break between columns	Ending template
"Col"		{{Col-begin}} or {{Col-begin-small}}	{{Col-break}} {{Col-2}} {{Col-3}} {{Col-4}} {{Col-5}} {{Col-6}} or use {{Col-break|width=16.6%}}, i.e. with width ≈ 100% / 6. {{Col-7}} or use {{Col-break|width=14.2%}}, i.e. with width ≈ 100% / 7. {{Col-8}} or use {{Col-break|width=12.5%}}, i.e. with width = 100% / 8. For nine or even more columns, use {{Col-break|width=[W]%}}, where [W] ≈ 100 divided by the number of columns desired.	{{Col-end}} or {{End}}
"Col-float"	13pxY	{{Col-float}}	{{Col-float-break}}	{{Col-float-end}}
"Columns"	13pxY	{{Columns}}	–	–
"Columns-start"	13pxY	{{Columns-start}}	{{Column}}	{{Columns-end}}
"Div col"	13pxY	{{Div col}} or {{Columns-list}}	–	{{Div col end}}
"Multicol"		{{Multicol}}	{{Multicol-break}}	{{Multicol-end}}
"TMB"		{{Top}}	{{Mid}}	{{Bottom}}

^{File:Dagger-14-plain.png} i.e. can the columns handle the wiki markup {| | || |- |} used to create tables? If not, templates that produce these elements (such as {{(!}}, {{!}}, {{!!}}, {{!-}}, {{!)}}) and/or HTML tags (<table>...</table>, <tr>...</tr>, etc) will need to be used instead.

External links

• HTML MULTICOL Code Tutorial
• Using CSS multi-column layouts

This template is a self-reference and so is part of the Wikipedia project rather than the encyclopedic content.

Template data

See

• Template:Col-begin/TemplateData

TemplateData

This is the TemplateData documentation for this template used by VisualEditor and other tools.

Col-begin

<templatedata> { "description": "This template starts a multi-column table.", "params": { "width": { "label": "Table width", "type": "string", "description": "The width of the complete table, defined as a percent (ie 50%), typically no more than 95%" } } } </templatedata>