Template:Div col/doc: Difference between revisions

From Linguifex
Jump to navigation Jump to search
(Created page with "<!----------------------------------------------------------------------------- PLEASE ADD CATEGORIES WHERE INDICATED AT THE BOTTOM OF THIS PAGE ---------------------------...")
 
No edit summary
 
Line 139: Line 139:
* h
* h
{{Div col end}}
{{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>
}}

Latest revision as of 19:41, 4 August 2015

Template:CSS3 multiple column layout

{{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:

Usage

|colwidth= Template:Nobold
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