Difference between revisions of "Template:Hidden/doc"

From blackwiki
Jump to navigation Jump to search
(ar)
imported>DB1729
m (Reverted 1 edit by 2001:56A:770D:9800:282D:E922:75F9:43D0 (talk) to last revision by DB1729)
 
(50 intermediate revisions by 36 users not shown)
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
+
<!-- Categories go where indicated at the bottom of this page, please; interwikis go to Wikidata (see also: [[Wikipedia:Wikidata]]). -->
 +
{{high-use| 111160 }}
 +
{{Template:Collapse Templates}}
  
This template creates a [[Wikipedia:NavFrame|dynamic navigation box]] using style sheet declarations in [[MediaWiki:Common.css]] and Javascript code in [[MediaWiki:Common.js]]. It displays the first parameter (the heading) with a [show] link on the right.  If [show] is clicked by the user, the second parameter (the body) is displayed below the heading and the [show] link becomes [hide].  Clicking on [hide] then hides the body again and the [hide] link becomes [show] again.
+
This template creates a [[Wikipedia:NavFrame|dynamic navigation box]] using style sheet declarations in [[MediaWiki:Common.css]] and Javascript code in [[MediaWiki:Common.js]]. In a saved, [[Rendering (computer graphics)|rendered]] page this template creates a clickable link that toggles between [show] and [hide]. It displays the first parameter (the heading) with a [show] link on the right.  If [show] is clicked by the user, it displays the second parameter (the body) below the heading and the [show] link becomes [hide].  Clicking on [hide] then hides the body and the [hide] link becomes [show] again.
  
The template does '''not''' provide an argument to designate the initial state of the show/hide control.  In the nested case, show/hide controls in hidden content retain their state.  There is no facility for ''collapse all'' or ''reveal all''.   
+
If this template is nested in another, the show/hide links in the hidden content keep their state; there is no parameter for ''collapse all'' or ''reveal all''.   
  
==Usage==
+
Generally, collapsible templates should not be used in articles. For allowable uses and other considerations, please see [[MOS:COLLAPSE]].
===Syntax===
+
 
 +
== Usage ==
 +
 
 +
===Full syntax===
 
<pre style="overflow:auto;">
 
<pre style="overflow:auto;">
 
{{Hidden
 
{{Hidden
|header=
+
| expanded=true  <!--(omit for initial hidden state)-->
|content=
+
| style =  
|style=
+
| headerstyle =  
|headerstyle=
+
| header =  
|contentstyle
+
| contentstyle =
|fw1=
+
| content =
|fw2=
+
 
|bg1=
+
|fw1= |fw2= |bg1= |bg2= |ta1= |ta2=
|bg2=
 
|ta1=
 
|ta2=
 
 
}}
 
}}
 
</pre>
 
</pre>
Line 26: Line 28:
 
===Parameters===
 
===Parameters===
 
Only two parameters are required for this template:
 
Only two parameters are required for this template:
;header : text for header (or title); alternative to using unnamed parameter <nowiki>{{{1}}}</nowiki>
+
; header : text for header (title); alternative to using unnamed parameter <nowiki>{{{1}}}</nowiki>
;content : text for content (or body); alternative to using unnamed parameter <nowiki>{{{2}}}</nowiki>
+
; content : text for body (content); alternative to using unnamed parameter <nowiki>{{{2}}}</nowiki>
  
 
====Optional====
 
====Optional====
;style : add [[w:Cascading Style Sheets|CSS]] to the main div.
+
; style       : [[w:Cascading Style Sheets|CSS]] styling for template overall.
;headerstyle : add [[w:Cascading Style Sheets|CSS]] to the header.
+
; headerstyle : CSS styling for title (header).
;contentstyle : add [[w:Cascading Style Sheets|CSS]] to the content box.
+
; contentstyle : CSS styling for the hidden content.
 +
; expanded    : any nonblank value (e.g. {{para|expanded|on}}) will cause the template to be initially expanded by default.
 +
; multiline    : any nonblank value (e.g. {{para|multline|y}}) will reduce the line-height of the title and add some padding to avoid overlap with the show/hide button.
 +
'''Note:''' This template will not respect the [[Wikipedia:User preferences|user preference]] "justify paragraphs".
  
<br/>'''Note:''' This template will not respect the user preference "justify paragraphs".
+
== Examples ==
  
==Examples==
 
 
===Basic===
 
===Basic===
 
In this example only the two required parameters are specified.
 
In this example only the two required parameters are specified.
Line 44: Line 48:
 
|-
 
|-
 
| {{rh}} | Result
 
| {{rh}} | Result
| {{hidden|Title text here|Body text line 1<br/>Body text line 2}}
+
| {{{{PAGENAMETDOC}}|Title text here|Body text line 1<br/>Body text line 2}}
 
|}
 
|}
  
Line 50: Line 54:
 
