Template:Div col/doc

Not to be confused with {{Col-begin}}, {{Cols}}, or {{Div-col}}.

This subpage contains documentation, categories, or other content that is not part of the template.
To view the template page itself, see Template:Div col.

---

Columns are not supported by some older browsers, most notably Internet Explorer 9 and below and Opera 11.0 and below. See this page for more information.

{{Div col}}, together with {{Div col end}}, is used to make a list into columns. It automatically breaks each column into an equal space, meaning, for instance, it isn't necessary to work out the halfway point between two columns. The template also offers options to set a smaller (90%) font-size (|small=yes), place vertical lines ("rules") between the columns (|rules=) and to add other custom styling (|style=).

{{Div col}} can create multiple columns in web browsers which support one of the following CSS properties:

• column-count (set the number of columns)
• column-width (set the width of column, the number of columns, the number of columns could be varied between different screen width)
• column-rules (insert a vertical line between two columns)
• column-gap (insert a narrow space between two columns)

For more technical details, see: CSS3 module: Multi-column layout

Usage

|cols= or first unnamed parameter

(Now deprecated, as colwidth below is better suited to flexible formatting for a variety of display screen sizes (from mobile phones, tablets, etc to widescreen cinema-style displays)).

|colwidth= or second unnamed parameter

Specifies the minimum width of the columns and determines automatically the number of columns based on screen width (i.e. more columns will be shown on wider displays). Overrides cols.

|rules=

Adds vertical lines ("rules") between the columns if set to yes or some CSS styling (e.g. 1px dashed blue;).

|gap=

Specifies the space between the content of adjacent columns. The default spacing is 1em.

|style=

CSS styling to apply to the columns.

Examples

{{Div col}}
* a
* b
* c
* d
* e
* f
* g
* h
{{Div col end}}

produces

• a
• b
• c
• d
• e
• f
• g
• h

{{Div col|3}}
* a
* b
* c
* d
* e
* f
* g
* h
{{Div col end}}

produces

• a
• b
• c
• d
• e
• f
• g
• h

{{Div col||10em}}
* a
* b
* c
* d
* e
* f
* g
* h
{{Div col end}}

produces

• a
• b
• c
• d
• e
• f
• g
• h

{{Div col|rules=yes}}
* a
* b
* c
* d
* e
* f
* g
* h
{{Div col end}}

produces

• a
• b
• c
• d
• e
• f
• g
• h

{{Div col|small=yes}}
* a
* b
* c
* d
* e
* f
* g
* h
{{Div col end}}

produces

• a
• b
• c
• d
• e
• f
• g
• h

TemplateData

 Parameter text is empty

<templatedata>JSON</templatedata> ./. {{TemplateBox}}

TemplateData

TemplateData is a way to store information about template parameters (the description of those and of the whole template) for both humans and machines. It is used by VisualEditor and possibly other tools like Upload Wizard.

---

Existing template documentation
At Wikimedia Commons, it is recommended to use {{TemplateBox}} with either ‎useTemplateData=1 or ‎useTemplateData=only on the ‎/doc subpage and transcluding it with {{Documentation}} into the template. ‎<nowiki>-tags can be wrapped around the arguments, if required, to avoid templates being expanded.

Newly created template documentation and imports
Another option, especially for imported templates, or for users with JSON experience, is placing raw ‎<templatedata>-tags into the Wikitext of the template, as described in various Wikipediae.

---

Wikipedia's help about TemplateData • Commons-specific information

Breaks a list into columns. It automatically breaks each column to an equal space, so you do not manually have to find the half way point on two columns. The list is closed with {{div col end}}.

Template parameters

Parameter		Description	Type	Status
cols	cols 1	Specifies the number of columns.	String	optional
colwidth	colwidth 2	Specifies the width of columns, and determines dynamically the number of columns based on screen width; more columns will be shown on wider displays. This overrides the 'cols' setting. Default 30em	String	optional
rules	rules	Produces vertical rules between the columns if set to yes.	String	optional
gap	gap	Specifies the space between the content of adjacent columns.	String	optional
style	style	Specifies any custom styling.	String	optional

Redirects

• {{Div col start}}

See also

• {{Col-begin}}
• {{Cols}}
• {{Div-col}}