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