{| class="wikitable"
 
{| class="wikitable"
 
| {{rh}} | Code
 
| {{rh}} | Code
| <pre style="overflow:auto;">
+
| <syntaxhighlight lang="css" style="overflow:auto;">
 
{{hidden
 
{{hidden
 
|Title text here
 
|Title text here
Line 57: Line 61:
 
|style=text-align:center;
 
|style=text-align:center;
 
}}
 
}}
</pre>
+
</syntaxhighlight>
 
|-
 
|-
 
| {{rh}} | Result
 
| {{rh}} | Result
| {{hidden|Title text here|Body text line 1<br/>Body text line 2|headerstyle=background:#ccccff|style=text-align:center;}}
+
| {{{{PAGENAMETDOC}}|Title text here|Body text line 1<br/>Body text line 2|headerstyle=background:#ccccff|style=text-align:center;}}
 
|}
 
|}
  
Line 67: Line 71:
 
| {{rh}} | Code
 
| {{rh}} | Code
 
|  
 
|  
<pre>
+
<syntaxhighlight lang="css">
 
{{hidden
 
{{hidden
| style = border:1px dashed red; width: 50%;
+
| style = border: 1px dashed red; width: 50%;
 
| headerstyle = background: #ccccff; font-size: 110%;
 
| headerstyle = background: #ccccff; font-size: 110%;
| contentstyle = text-align: center; color:green;
+
| contentstyle = text-align: center; color: green;
 
| header = Title text here
 
| header = Title text here
 
| content = Body text line 1<br />Body text line 2<br />Body text line 3
 
| content = Body text line 1<br />Body text line 2<br />Body text line 3
}}</pre>
+
}}</syntaxhighlight>
 
|-
 
|-
 
| {{rh}} | Result
 
| {{rh}} | Result
 
|  
 
|  
{{hidden
+
{{{{PAGENAMETDOC}}
 
| style = border:1px dashed red; width: 50%;
 
| style = border:1px dashed red; width: 50%;
 
| headerstyle = background: #ccccff; font-size: 110%;
 
| headerstyle = background: #ccccff; font-size: 110%;
Line 90: Line 94:
 
=== Show/hide button overlap ===
 
=== Show/hide button overlap ===
 
<div style="background:pink;font-weight:bold">With ta1=right or a long header, the header may overlap the show/hide button:</div>
 
<div style="background:pink;font-weight:bold">With ta1=right or a long header, the header may overlap the show/hide button:</div>
{{evd|hidden|Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.|def}}
+
{{evd|{{PAGENAMETDOC}}|Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.|def}}
  
 
{{clr}}
 
{{clr}}
;<div style="background:cyan;font-weight:bold">Possible workaround is to add "padding-right:3em;" to the headercss parameter:</div>
+
;<div style="background:cyan;font-weight:bold">Possible workaround is to use {{para|multiline|y}}:</div>
"<nowiki>{{hidden|headerstyle=text-align:right; padding-right:3em;|Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.|def}}</nowiki>" gives "{{hidden|headerstyle=text-align:right; padding-right:3em;|Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.|def}}"
+
"<nowiki>{{hidden|multiline=y|Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.|def}}</nowiki>" gives "{{{{PAGENAMETDOC}}|multiline=y|Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.|def}}"
  
 
<div style="background:pink;font-weight:bold">Example with long header</div>
 
<div style="background:pink;font-weight:bold">Example with long header</div>
{{hidden|abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc |def}}
+
{{{{PAGENAMETDOC}}|abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc |def}}
  
 
{{clr}}
 
{{clr}}
 
;<div style="background:cyan;font-weight:bold">Above example with workaround:</div>
 
;<div style="background:cyan;font-weight:bold">Above example with workaround:</div>
"<nowiki>{{hidden|headerstyle=padding-right:3em;|abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc |def}}</nowiki>" gives "{{hidden|headerstyle=padding-right:3em;|abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc |def}}"
+
"<nowiki>{{hidden|multiline=y|abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc |def}}</nowiki>" gives "{{{{PAGENAMETDOC}}|multiline=y|abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc |def}}"
  
 
=== Sections ===
 
=== Sections ===
Line 108: Line 112:
 
==== You can't get here from the table of contents ====
 
==== You can't get here from the table of contents ====
 
{{hidden end}}
 
{{hidden end}}
 +
 +
==Tracking category==
 +
* {{clc|Hidden templates using styles}} – tracks usage of parameters bg1, bg2, ta1, ta2, fw1, fw2
  
 
==See also==
 
==See also==
* {{tiw|hidden begin}}
+
Supporting templates:
* {{tiw|hidden end}}
+
* {{tiw|Hidden begin}}
* {{tim|hidden}}
+
* {{tiw|Hidden end}}
 +
Similar templates:
 +
* {{tim|Hidden}}
 
* {{tiw|Collapsible list}}
 
* {{tiw|Collapsible list}}
  
<includeonly><!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
+
<includeonly>{{Sandbox other||
[[Category:Collapse templates|{{PAGENAME}}]]
+
<!-- Categories go below this line, please; interwikis go to Wikidata, thank you! -->
[[Category:Wikipedia formatting and function templates|{{PAGENAME}}]]
+
[[Category:Collapse templates]]
 +
[[Category:Wikipedia formatting and function templates]]
 +
[[Category:Templates that add a tracking category]]
  
<!-- [[en:Template:Hidden]] -->
+
}}</includeonly>
[[ar:قالب:مخفي]]
 
[[bs:Šablon:Sakrij]]
 
[[cy:Nodyn:Cuddiwyd]]
 
[[dsb:Pśedłoga:Nawikašćik]]
 
[[et:Mall:Peidetud]]
 
[[eo:Ŝablono:Kaŝskatolo]]
 
[[fr:Modèle:Boîte déroulante]]
 
[[hy:Կաղապար:Նավարկման զոլ]]
 
[[hsb:Předłoha:Nawigaciska lajsta]]
 
[[ku:Şablon:Hidden]]
 
[[mk:Шаблон:Hidden]]
 
[[ja:Template:Hidden]]
 
[[pl:Szablon:Ukryj]]
 
[[pt:Predefinição:Oculto]]
 
[[sv:Mall:Dold]]
 
[[uk:Шаблон:Hidden]]
 
</includeonly>
 

Latest revision as of 11:02, 14 December 2020

This template creates a dynamic navigation box using style sheet declarations in MediaWiki:Common.css and Javascript code in MediaWiki:Common.js. In a saved, rendered page this template creates a clickable link that toggles between [show] and [hide]. It displays the first parameter (the heading) with a [show] link on the right. If [show] is clicked by the user, it displays the second parameter (the body) below the heading and the [show] link becomes [hide]. Clicking on [hide] then hides the body and the [hide] link becomes [show] again.

If this template is nested in another, the show/hide links in the hidden content keep their state; there is no parameter for collapse all or reveal all.

Generally, collapsible templates should not be used in articles. For allowable uses and other considerations, please see MOS:COLLAPSE.

Usage

Full syntax

{{Hidden
| expanded=true  <!--(omit for initial hidden state)-->
| style = 
| headerstyle = 
| header = 
| contentstyle = 
| content =

|fw1= |fw2= |bg1= |bg2= |ta1= |ta2=
}}

Parameters

Only two parameters are required for this template:

header
text for header (title); alternative to using unnamed parameter {{{1}}}
content 
text for body (content); alternative to using unnamed parameter {{{2}}}

Optional

style
CSS styling for template overall.
headerstyle
CSS styling for title (header).
contentstyle 
CSS styling for the hidden content.
expanded
any nonblank value (e.g. |expanded=on) will cause the template to be initially expanded by default.
multiline
any nonblank value (e.g. |multline=y) will reduce the line-height of the title and add some padding to avoid overlap with the show/hide button.

Note: This template will not respect the user preference "justify paragraphs".

Examples

Basic

In this example only the two required parameters are specified.

Template:Rh | Code
{{hidden|Title text here|Body text line 1<br/>Body text line 2}}
Template:Rh | Result {{Template:PAGENAMETDOC|Title text here|Body text line 1
Body text line 2}}

Header background

Template:Rh | Code
{{hidden
|Title text here
|Body text line 1<br/>Body text line 2
|headerstyle=background:#ccccff
|style=text-align:center;
}}
Template:Rh | Result {{Template:PAGENAMETDOC|Title text here|Body text line 1
Body text line 2|headerstyle=background:#ccccff|style=text-align:center;}}

CSS

Template:Rh | Code
{{hidden
| style = border: 1px dashed red; width: 50%;
| headerstyle = background: #ccccff; font-size: 110%;
| contentstyle = text-align: center; color: green;
| header = Title text here
| content = Body text line 1<br />Body text line 2<br />Body text line 3
}}
Template:Rh | Result

{{Template:PAGENAMETDOC

style = border:1px dashed red; width: 50%; headerstyle = background: #ccccff; font-size: 110%; contentstyle = text-align: center; color:green; header = Title text here content = Body text line 1
Body text line 2
Body text line 3

}}

Issues

Show/hide button overlap

With ta1=right or a long header, the header may overlap the show/hide button:

Template:Xpd2

Possible workaround is to use |multiline=y:

"{{hidden|multiline=y|Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.|def}}" gives "{{Template:PAGENAMETDOC|multiline=y|Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.|def}}"

Example with long header

{{Template:PAGENAMETDOC|abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc |def}}

Above example with workaround:

"{{hidden|multiline=y|abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc |def}}" gives "{{Template:PAGENAMETDOC|multiline=y|abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc |def}}"

Sections

Sections included inside a hidden block result in broken anchors in the table of contents at the top of the page.

example

You can't get here from the table of contents

Tracking category

See also

Supporting templates:

Similar templates: