Difference between revisions of "Template:Collapsible option/doc"
imported>Paine Ellsworth m (update /doc) |
imported>SMcCandlish (markup cleanup; MOS:DONTHIDE note.) |
||
| Line 2: | Line 2: | ||
<!-- Categories go where indicated at the bottom of this page, please; interwikis go to Wikidata (see also: [[Wikipedia:Wikidata]]). --> | <!-- Categories go where indicated at the bottom of this page, please; interwikis go to Wikidata (see also: [[Wikipedia:Wikidata]]). --> | ||
{{High-risk| approximately 108000 }} | {{High-risk| approximately 108000 }} | ||
| − | {{ | + | {{tlx|Collapsible option}} provides a standardised message for [[Wikipedia:Transclusion|transclusion]] on the pages of collapsible templates whose collapsibility may be managed by the parameter {{para|state}}. |
| − | It may be used on either the template page itself (wrapped within {{tag|noinclude}} tags) or on the template's {{ | + | It may be used on either the template page itself (wrapped within {{tag|noinclude}} tags) or on the template's {{tlx|documentation subpage}}. |
| + | |||
| + | ===Indicating optional use of {{samp|state}} name=== | ||
| + | The {{para|state}} parameter used to manage collapsible templates need not always be named explicitly, i.e. {{tnull|{{var|Template name}}{{!}}{{var|state}}}} can be the same as {{tnull|{{var|Template name}}|state{{=}}{{var|state}}}}, if the template is coded that way. To indicate this in the {{tnull|Collapsible option}} message, add the parameter {{para|statename|optional}}. This modifies the message so that it reads (if it were used for itself): | ||
| − | |||
| − | |||
<div style="clear:both;margin:1.0em 0;background:whitesmoke;"> | <div style="clear:both;margin:1.0em 0;background:whitesmoke;"> | ||
{{Collapsible option |statename=optional}} | {{Collapsible option |statename=optional}} | ||
</div> | </div> | ||
| − | + | ||
| − | *<code><nowiki>{{{1|}}}</nowiki></code> as part of a collapsible template's | + | This possibility is enabled by including: |
| + | *<code><nowiki>{{{1|}}}</nowiki></code> as part of a collapsible template's {{para|state}} parameter{{spaced ndash}}for instance, as {{para|state|<nowiki>{{{state|{{{1|}}}}}}</nowiki>}} or {{para|state|<nowiki>{{{state|{{{1|<noinclude>expanded</noinclude>}}}}}}</nowiki>}}, etc. | ||
*<code><nowiki><noinclude></nowiki></code>,<code><nowiki><includeonly></nowiki></code>as part of a collapsible template's <code>state</code> argument{{spaced ndash}}for instance, as {{para|state|<nowiki>{{{state<includeonly>|collapsed</includeonly>}}}</nowiki>}} | *<code><nowiki><noinclude></nowiki></code>,<code><nowiki><includeonly></nowiki></code>as part of a collapsible template's <code>state</code> argument{{spaced ndash}}for instance, as {{para|state|<nowiki>{{{state<includeonly>|collapsed</includeonly>}}}</nowiki>}} | ||
| − | If, however, the template includes collapsible sections within itself (e.g. {{ | + | If, however, the template includes collapsible sections within itself (e.g. {{tlx|Navbox with collapsible groups}}), then enabling this possibility may introduce ambiguity as regards what is to be collapsed or expanded. In those instances, therefore, the requirement to use {{para|state}} should be retained. |
| + | |||
| + | ===Changing the default state=== | ||
| + | To change the default state {{tnull|Collapsible option}} uses, add the parameter {{para|default|collapsed}} or {{para|default|expanded}} accordingly. To restore the default, remove any {{para|default}} previously included. | ||
| − | + | The {{para|default|collapsed}} option must not be used in main article content in mainspace, e.g. to hide [[Wikipedia:Manual of Style/Tables|tables of information]], or to cram extraneous details into [[Wikipedia:Manual of Style/Infoboxes|infoboxes]]. {{crossref|printworthy=y|(For more information, see {{section link|Wikipedia:Manual of Style#Scrolling lists and collapsible content}}.)}} This option {{em|is}} permissible in [[Wikipedia:Navigation boxes|navboxes]], which are not part of the article content {{lang|la|per se}}. | |
| − | |||
| − | === | + | ===Slashes and the {{samp|nobase}} parameter === |
| − | If the template name given to | + | If the template name given to {{tnull|Collapsible option}}</nowiki> includes a forward-slash (virgule) character – <kbd>/</kbd> – then the parameter {{para|nobase}} (set to {{kbd|on}}, {{kbd|true}}, etc.) will need to be added so that the name is displayed correctly (i.e., so that {{tld|PAGENAME}} rather than the default {{tld|BASEPAGENAME}} is used to display it). |
== See also == | == See also == | ||
| − | * {{ | + | * {{tlx|Collapsible lists option}} |
| − | * {{ | + | * {{tlx|Collapsible sections option}} |
* [[Help:Collapsing]] | * [[Help:Collapsing]] | ||
Revision as of 02:15, 22 April 2019
| This is a documentation subpage for Template:Collapsible option. It contains usage information, categories and other content that is not part of the original template page. |
| File:Ambox warning orange.svg | This template is used on approximately 120,000 pages. To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them. Transclusion count updated automatically (see documentation). |
{{Collapsible option}} provides a standardised message for transclusion on the pages of collapsible templates whose collapsibility may be managed by the parameter |state=.
It may be used on either the template page itself (wrapped within <noinclude>...</noinclude> tags) or on the template's {{documentation subpage}}.
Contents
Indicating optional use of state name
The |state= parameter used to manage collapsible templates need not always be named explicitly, i.e. {{Template name|state}} can be the same as {{Template name|state=state}}, if the template is coded that way. To indicate this in the {{Collapsible option}} message, add the parameter |statename=optional. This modifies the message so that it reads (if it were used for itself):
Initial visibility: currently defaults to autocollapse
To set this template's initial visibility, the |state= parameter may be used:
|state=collapsed:{{Collapsible option|state=collapsed}}to show the template collapsed, i.e., hidden apart from its title bar|state=expanded:{{Collapsible option|state=expanded}}to show the template expanded, i.e., fully visible|state=autocollapse:{{Collapsible option|state=autocollapse}}
If the |state= parameter in the template on this page is not set, the template's initial visibility is taken from the |default= parameter in the Collapsible option template. For the template on this page, that currently evaluates to autocollapse.
This possibility is enabled by including:
{{{1|}}}as part of a collapsible template's|state=parameterTemplate:Spaced ndashfor instance, as|state={{{state|{{{1|}}}}}}or|state={{{state|{{{1|<noinclude>expanded</noinclude>}}}}}}, etc.<noinclude>,<includeonly>as part of a collapsible template'sstateargumentTemplate:Spaced ndashfor instance, as|state={{{state<includeonly>|collapsed</includeonly>}}}
If, however, the template includes collapsible sections within itself (e.g. {{Navbox with collapsible groups}}), then enabling this possibility may introduce ambiguity as regards what is to be collapsed or expanded. In those instances, therefore, the requirement to use |state= should be retained.
Changing the default state
To change the default state {{Collapsible option}} uses, add the parameter |default=collapsed or |default=expanded accordingly. To restore the default, remove any |default= previously included.
The |default=collapsed option must not be used in main article content in mainspace, e.g. to hide tables of information, or to cram extraneous details into infoboxes. This option is permissible in navboxes, which are not part of the article content per se.
Slashes and the nobase parameter
If the template name given to {{Collapsible option}}</nowiki> includes a forward-slash (virgule) character – / – then the parameter |nobase= (set to on, true, etc.) will need to be added so that the name is displayed correctly (i.e., so that {{PAGENAME}} rather than the default {{BASEPAGENAME}} is used to display it).
See also