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

The wikitable Template:top is a first-of-three column templates when desiring to display two formatted columns side by side. It was adapted from a Wiktionary template set with the same names.

It must be used with {{Mid}} and {{Bottom}} to form a complete table of two columns.

The additional parameter (either) bgcolor or bgColor can be defined to change the default color of the template display, from the default "Transparent" color. Such an override must be applied to both {{Top}} and {{mid}} as well... or one gets columns of two different colors.

Note: For archival templates, such as {{Discussion top}}, see Category:Archival templates

Note

Hidden content above works only when included as is wikitable head end.

Default parameters

Note on the relationship between the two width parameters "width" and "width2": a width of 1% always occupies a center (empty) column, so
width (outer) must be set to satisfy the relation: width >= (2 * width2 + 1%)

border=0 (none) width=100% (overall width) width2=48% (see below, each column's width)
|-
|bgcolor= was once "#FFFFE0" (a [[web color|light yellow]]), now "transparent", 
          so takes on the page background color, whatever that may be.

Default parameters may be overridden by expressing the matching named parameter.
{| border={{{border|0}}}  width={{{width|100%}}}
|-
|bgcolor={{bgColor|{{{bgcolor|"#FFFFE0"}}}}}} valign=top width={{{width2|48%}}}|
... data within table
...
Parameters are:
bgColor or bgcolor affecting bgcolor
border             affecting border style, including color, width, etc.
width              affecting overall width, within which the inner column width is applied.
width2             setting the inner column width, should also apply same value to {{Mid}}.

Use Example shown below:

{{Top|bgcolor=lightblue}}
*The first list of items, usually bulleted links
*2...
*3...
{{Mid}} <!-- Mid must be placed in the wrap point of the table... 
        half or so above, half or so below. Contrast with {{Top2}} below.
*The second list of items, usually bulleted links
*2...
*3...
{{Bottom}}

Appearance of above example

• The first list of items, usually bulleted links
• 2...
• 3...

• The second list of items, usually bulleted links
• 2...
• 3...

Note that the 2nd column lacks the coloring as in column 1; color must be specified for each column, so for column 2, use: {{Mid|bgcolor=lightblue}}.

---

The following usage is transcluded from Template:Column templates (edit talk links history)

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.

TemplateData

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

Top

<templatedata> {

   "description": "Starts a two column table, must be followed by |}

| width=1% class="multicol-gutter" | |bgcolor=transparent valign=top width=48%|

|}.",

   "params": {
       "width": {
           "label": "width",
           "description": "Width of the whole table.",
           "type": "string",
           "default": "100%",
           "required": false
       },
       "width2": {
           "label": "width2",
           "description": "Width of first column.",
           "type": "string",
           "default": "48%",
           "required": false
       },
       "border": {
           "label": "border",
           "description": "Border of table, in pixels e.g. '1'.",
           "type": "number",
           "default": "0",
           "required": false
       },
       "bgcolor": {
           "label": "bgcolor",
           "description": "Background colour.",
           "type": "string",
           "default": "transparent",
           "aliases": ["bgColor"],
           "required": false
       }
   }

} </templatedata>