This is a documentation subpage for Template:Div col.
Note: Columns are currently supported only by newer versions of Gecko-based browsers (such as Mozilla Firefox) and WebKit-based browsers (such as Google Chrome and Safari). All versions of Internet Explorer through to version 9 and Opera through to version 11.0 do not support columns. See here for more information.
This template is a shortcut for producing columns using CSS (more info). It generates the CSS for various browsers. Supported browsers are the current versions of Firefox, Safari and Chrome.
Usage
This template can be used to :
- make a list into columns, with the option of specifying a smaller font.
- represent prose content, which is columnular in nature.
Provided that:
- the break points of the columns do not need to be set exactly, since it will be chosen automatically by the browser.
- the list or content is consistently formatted.
Parameters
- width: Width of the overall element.
- 1, cols: Specifies the number of columns. Defaults to 2.
- colwidth: Default: no minimum. Set this to automatically reduce column count on small screens.
- small: Specifies small font size (80%). Defaults to "no".
- rule: inter-column rule –
1px solid black; - gap: inter-column gap –
column-gap
Examples
Lists
Without using any parameters. The default number of columns is 2.
{{Div col}}
* a
* b
* c
* d
* e
* f
* g
* h
{{Div col end}}
- a
- b
- c
- d
- e
- f
- g
- h
With minimum width
On very small screens (e.g. mobile), it's likely that the columns will be very narrow. Specify the width parameter to cause the browser to reduce the column count automatically when the column width fall below this value.
The correct value for this parameter depends on the list content, and what size the column can be before it wraps text in an undesired way.
Lists
In a wide (70em) container:
{{Div col|width=70em}}
* {{Lorem ipsum}}
* {{Lorem ipsum}}
{{Div col end}}
- Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
- Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
In a narrow page (40em):
{{Div col|width=40em}}
* {{Lorem ipsum}}
* {{Lorem ipsum}}
{{Div col end}}
- Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
- Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Prose
{{Div col|cols=5}}
{{lorem ispsum}}
{{Div col end}}
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Small
{{Div col|small=yes}}
{{lorem ispsum}}
{{Div col end}}
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
See also
- {{column-count}}
- {{column-width}}
- {{column-gap}}
- {{column-rule}}