Template:Col-break/doc

{{#ifeq:doc |doc

    | 

{{#ifeq:show |show

         | {{#invoke:Message box|mbox}}
        }}{{#if: |
         |   {{#ifexist:Template:Col-break
                  | [[Category:{{#switch:Template |Template=Template |Module=Module |User=User |#default=Wikipedia}} documentation pages]]
                  |
                 }}
        }}
    | 
   }}

{{#invoke:Message box|ombox}}

{{#switch:col-break | 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: {{col-2 |width=40%|align=right|valign=center}}. | 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: {{col-3 |width=25%|align=right|valign=center}}. | col-4 = The Template:Col-4 sets column width for each of four columns. | col-5 = The Template:Col-5 sets column width for each of five columns. | 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: {{col-6 |width=20%|align=right|valign=center}}. | col-start=The Template:Col-start begins a wikitable (same as {{col-begin}}). }}{{#invoke:Infobox|infobox}}

The {{[[{{#if:|{{{SISTER}}}Template|Template}}:col-begin|col-begin]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}, {{[[{{#if:|{{{SISTER}}}Template|Template}}:col-break|col-break]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}} and {{[[{{#if:|{{{SISTER}}}Template|Template}}:col-end|col-end]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}} 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 |}

style="{{#if:|width: {{{width}}}; }}text-align: left; vertical-align: top; {{#if: |padding-left: {{{gap}}};}} " |

{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-begin|Col-begin]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}
{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-2|Col-2]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}
Column 1 here
{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-2|Col-2]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}
Column 2 here
{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-end|Col-end]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}

style="{{#if:|width: {{{width}}}; }}text-align: left; vertical-align: top; {{#if: 2em|padding-left: 2em;}} " |

{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-begin|Col-begin]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}
{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-3|Col-3]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}
Column 1 here
{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-3|Col-3]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}
Column 2 here
{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-3|Col-3]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}
Column 3 here
{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-end|Col-end]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}

style="{{#if:|width: {{{width}}}; }}text-align: left; vertical-align: top; {{#if: 2em|padding-left: 2em;}} " | and so on, up to {{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-5|Col-5]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}

style="{{#if:|width: {{{width}}}; }}text-align: left; vertical-align: top; {{#if: |padding-left: {{{gap}}};}} " |

{{Col-begin}}
{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-break|Col-break]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}
Column 1 here
{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-break|Col-break]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}
Column 2 here
{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-break|Col-break]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}
Column 3 here
{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-break|Col-break]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}
Column 4 here
{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-break|Col-break]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}
Column 5 here
{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-break|Col-break]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}
Column 6 here
{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-end|Col-end]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}

style="{{#if:|width: {{{width}}}; }}text-align: left; vertical-align: top; {{#if: 2em|padding-left: 2em;}} " |

