View source for Template:Div col/doc

<!-----------------------------------------------------------------------------
  PLEASE ADD CATEGORIES WHERE INDICATED AT THE BOTTOM OF THIS PAGE
 ------------------------------------------------------------------------------>
{{Documentation subpage}}
{{Ombox |type=notice |text=Columns are not supported by some older browsers, most notably Internet Explorer 9 and below and Opera 11.0 and below. See [[Template:Reflist#Browser support for columns|this page]] for more information.}}
{{CSS3 multiple column layout}}

{{tl|Div col}}, together with {{tl|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 ({{para|small|yes}}), place vertical lines ("rules") between the columns ({{para|rules}}) and to add other custom styling ({{para|style}}).

{{tl|Div col}} can create multiple columns in [[web browser]]s which support one of the following [[CSS]] properties:
* ''column-count'' (for [[Cascading Style Sheets#CSS 3|CSS3]]-compliant browsers; see [http://www.w3.org/TR/css3-multicol/ CSS3 module: Multi-column layout])
* ''-moz-column-count'' (for [[Mozilla application framework|Mozilla]]/[[Gecko (layout engine)|Gecko]]-based browsers such as [[Firefox]])
* ''-webkit-column-count'' (for [[WebKit]]-based browsers such as [[Safari (web browser)|Safari]] and [[Google Chrome]])

==Usage==
; {{s|{{para|cols}}}} {{nobold|or first unnamed parameter}} : ''(Now [[Deprecation|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))''<br/>Specifies the number of columns (default 2).
; {{para|colwidth}} {{nobold|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''. Specified in any CSS unit, for instance in [[Em (typography)|em]], about the width of a capital "M", e.g, <code>colwidth=20em</code>
; {{para|rules}} : Adds vertical lines ("rules") between the columns if set to <code>yes</code> or some CSS styling (e.g. <code>1px dashed blue;</code>).
; {{para|gap}} : Specifies the space between the content of adjacent columns. Specified in any CSS unit, e.g, <code>gap=2em</code>. The default spacing is 1em.
; {{para|style}} : CSS styling to apply to the columns.

==Examples==
<pre>
{{Div col}}
* a
* b
* c
* d
* e
* f
* g
* h
{{Div col end}}
</pre>
; produces:
{{Div col}}
* a
* b
* c
* d
* e
* f
* g
* h
{{Div col end}}

<pre>
{{Div col|3}}
* a
* b
* c
* d
* e
* f
* g
* h
{{Div col end}}
</pre>
; produces:
{{Div col|3}}
* a
* b
* c
* d
* e
* f
* g
* h
{{Div col end}}

<pre>
{{Div col||10em}}
* a
* b
* c
* d
* e
* f
* g
* h
{{Div col end}}
</pre>
; produces:
{{Div col||10em}}
* a
* b
* c
* d
* e
* f
* g
* h
{{Div col end}}

<pre>
{{Div col|rules=yes}}
* a
* b
* c
* d
* e
* f
* g
* h
{{Div col end}}
</pre>
; produces:
{{Div col|rules=yes}}
* a
* b
* c
* d
* e
* f
* g
* h
{{Div col end}}

<pre>
{{Div col|small=yes}}
* a
* b
* c
* d
* e
* f
* g
* h
{{Div col end}}
</pre>
; produces:
{{Div col|small=yes}}
* a
* b
* c
* d
* e
* f
* g
* h
{{Div col end}}

==TemplateData==
{{TemplateDataHeader}}
{{#switch: {{BASEPAGENAME}}
|Div col=<templatedata>
{
    "description": "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}}.",
    "params": {
        "cols": {
            "label": "cols",
            "description": "Specifies the number of columns.",
            "type": "string",
            "default": "2",
            "aliases": ["1"],
            "required": false
        },
        "colwidth": {
            "label": "colwidth",
            "description": "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.",
            "type": "string",
            "aliases": ["2"],
            "required": false
        },
        "rules": {
            "label": "rules",
            "description": "Produces vertical rules between the columns if set to yes.",
            "type": "string",
            "required": false
        },
        "gap": {
            "label": "gap",
            "description": "Specifies the space between the content of adjacent columns.",
            "type": "string",
            "required": false
        },
        "style": {
            "label": "style",
            "description": "Specifies any custom styling.",
            "type": "string",
            "required": false
        }
    }
}
</templatedata>
|Div col end=<templatedata>
{
    "description": "Ends a multi-column list started by {{div col}}. It takes no parameters.",
    "params": {
    }
}
</templatedata>
}}

==Redirects==
* {{Tlx|Div col start}}
* {{Tlx|Colbegin}}  (but '''not''' {{Tlx|Col begin}})
* {{Tlx|Cols}}

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

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox |
| <!-- CATEGORIES BELOW THIS LINE, PLEASE: -->
[[Category:Table and column templates]]

<!--?:-->{{#switch:{{PAGENAME}} |Div col= |Div col end=}}
[[es:Plantilla:Div col]]
}}</includeonly>