Template:Collapse top/en
<languages/>
Extended content |
---|
The following content has been placed in a collapsed box for improved usability.
|
Template documentation
The {{Collapse top}} template, and its paired template {{Collapse bottom}}, are used for placing a collapse box around a talk page discussion.
Usage
Place {{Collapse top}} and {{Collapse bottom}} around the text to be collapsed. For example:
{{Collapse top|title=This is the title text}}
Sample contents text
{{Collapse bottom}}
produces:
This is the title text |
---|
Sample contents text |
{{Collapse bottom}} should always be placed on its own line.
Parameters
This template takes the following parameters, all of which are optional.
They are case-sensitive.
Those that take CSS measurements require them in CSS format (e.g. 1em
not 1 em
).
|1=
(or first unnamed parameter),|title=
,|reason=
,|header=
,|heading=
- Will give the collapsed box a title, which occurs on the same line as the show link and is always visible. It defaults to "Extended content".
- For example,
{{Collapse top|title=This is the title text}}
or{{Collapse top|This is the title text}}
. Note: The shorter, unnamed markup will not work if the title value contain an equals (=
) character. |warning=yes
- Will display a default warning line under the main title which reads "The following is a closed debate. Template:Strong"
- Any non-empty value supplied to this parameter will have this effect (i.e.
|warning=
will not work as expected). |2=
(or second unnamed parameter)- This is optional warning-line text. It will override the standard warning line above; it is not necessary to also use
|warning=yes
in this case, though doing so is harmless. |left=yes
- Will align the title along the left margin (in RTL languages, along the right margin instead).
- By default, text is centered, specifically between the left edge of the green box and the left edge of the "show" link.
- Any non-empty value supplied to this parameter will have this effect (i.e.
|left=
will not work as expected). |expand=yes
- Will leave the material uncollapsed with the border and coloring. Default is to collapse the material.
- Any non-empty value supplied to this parameter will have this effect (i.e.
|expand=
will not work as expected). |bg=
- Sets the background color of the title of the collapsible bar. Defaults to "#F8FCFF", a whitish color. Named colors are listed at List of colors.
- For example,
{{Collapse top|This is the title text|bg=#008000}}
or{{Collapse top|This is the title text|bg=green}}
(numeric HTML color codes require the leading#
). |fc=
- Sets the font color of the title of the collapsible bar. Defaults to "black".
- See
|bg=
, above, for details on color options. |border=
- Sets the width of the border line on the collapsed material. Defaults to
1px
. - For example,
{{Collapse top|border=2px}}
; going much thicker than this is not very useful. |b-color=
- Sets the border color. Defaults to
silver
(#C0C0C0
). - See
|bg=
, above, for details on color options. |padding=
- Sets the padding (distance from borders) on the collapsed material inside the colored area. Defaults to
8px
. |width=
- Sets the width of the overall template relative to the page (or a block element containing the collapse box). This should virtually always be given as a percentage, e.g.
|width=50%
, or in relativeem
units, e.g.|width=30em
. Pixel-based values should be avoided, as they are effectively meaningless – the result will be different depending on each user's browser and local CSS settings (which browser and operating system it is, zoom level, font sizes, etc.). |border2=
- Sets the properties of the border of the box that appears when template is expanded. Defaults to
1px silver
(there is no provision to change from a solid line). - For example,
{{Collapse top|border2=2px}}
(only width or color will be changed if only one value is supplied). - See
|bg=
, above, for details on color options. |bg2=
- Sets the background color of the box that appears when template is expanded; defaults to
white
(#FFF
). - See
|bg=
, above, for details on color options. |indent=
- Indents the box from the left of the page. Defaults to no indentation. Each
:
in talk page markup is approximately equivalent to1.6em
of indent (e.g., to match::::
indentation level, use|indent=6.4em
). You can also use a percentage value. - Pixel-based values should be avoided (see
|width=
, above, for the reason).
Examples
- Adding a box title (if omitted, default is "Extended content") –
{{Collapse top|This is the title text}}
This is the title text |
---|
- Adding a standard warning line –
{{Collapse top|This is the title text|warning=true}}
This is the title text |
---|
<translate> The following is a closed debate.</translate> Template:Strong |
- Adding a custom warning line –
{{Collapse top|This is the title text|This is a custom warning line}}
This is the title text |
---|
This is a custom warning line |
- Aligning box title along left margin –
{{Collapse top|left=true}}
<translate> Extended content</translate> |
---|
- Changing background color –
{{Collapse top|bg=#F0F2F5}}
<translate> Extended content</translate> |
---|
- Adding extra padding –
{{Collapse top|padding=5em}}
<translate> Extended content</translate> |
---|
- Archiving a section – The markup below:
{{Collapse top}}
== Section header ==
Sample contents text
{{Collapse bottom}}
must be rewritten as:
{{Collapse top|Section header}}
Sample contents text
{{Collapse bottom}}
The end result:
Section header |
---|
Sample contents text |
TemplateData
See also
- {{Collapse bottom}}
- {{Hidden archive top}} and {{Hidden archive bottom}}
- {{Hidden begin}} and {{Hidden end}}
- {{Hidden}}}
[[Category:Formatting templates{{#translation:}}]]
[[Category:Template documentation pages{{#translation:}}]]