Template:Col-2/doc
 | This is a documentation subpage for Template:Col-2. It may contain usage information, categories and other content that is not part of the original template page. |
 | This template is used on approximately 183,000 pages. To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them. |
The Template:Col-2 sets column width for each of two columns, with align=left, valign=top. The align or valign can be changed: {{col-2 |align=right|valign=center}}. 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
[edit]{{col-begin|width=70%}}: start table with specific width.
{{col-break|width=66%}}: start column-1 as 66% wide.
This is text in column-1.
{{col-break|width=33%}}: start column-2 as 33% wide.
This is text in 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, 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}} |
and so on, up to {{Col-5}} |
{{Col-begin}} {{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}}
|
Examples
[edit]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!
{{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:
|
|
{{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:
|
|
{{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}}
gives:
|
|
{{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}}
|
|
{{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-break}}
{| class="wikitable" style="width:18em"
|+ Revenue by product
|-
! Widgets
| $25,000
|-
! Foos
| $65,500
|-
! Bars
| $28,000
|}
{{col-end}}
gives:
|
|
|
See also
[edit]Column-generating template families
[edit]The templates listed here are not interchangeable. For example, using {{col-float}} with {{col-end}} instead of {{col-float-end}} would leave a <div>...</div> open, potentially harming any subsequent formatting.
- "Responsive/mobile suited" refers to whether more than one column will show up in cell phones. See tests here. Some templates need to be updated to work in cell phones too. Please use mobile-suited templates, or straight divs. For why, see WP:Access. See discussion.
| Type | Family | Deprecated. Replace over time |
Handles wiki table code?[b] |
Responsive/ mobile suited |
Dependent on media queries |
Can form multiple columns |
Visual Editor– suited |
Start template |
Column divider |
End template | |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Float | "col-float" | Yes | Yes | Yes | Yes | {{col-float}} | {{col-float-break}} | {{col-float-end}} | |||
| "columns-start" | Yes | Yes | Yes | Yes | {{columns-start}} | {{column}} | {{columns-end}} | ||||
| Float | "stack" | Yes | Yes | No | {{stack}} or {{stack begin}} |
{{stack end}} | |||||
| Columns | "div col" | Yes | Yes | Yes | {{div col}} | instead use {{no col break}} | {{div col end}} | ||||
| "columns list" | Yes | No | Yes | {{columns list}} (wraps div col) | — | — | |||||
| Flexbox | "flex columns" | Yes | No | Yes | {{flex columns}} | — | — | ||||
| Flexbox | "flexbox wrap" | {{flexbox wrap}} | |||||||||
| Table | "col" | Yes | Yes | Yes | No | Yes | {{col-begin}}, {{col-begin-fixed}} or {{col-begin-small}} |
{{col-break}} or {{col-2}} .. {{col-5}} |
{{col-end}} |
TemplateData
[edit]TemplateData for Col-2
Starts a column in a two-column table begun by {{col-begin}}.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| align | align | Horizontal alignment of content.
| String | optional |
| valign | valign | Vertical alignment of content.
| String | optional |