Template:Collapse top: Difference between revisions

}}">{{{1|{{{title|{{{reason|{{{header|{{{heading|Extended content}}}}}}}}}}}}}}}</th></tr><!--

| <tr><td style="text-align:center;font-style:italic">{{#if:{{{2|}}}|{{{2}}}|The following is a closed debate. {{Strong

|1=Please do not modify it.

<div style="width:100%;text-align:center">''The following content has been placed in a collapsed box for improved usability.''</div>

The {{Tlx|Collapse top}} template, and its paired template {{Tlx|Collapse bottom}}, are used for placing a collapse box around a talk page discussion.

== Usage ==

Place {{Tlx|Collapse top}} and {{Tlx|Collapse bottom}} around the text to be collapsed.

For example:

{{Collapse top|title=This is the title text}}

Sample contents text

{{Collapse top|title=This is the title text}}

Sample contents text

{{Tlx|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. <code style="color: #006400">1em</code> not <code style="color:#8B0000">1&nbsp;em</code>).

; {{Para|1}} <span style="font-weight:normal">(or first unnamed parameter)</span>, {{Para|title}}, {{Para|reason}}, {{Para|header}}, {{Para|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, <code><nowiki>{{Collapse top|title=This is the title text}}</nowiki></code> or <code><nowiki>{{Collapse top|This is the title text}}</nowiki></code>. Note: The shorter, unnamed markup will not work if the title value contain an equals (<code>=</code>) character.

: Will display a default warning line under the main title which reads "The following is a closed debate. {{Strong|style=color:red|Please do not modify it.}}"

: Any non-empty value supplied to this parameter will have this effect (i.e. {{Para|warning|<span style="color:red">no</span>}} will not work as expected).

; {{Para|2}} <span style="font-weight:normal">(or second unnamed parameter)</span>

: This is optional warning-line text. It will override the standard warning line above; it is not necessary to also use {{Para|warning|yes}} in this case, though doing so is harmless.

: 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. {{Para|left|<span style="color:#8B0000">no</span>}} will not work as expected).

: 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. {{Para|expand|<span style="color:#8B0000">no</span>}} will not work as expected).

: Sets the background color of the title of the collapsible bar. Defaults to <code>#F8FCFF</code>{{color-sample|1=#F8FCFF}}, a whitish color. Named colors are listed at [[List of colors]].

: For example, <code><nowiki>{{Collapse top|This is the title text|bg=#008000}}</nowiki></code> or <code><nowiki>{{Collapse top|This is the title text|bg=green}}</nowiki></code> (numeric HTML color codes require the leading <code>#</code>).

: Sets the font color of the title of the collapsible bar. Defaults to "black".

: See {{Para|bg}}, above, for details on color options.

: Sets the width of the border line on the collapsed material. Defaults to <code>1px</code>.

: For example, <code><nowiki>{{Collapse top|border=2px}}</nowiki></code>; going much thicker than this is not very useful.

: Sets the border color. Defaults to <code>silver</code> (<code>#C0C0C0</code>{{color-sample|1=#C0C0C0}}).

: See {{Para|bg}}, above, for details on color options.

: Sets the padding (distance from borders) on the collapsed material inside the colored area. Defaults to <code>8px</code>.

: 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. {{Para|width|50%}}, or in relative <code>em</code> units, e.g. {{Para|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.).

: Sets the properties of the border of the box that appears when template is expanded. Defaults to <code>1px silver</code> (there is no provision to change from a solid line).

: For example, <code><nowiki>{{Collapse top|border2=2px}}</nowiki></code> (only width or color will be changed if only one value is supplied).

: See {{Para|bg}}, above, for details on color options.

: Sets the background color of the box that appears when template is expanded; defaults to <code>white</code> (<code>#FFF</code>).

: See {{Para|bg}}, above, for details on color options.

: Indents the box from the left of the page. Defaults to no indentation. Each <code>:</code> in talk page markup is approximately equivalent to <code>1.6em</code> of indent (e.g., to match <code>::::</code> indentation level, use {{Para|indent|6.4em}}). You can also use a percentage value.

: Pixel-based values should be avoided (see {{Para|width}}, above, for the reason).

== Examples ==

* Adding a box title (if omitted, default is "Extended content") – <syntaxhighlight lang="wikitext" inline>{{Collapse top|This is the title text}}</syntaxhighlight>

* Adding a standard warning line – <syntaxhighlight lang="wikitext" inline>{{Collapse top|This is the title text|warning=true}}</syntaxhighlight>

* Adding a custom warning line – <syntaxhighlight lang="wikitext" inline>{{Collapse top|This is the title text|This is a custom warning line}}</syntaxhighlight>

* Aligning box title along left margin – <syntaxhighlight lang="wikitext" inline>{{Collapse top|left=true}}</syntaxhighlight>

* Changing background color – <syntaxhighlight lang="wikitext" inline>{{Collapse top|bg=#F0F2F5}}</syntaxhighlight>

* Adding extra padding – <syntaxhighlight lang="wikitext" inline>{{Collapse top|padding=5em}}</syntaxhighlight>

* Archiving a section – The markup below:

== TemplateData ==

== See also ==