View source for Template:Columns-start/doc

{{Documentation subpage}}
<!-- Add categories where indicated at the bottom of this page and interwikis at Wikidata -->
{{Uses TemplateStyles|Template:Column/styles.css}}
The '''columns-start''' template and its child templates '''column''' and '''columns-end''' can be used to make a fixed number of columns (up to 5) that will span the entire page above a certain minimum width (100 [[Em (typography)#CSS|ems]] for 5 columns, 80 for 4, 60 for 3 and 2). Below the minimum width, each column starting from the right will gracefully display below another one of the columns.

== Use ==
The below examples are using the templates directly, so you can see what will happen if the minimum size is reached.
{{clear}}
{{columns-start|num=4}}
<pre>
{{Columns-start}}
Column 1 here
{{Column}}
Column 2 here
{{Columns-end}}
</pre>
{{column}}
<pre>
{{Columns-start|num=3}}
Column 1 here
{{Column}}
Column 2 here
{{Column}}
Column 3 here
{{Columns-end}}
</pre>
{{column}}
<pre>
{{Columns-start|num=4}}
Column 1 here
{{Column}}
Column 2 here
{{Column}}
Column 3 here
{{Column}}
Column 4 here
{{Columns-end}}
</pre>
{{column}}
<pre>
{{Columns-start|num=5}}
Column 1 here
{{Column}}
Column 2 here
{{Column}}
Column 3 here
{{Column}}
Column 4 here
{{Column}}
Column 5 here
{{Columns-end}}
</pre>
{{columns-end}}

=== Parameters ===
Columns-start has these parameters:
; {{para|num}}
: Set the number of columns. Defaults to 2. The template will work with up to 5 columns. More than that should prefer a custom implementation or another solution (such as a wikitable for tabular content or {{tl|div col}} for list content).
; {{para|class}}
: Apply another class to the set of columns, such as <code>hlist</code>. Default is none.
; {{para|bgcolor}}
: Set a background color. Default is transparent.
; {{para|width}}
: Set a total width in which all columns must appear. Default is 100%.

Template:Column has the same parameters where it is used as a "wrapper" template with numbered columns. Example:

{{columns-start|num=2}}
<pre>
{{Column|num=2
|1=
Column 1 here
|2=
Column 2 here
}}
</pre>
{{column}}
<pre>
{{Column|num=3
|
Column 1 here
|
Column 2 here
|
Column 3 here
}}
</pre>
{{columns-end}}

In the second example, be aware of the possible problem with a column that includes an equals sign. See [[Help:Templates#Equals]] for more information.

Otherwise, Template:Column must be used as above with Template:Columns-start.

=== Example ===
This is an example from [[List of Indonesia-related topics]]:
{{columns-start|num=4}}
'''Palaces in Indonesia'''
* [[Istana Bogor]]
* [[Istana Luwu]]
* [[Istana Maimun]]
* [[Istana Merdeka]]
* [[Istana Negara, Jakarta]]
* [[Istana Wakil Presiden]]
{{column}}
'''Prisons'''
* [[Kambangan Island]]
{{column}}
'''Shopping malls'''
* [[List of Indonesia-related topics#Shopping malls in Jakarta|Shopping malls in Jakarta]]
* [[List of Indonesia-related topics#Shopping malls in Bandung|Shopping malls in Bandung]]
* [[List of Indonesia-related topics#Shopping malls in Surabaya|Shopping malls in Surabaya]]
* [[List of Indonesia-related topics#Shopping malls in Batam|Shopping malls in Batam]]
{{column}}
'''Towers'''
* [[Monumen Nasional]]
* [[Wisma 46]]
{{columns-end}}

=== Limitations ===
{{tracked|T75182}}
{{tracked|T23485}}
Using headings inside {{tl|column}} in its wrapper form functions so long as there is some content beneath the 2nd and later heading. Secondly, headings will not carry an edit link. The below table may wrap (i.e. not display as columns) but displays the issue.

{| class="wikitable"
|-
! Content
! Functional but missing edit links
! Non-functional (missing content)
|-
| Wikitext
| <pre>
{{column
|1=
==== Ex. heading 1 ====
ABC
|2=
==== Ex. heading 2 ====
DEF
}}
</pre>
| <pre>
{{column
|1=
==== Ex. heading 3 ====
|2=
==== Ex. heading 4 ====
}}
</pre>
|-
| Rendered
| {{column
|1=
==== Ex. heading 1 ====
ABC
|2=
==== Ex. heading 2 ====
DEF
}}
| {{column
|1=
==== Ex. heading 3 ====
|2=
==== Ex. heading 4 ====
}}
|}

== See also ==
{{Column-generating template families}}

<includeonly>{{Sandbox other||
<!-- Categories below this line; interwikis at Wikidata -->
[[Category:Multi-column templates]]
}}</includeonly>