Template:Collapse top/doc: Difference between revisions
Jump to navigation
Jump to search
m
Reverted edits by 66.87.70.149 (talk) (HG) (3.1.19)
(←Replaced content with 'lies') |
w:en>Bentogoa m (Reverted edits by 66.87.70.149 (talk) (HG) (3.1.19)) |
||
| Line 1: | Line 1: | ||
{{Documentation subpage}} | |||
<!-- Place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) --> | |||
{{High-use|24,900+}} | |||
{{used in system|in [[MediaWiki:Protect-text]]}} | |||
{{Template shortcut|Cot|Cob}} | |||
The {{tlx|collapse top}} template (or {{tlx|cot}}), and its paired template {{tlx|collapse bottom}} (or {{tlx|cob}}), are used for placing a collapse box around a talk page discussion, especially when the content contains complex wikimarkup such as tables. For very simple content, the one-piece template {{tlx|collapse}} can be used instead. | |||
These templates should only be used in accordance with the [[Wikipedia:Refactoring]] guideline; they should never be used to end a discussion over the objections of other editors, except in cases of unambiguous disruptive editing. | |||
Do not hide content in articles. This violates the [[WP:Manual of Style#Scrolling lists and collapsible content]] and [[WP:Accessibility]] guidelines. | |||
== Usage == | |||
Place {{tlx|collapse top}} (or {{tlx|cot}}), and {{tlx|collapse bottom}} (or {{tlx|cob}}), around the text to be collapsed. For example: | |||
<pre>{{collapse top|title=This is the title text}} | |||
Sample contents text | |||
{{collapse bottom}}</pre> | |||
produces: | |||
{{collapse top|title=This is the title text}} | |||
Sample contents text | |||
{{collapse bottom}} | |||
== Parameters == | |||
This template takes the following parameters, all of which are optional | |||
;positional parameter 1, named parameter 'title': These parameters give the main title of collapsed box, 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|This is the title text}}</nowiki></code> or <code><nowiki>{{collapse top|title=This is the title text}}</nowiki></code> | |||
;warning: If this parameter evaluates to true (i.e. is not empty) it will display a default warning line under the main title which reads "The following is a closed debate. {{strongbad|Please do not modify it.}}" For example, <code><nowiki>{{collapse top|This is the title text|warning=true}}</nowiki></code> | |||
;positional parameter 2: This is optional warning-line text. It will override the standard warning line above, and make the 'warning' parameter unnecessary. For example, <code><nowiki>{{collapse top|This is the title text|This is a custom warning line}}</nowiki></code> | |||
;left: If this parameter evaluates to true (i.e. is not empty) it will align the 'parameter 1 title' along the left margin. Text aligns centered between the left margin and the left bracket of the left ''show'' link by default. For example, <code><nowiki>{{collapse top|This is the title text|left=true}}</nowiki></code> | |||
;expand: If this parameter evaluates to true (i.e. is not empty) it will leave the material uncollapsed with the border and coloring. Default is to collapse the material. For example, <code><nowiki>{{collapse top|This is the title text|expand=true}}</nowiki></code> | |||
;bg: Sets the background color of the collapsed material. Defaults to #CFC - a pleasant green. Other colors available from [[List of colors]]. For example, <code><nowiki>{{collapse top|This is the title text|bg=#F0F2F5}}</nowiki></code> | |||
;fc: Sets the font color of the title of the collapsible bar. Defaults to Black. Other colors available from [[List of colors]]. For example, <code><nowiki>{{collapse top|This is the title text|fc=#F0F2F5}}</nowiki></code> | |||
;border: Sets the width of the border line on the collapsed material. defaults to 1px. For example, <code><nowiki>{{collapse top|This is the title text|border=2px}}</nowiki></code> | |||
;b-color: Sets the border color. defaults to silver. For example, <code><nowiki>{{collapse top|This is the title text|b-color=#F0F2F5}}</nowiki></code> | |||
;padding: Sets the padding on the collapsed material in the colored area. Defaults to 8px. For example, <code><nowiki>{{collapse top|This is the title text|padding=16px}}</nowiki></code> | |||
;width: Sets the width of the overall template. Use {{para|width|50%}}, not {{para|Width|50%}} as upper case "W" doesn't work. Or <code>|width=200px</code> (if you omit "px" it doesn't work). | |||
;border2: Sets 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, <code><nowiki>{{collapse top|This is the title text|border2=2px}}</nowiki></code> | |||
;bg2: Sets background of the box that appears when template is expanded; defaults to white. For example, <code><nowiki>{{collapse top|This is the title text|bg2=#F0F2F5}}</nowiki></code> | |||
;indent: indents the box from the left of the page. Use: {{para|indent|50px}} not {{para|Indent|50px}} (upper case "I" doesn't work). Defaults to "do not indent" (i.e. 0px). Each ":" in wiki-markup is approximately equivalent to 25px indent. | |||
;clear: In some situations you may not want the default <code>clear: both;</code> CSS to apply, with puts the collapse box below any left- or right-floated content within the same HTML block. In this case, you can use {{para|clear|none}}, {{para|clear|right}}, or {{para|clear|left}}, as needed. | |||
== Examples == | |||
* Adding a box title (if omitted, default is 'Extended content') - <code><nowiki>{{collapse top|This is the title text}}</nowiki></code> | |||
{{collapse top|This is the title text}} | |||
{{lorem ipsum}} | |||
{{collapse bottom}} | |||
* Adding a standard warning line - <code><nowiki>{{collapse top|This is the title text|warning=true}}</nowiki></code> | |||
{{collapse top|This is the title text|warning=true}} | |||
{{lorem ipsum}} | |||
{{collapse bottom}} | |||
* Adding a custom warning line - <code><nowiki>{{collapse top|This is the title text|This is a custom warning line}}</nowiki></code> | |||
{{collapse top|This is the title text|This is a custom warning line}} | |||
{{lorem ipsum}} | |||
{{collapse bottom}} | |||
* Aligning box title along left margin - <code><nowiki>{{collapse top|left=true}} or {{collapse top|left=true}}</nowiki></code> | |||
{{collapse top|left=true}} | |||
{{lorem ipsum}} | |||
{{collapse bottom}} | |||
* Changing background color - <code><nowiki>{{collapse top|bg=#F0F2F5}}</nowiki></code> | |||
{{collapse top|bg=#F0F2F5}} | |||
{{lorem ipsum}} | |||
{{collapse bottom}} | |||
* Adding extra padding - <code><nowiki>{{collapse top|padding=40px}}</nowiki></code> | |||
{{collapse top|padding=40px}} | |||
{{lorem ipsum}} | |||
{{collapse bottom}} | |||
* Archiving a section: the markup below: | |||
<pre>{{collapse top}} | |||
==Section header== | |||
Sample contents text | |||
{{collapse bottom}}</pre> | |||
must be rewritten as: | |||
<pre>{{collapse top|Section header}} | |||
Sample contents text | |||
{{collapse bottom}}</pre> | |||
The end result: | |||
{{collapse top|Section header}} | |||
Sample contents text | |||
{{collapse bottom}} | |||
== TemplateData == | |||
*[[Template:Collapse top/TemplateData]] | |||
== Redirects == | |||
To Collapse top: | |||
* {{tl|cot}} | |||
* {{tl|DAT}} | |||
To Collapse bottom: | |||
* {{tl|cob}} | |||
* {{tl|hab}} | |||
* {{tl|hidden archive bottom}} | |||
== See also == | |||
* {{tl|collapse}} | |||
* {{#ifeq: {{BASEPAGENAME}} | Collapse top || {{tl|collapse top}} }} | |||
* {{#ifeq: {{BASEPAGENAME}} | Collapse bottom || {{tl|collapse bottom}} }} | |||
* {{tl|discussion top}} and {{tl|discussion bottom}} | |||
* {{tl|hidden archive top}} and {{tl|hidden archive bottom}} | |||
* {{tl|hidden begin}} and {{tl|hidden end}} | |||
* {{tl|hidden}} | |||
* {{tl|collapsible list}} | |||
{{Warchivenav|state=uncollapsed}} | |||
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox|| | |||
<!-- Categories below this line, please; interwikis at Wikidata --> | |||
[[Category:Archival templates]] | |||
[[Category:Collapse templates]] | |||
}}</includeonly> | |||