View source for Template:Balanced columns list/doc

{{Documentation subpage}}
{{TOCright}}
==Function==
===Purpose===
Presents a list of items in columns so that the number of items in each column is the same or only differs by 1.

===Limitations===
====Number of items====
The maximum number of items is 50.

====Column balancing====
Column balancing does not allow for inconsistent text wrap of items, and text wrap can disturb column depth balancing.  

If there is an equivalent number of text wrap new lines in each column then the columns will remain balanced.

====Missing items====
Items missing from within the list of items are treated as items and a blank position will be displayed in the column where the missing item would otherwise appear.

==Usage==
===Skeleton===
<pre>
{{balanced columns list
|title    = 
|heading  = 
|columns  = 
|collapse = 
|item1
(...up to 50...)
}}
</pre>
===Parameters===
Named parameters:
*title, optional, title for the table of items, any content
*heading, optional, heading for each column of items in the table, any content
*column, optional, number of columns over which items are to be balanced, defaults to 3, any greater than 0
*collapse, optional, as per wiki class collapse.

Unnamed parameters:
*1, optional, an item in a list, up to 50, any content

==Example==
<pre style="font-size:95%">
{{balanced columns list
|title   = Title of 6 Balanced Columns List of Numbers
|heading = Column Heading
|columns = 6
|One
|Two
|Three
|Four
|Five
|Six
|Seven
|Eight
|Nine
|10
|11
|12
|13
|14
|15
|16
|17
|18
|19
|20
|21
|22
|23
|24
|25
|26
|27
|28
|29
|30
|alpha31
|alpha32
|alpha33
|alpha34
|alpha35
|alpha36
|alpha37
|alpha38
|alpha39
|beta40
|beta41
|beta42
|beta43
|beta44
|beta45
|beta46
|beta47
|beta48
|beta49
|50
}}
</pre>
{{balanced columns list
|title   = Title of 6 Balanced Columns List of Numbers
|heading = Column Heading
|columns = 6
|One
|Two
|Three
|Four
|Five
|Six
|Seven
|Eight
|Nine
|10
|11
|12
|13
|14
|15
|16
|17
|18
|19
|20
|21
|22
|23
|24
|25
|26
|27
|28
|29
|30
|alpha31
|alpha32
|alpha33
|alpha34
|alpha35
|alpha36
|alpha37
|alpha38
|alpha39
|beta40
|beta41
|beta42
|beta43
|beta44
|beta45
|beta46
|beta47
|beta48
|beta49
|50
}}
<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Table and column templates|{{PAGENAME}}]]
</includeonly>