{{Columns-start|num=3}}
Column 1 here
{{[[{{#if:|{{{SISTER}}}Template|Template}}:Column|Column]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}
Column 2 here
{{[[{{#if:|{{{SISTER}}}Template|Template}}:Column|Column]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}
Column 3 here
{{[[{{#if:|{{{SISTER}}}Template|Template}}:Columns-end|Columns-end]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}

Examples

Here are some example codes that you can use to make columns of text in your wikipedia article. You can change the width of your columns by changing the code words that go between the text of your columns. Good luck!

{{#ifeq:left|left

|

  Example 1, using col-break

|

Example 1, using col-break 

}}

{{col-begin}}
{{col-break}}
{| class="wikitable" style="width:18em"
|+ Production by year
|-
! 1980
| 50,000
|-
! 1990
| 75,000
|-
! 2000
| 90,000
|}
{{col-break}}
{| class="wikitable" style="width:18em"
|+ Profit by year
|-
! 1980
| $6,000
|-
! 1990
| $7,500
|-
! 2000
| $8,200
|}
{{col-end}}

gives:

style="{{#if:|width: {{{width}}}; }}text-align: left; vertical-align: top; {{#if: |padding-left: {{{gap}}};}} " |

Production by year

1980	50,000
1990	75,000
2000	90,000

style="{{#if:|width: {{{width}}}; }}text-align: left; vertical-align: top; {{#if: |padding-left: {{{gap}}};}} " |

Profit by year

1980	$6,000
1990	$7,500
2000	$8,200

{{#ifeq:left|left

|

  Example 2, using col-2

|

Example 2, using col-2 

}}

{{col-begin}}
{{col-2}}
{| class="wikitable" style="width:18em"
|+ Production by year
|-
! 1980
| 50,000
|-
! 1990
| 75,000
|-
! 2000
| 90,000
|}
{{col-2}}
{| class="wikitable" style="width:18em"
|+ Profit by year
|-
! 1980
| $6,000
|-
! 1990
| $7,500
|-
! 2000
| $8,200
|}
{{col-end}}

gives:

Production by year

1980	50,000
1990	75,000
2000	90,000

Profit by year

1980	$6,000
1990	$7,500
2000	$8,200

{{#ifeq:left|left

|

  Example 3, use col-break with specified widths

|

Example 3, use col-break with specified widths 

}}

{{col-begin}}
{{col-break|width=80%}}
{| class="wikitable" style="width:18em"
|+ Production by year
|-
! 1980
| 50,000
|-
! 1990
| 75,000
|-
! 2000
| 90,000
|}
{{col-break|width=20%}}
{| class="wikitable" style="width:18em"
|+ Profit by year
|-
! 1980
| $6,000
|-
! 1990
| $7,500
|-
! 2000
| $8,200
|}
{{col-end}}

{{#ifeq:left|left

|

  Example 4, use col-break with auto outer width

|

Example 4, use col-break with auto outer width 

}}

{{col-begin|width=auto}}
{{col-break}}
{| class="wikitable" style="width:18em"
|+ Production by year
|-
! 1980
| 50,000
|-
! 1990
| 75,000
|-
! 2000
| 90,000
|}
{{col-break|gap=2em}}
{| class="wikitable" style="width:18em"
|+ Profit by year
|-
! 1980
| $6,000
|-
! 1990
| $7,500
|-
! 2000
| $8,200
|}
{{col-end}}

style="{{#if:|width: {{{width}}}; }}text-align: left; vertical-align: top; {{#if: |padding-left: {{{gap}}};}} " |

Production by year

1980	50,000
1990	75,000
2000	90,000

style="{{#if:|width: {{{width}}}; }}text-align: left; vertical-align: top; {{#if: 2em|padding-left: 2em;}} " |

Profit by year

1980	$6,000
1990	$7,500
2000	$8,200

{{#ifeq:left|left

|

  Example 5, Lots of columns, using col-break

|

Example 5, Lots of columns, using col-break 

}}

style="{{#if:|width: {{{width}}}; }}text-align: left; vertical-align: top; {{#if: |padding-left: {{{gap}}};}} " |

Production by year

1980	50,000
1990	75,000
2000	90,000

style="{{#if:|width: {{{width}}}; }}text-align: left; vertical-align: top; {{#if: |padding-left: {{{gap}}};}} " |

Profit by year

1980	$6,000
1990	$7,500
2000	$8,200

style="{{#if:|width: {{{width}}}; }}text-align: left; vertical-align: top; {{#if: |padding-left: {{{gap}}};}} " |

Revenue by product

Widgets	$25,000
Foos	$65,500
Bars	$28,000

See also

Column-generating template families

{{#invoke:Message box|mbox}} <section begin="table" />

Family	Type	Handles wiki  table code?main}} {{#if:|}}	Start template	Column divider	End template
"Col"	Table	style="text-align:center;"	{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-begin|Col-begin]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}} or {{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-begin-small|Col-begin-small]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}	{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-break|Col-break]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}} {{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-2|Col-2]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}} .. {{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-5|Col-5]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}	{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-end|Col-end]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}
"Columns"	Table	No	{{[[{{#if:|{{{SISTER}}}Template|Template}}:Columns|Columns]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}	–	–
"Col-float"	CSS float	style="text-align:center;"	{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-float|Col-float]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}	{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-float-break|Col-float-break]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}	{{[[{{#if:|{{{SISTER}}}Template|Template}}:Col-float-end|Col-float-end]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}
"Columns-start"	CSS float	style="text-align:center;"	{{[[{{#if:|{{{SISTER}}}Template|Template}}:Columns-start|Columns-start]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}	{{[[{{#if:|{{{SISTER}}}Template|Template}}:Column|Column]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}	{{[[{{#if:|{{{SISTER}}}Template|Template}}:Columns-end|Columns-end]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}
"Div col"	CSS columns	style="text-align:center;"	{{[[{{#if:|{{{SISTER}}}Template|Template}}:Div col|Div col]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}} – {{[[{{#if:|{{{SISTER}}}Template|Template}}:Columns-list|Columns-list]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}} (wrapper)	–	{{[[{{#if:|{{{SISTER}}}Template|Template}}:Div col end|Div col end]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}

^main}} I.e., can the columns handle the wiki markup {| | || |- |} used to create tables? If not, templates that produce these elements (such as {{[[{{#if:|{{{SISTER}}}Template|Template}}:(!|(!]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}, {{[[{{#if:|{{{SISTER}}}Template|Template}}:!|!]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}, {{[[{{#if:|{{{SISTER}}}Template|Template}}:!!|!!]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}, {{[[{{#if:|{{{SISTER}}}Template|Template}}:!-|!-]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}, {{[[{{#if:|{{{SISTER}}}Template|Template}}:!)|!)]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}}) and/or HTML tags ({{#switch:pair

 |c|close =
 |e|empty|s|single|v|void
 |o|open
 |p|pair = <table{{#if:| {{{params}}}}}
}}{{#switch:pair
 |c|close = 
 |e|empty|s|single|v|void =  />
 |o|open = >
 |p|pair = {{#ifeq:table|!--||>}}...
}}{{#switch:pair
 |e|empty|s|single|v|void
 |o|open =
 |c|close
 |p|pair = {{#ifeq:table|!--|-->|</table>}}
}}, {{#switch:pair
 |c|close =
 |e|empty|s|single|v|void
 |o|open
 |p|pair = <tr{{#if:| {{{params}}}}}
}}{{#switch:pair
 |c|close = 
 |e|empty|s|single|v|void =  />
 |o|open = >
 |p|pair = {{#ifeq:tr|!--||>}}...
}}{{#switch:pair
 |e|empty|s|single|v|void
 |o|open =
 |c|close
 |p|pair = {{#ifeq:tr|!--|-->|</tr>}}
}}, etc.) will need to be used instead.<section end="table" />

External links

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

{{#switch:NONE |NONE|hatnote|hat={{#invoke:Hatnote|hatnote}} |inline=This template is a self-reference and so is part of the Wikipedia project rather than the encyclopedic content. |= |#default=Template:Error }}

Template data

{{#if:| |This is the {{#if:|TemplateData|TemplateData}} documentation for this template used by VisualEditor and other tools.}}

See the monthly error report for this template.

TemplateData for Col-break

{{#ifeq:doc|sandbox||

}} <templatedata> { "description": "This template triggers the start of each column in a multi-column table.", "params": { "width": { "label": "Column width", "type": "string", "description": "Width of the column, defined as a percent (ie 50%)" } } }</templatedata>