Template:Top

From Wikipedia, the free encyclopedia
Jump to: navigation, search
Documentation icon 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

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

Examples

See also

Column-generating template families

Family
Handles wiki
 table code?dagger
Start template Break between columns End template
"Col" {{Col-begin}}
or {{Col-begin-small}}
{{Col-break}}
{{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" Green tickY {{Col-float}} {{Col-float-break}} {{Col-float-end}}
"Columns" Green tickY {{Columns}}
"Columns-start" Green tickY {{Columns-start}} {{Column}} {{Columns-end}}
"Div col" Green tickY {{Div col}}
or {{Columns-list}}
{{Div col end}}
"Multicol" {{Multicol}} {{Multicol-break}} {{Multicol-end}}
"TMB" {{Top}} {{Mid}} {{Bottom}}

dagger 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

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

Starts a two column table, must be followed by {{mid}} and {{bottom}}.

Template parameters
Parameter Description Type Default Status
width width Width of the whole table. string 100% optional
width2 width2 Width of first column. string 48% optional
border border Border of table, in pixels e.g. '1'. number 0 optional
bgcolor bgcolorbgColor Background colour. string transparent optional