Template:Collapsible option/doc
This is a documentation subpage for Template:Collapsible option. It may contain usage information, categories and other content that is not part of the original template page. |
This template is used on many pages, and changes to it will be widely noticed. Please test any changes in the template's /sandbox or /testcases subpages, or in a user subpage, and consider discussing changes at the talk page before implementing them. |
{{Collapsible option}}
is a utility template provides a standardised message for transclusion on template documentaion pages for templates whose collapsibility may be managed by the parameter |state=
.
It can be used on either the template page itself (wrapped within <noinclude>…</noinclude>
tags), but it is almost always better to place it in the template's {{documentation subpage}}
.
Indicating optional use of Template:Samp 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):
This template's initial visibility currently defaults to autocollapse
, meaning that if there is another collapsible item on the page (a navbox, sidebar, or table with the collapsible attribute), it is hidden apart from its title bar; if not, it is fully visible.
To change this template's initial visibility, the |state=
parameter may be used:
{{Collapsible option|state=collapsed}}
will show the template collapsed, i.e. hidden apart from its title bar.{{Collapsible option|state=expanded}}
will show the template expanded, i.e. fully visible.
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'sstate
argumentTemplate: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. Template:Crossref This option is permissible in navboxes, which are not part of the article content Template:Lang.
Slashes and the Template:Samp parameter
If the template name given to {{collapsible option}}</nowiki> includes a forward-slash (virgule) character – / – then the parameter |nobase=
(set to Template:Kbd, Template:Kbd, etc.) will need to be added so that the name is displayed correctly (i.e., so that Template:PAGENAME (talk links edit) rather than the default Template:BASEPAGENAME (talk links edit) is used to display it).
See also
- {{Navbox documentation}}, which includes this template
- {{Collapsible lists option}}
- {{Collapsible sections option}}
- Help:Collapsing