Difference between revisions of "Template:Navbar/doc"

From BESA® Wiki
Jump to: navigation, search
(→‎See also: update)
m (277 revisions)
 
(272 intermediate revisions by 99 users not shown)
Line 1: Line 1:
−
<includeonly>:''This template documentation is [[Wikipedia:Template doc page pattern|transcluded]] from [[{{FULLPAGENAME}}/doc]]'' [<span class="plainlinks">[{{fullurl:{{FULLPAGENAMEE}}/doc|action=edit}} edit]</span>]</includeonly>
+
{{documentation subpage}}
−
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
+
{{high-risk|6,690,000+}}
−
{{esoteric}}
+
{{lua|Module:Navbar}}
 +
<!---PLEASE ADD METADATA TO THE <includeonly> SECTION AT THE BOTTOM OF THIS PAGE--->
 +
 
 
==Usage==
 
==Usage==
−
Copyable empty example:
+
===General===
−
<nowiki>{{Tnavbar|Name of Template|mini= |nodiv= |plain= }}</nowiki> inside  a given [[Wikipedia:Navigational templates|template]] to add Tnavbar navigational functionality.
+
When one of the following examples is placed inside a given [[Wikipedia:Navigation templates|template]], it adds navbar navigational functionality:
 +
:<code><nowiki>{{navbar|{{subst:PAGENAME}}|mini=y}}</nowiki></code>
 +
:<code><nowiki>{{navbar|{{subst:PAGENAME}}|plain=y}}</nowiki></code>
 +
:<code><nowiki>{{navbar|{{subst:PAGENAME}}|fontstyle=color: green; font-style: italic;}}</nowiki></code>
  
−
<nowiki>{{Tnavbar|Tnavbar}}</nowiki> gives: {{Tnavbar|Tnavbar}}
+
The <code><nowiki>{{subst:PAGENAME}}</nowiki></code> will be substituted with the template's name when parsed by the servers. For example, <code><nowiki>{{navbar|Navbar/doc}}</nowiki></code> gives:<br />{{navbar|Navbar/doc}}
  
−
==Note to editors==
+
===Font-size===
−
This template is represented across [[Special:Whatlinkshere/Template:Tnavbar|thousands of pages]] please tread lightly when editing here.  Conducting sufficient [[Template:Template sandbox|sandbox testing]] to establish the validity of edits relative to Tnavbar is '''strongly''' encouraged prior to attempting to integrate changes.
+
Font-size is 88% when used in a navbar, and 100% when nested in a navbox.
 +
In the navbar, the weight is "normal"; when nested in navbox, it takes on the outer setting. The middot is bold.  The {{para|fontstyle}} parameter can be used to adjust font size as needed (e.g. to reduce font size even more when the template is used inside a block element with a large font size).
  
 
==Examples==
 
==Examples==
−
<pre>{{Tnavbar|Name of Template|mini= |nodiv= |plain= }}</pre>
+
===Required parameters===
 +
*<code><nowiki>{{navbar|Template Name}}</nowiki></code> – the template name is required.
  
−
=== Required parameters ===
+
===Optional parameters===
−
*<code><nowiki>{{Tnavbar|Name of Template}}</nowiki></code> the template name is required.
+
−
 
+
−
=== Optional parameters ===
+
 
{| class="wikitable"
 
{| class="wikitable"
−
! Optional parameter !! colspan=2 | Produces...
+
! Options !! Parameters !! Produces...
 
|-
 
|-
−
|Divides into a separate section: <nowiki>{{Tnavbar|Tnavbar|mini=1}}</nowiki> like so. || → || Divides into a separate section: {{Tnavbar|Tnavbar|mini=1}} like so.
+
| Basic || <code><nowiki>{{navbar|Template Name}}</nowiki></code> || {{navbar|Navbar/doc}}
 
|-
 
|-
−
|<nowiki>{{Tnavbar|Tnavbar|nodiv=1}}</nowiki> Good for "blending" into text. || → || {{Tnavbar|Tnavbar|nodiv=1}} Good for "blending" into text.
+
| Different text || <code><nowiki>{{navbar|Template Name|</nowiki>'''text'''<nowiki>=This template:}}</nowiki></code> || {{navbar|Navbar/doc|text=This template:}}
 
|-
 
|-
−
|<nowiki>{{Tnavbar|Tnavbar|mini=1|nodiv=1}}</nowiki> Good for "blending" into text. || → || {{Tnavbar|Tnavbar|mini=1|nodiv=1}} Good for "blending" into text.
+
| Without "This box:" text || <code><nowiki>{{navbar|Template Name|</nowiki>'''plain'''<nowiki>=y}}</nowiki></code> || {{navbar|Navbar/doc|plain=y}}
 
|-
 
|-
−
|<nowiki>No "This box:" text. {{Tnavbar|Tnavbar|plain=1}}</nowiki> || → ||No "This box:" text. {{Tnavbar|Tnavbar|plain=1}}
+
| Short version || <code><nowiki>{{navbar|Template Name|</nowiki>'''mini'''<nowiki>=y}}</nowiki></code> || {{navbar|Navbar/doc|mini=y}}
 
|-
 
|-
−
|<nowiki>Blended no "This box:" text. {{Tnavbar|Tnavbar|plain=1|nodiv=1}}</nowiki> || → ||Blended no "This box:" text. {{Tnavbar|Tnavbar|plain=1|nodiv=1}}
+
| With brackets || <code><nowiki>{{navbar|Template Name|</nowiki>'''brackets'''<nowiki>=y}}</nowiki></code> || {{navbar|Navbar/doc|brackets=y}}
 +
|-
 +
| With font styling examples ([[Span and div|span]]) || <code><nowiki>{{navbar|Template Name|</nowiki>'''fontstyle'''<nowiki>=color: green; font-style: italic;}}</nowiki></code> || {{navbar|Navbar/doc|fontstyle=color: green; font-style: italic;}}
 +
|-
 +
| With whole-template styling examples ([[Span and div|div]]) || <code><nowiki>{{navbar|Template Name|</nowiki>'''style'''<nowiki>=float:right; background: Beige; padding: 5px; border: 1px solid;}}</nowiki></code> || {{navbar|Navbar/doc|style=float:right; background: Beige; padding: 5px; border: 1px solid;}}
 
|}
 
|}
 +
 +
===Deprecated parameters===
 +
The <code>miniv=y</code>, <code>viewplain=y</code>, <code>nodiv=y</code> and <code>fontcolor=</code> parameters have been deprecated. To implement the view-only version, use the {{tlx|v}} or {{tlx|view}} templates instead.
 +
 +
==Notes==
 +
Navbar is contained within a {{tag|div}} in order to accommodate a horizontal unnumbered list. This means it cannot be placed inside a {{tag|span}} or other inline element, because the [[HTML Tidy]] extension will 'fix' situations where it finds block elements inside inline elements.
 +
 +
==Prepackaged==
 +
;{{tl|Navbar-header}}: Positions {{navbar|Navbar/doc|mini=1}} on the right edge of the line, often used in non-collapsible navbox heading.
 +
;{{tl|Navbar-navframe}}: For use in conjunction with [[Wikipedia:NavFrame#NavFrame divs|NavFrame divs]], positions {{navbar|Navbar/doc|mini=1}} opposite of the [hide]/[show] feature.
 +
;{{tl|Navbar-collapsible}}: For use in conjunction with [[Wikipedia:NavFrame#Collapsible tables|collapsible tables]], floats {{navbar|Navbar/doc|mini=1}} opposite of the [hide]/[show] feature.
 +
 
==See also==
 
==See also==
−
<big>'''Please note:''' The following see also refers to a previous version of Tnavbar that is now deprecated. Any templates utilizing the following version of Tnavbar should be updated to use Tnavbar with Tnavbar's added parameter system. Please do not further employ the following template when adding Tnavbar to given templates.</big>
+
{{Edit templates}}
 +
{{Navigation templates}}
  
−
{| class="wikitable"
+
== TemplateData ==
−
! Template !! colspan=2 | This... !! colspan=2 | Produces...
+
{{TemplateData header}}
−
|-
+
<templatedata>
−
| {{tl|Tnavbar-mini}} || &rarr; || Divides into a separate section: <nowiki>{{Tnavbar-mini|Tnavbar}}</nowiki> like so. || &rarr; || Divides into a separate section: {{Tnavbar-mini|Tnavbar}} like so.
+
{
−
|}
+
        "description": "When placed inside a given template, it adds navbar navigational functionality",
−
<includeonly>
+
        "params": {
−
<!-- ADD CATEGORIES BELOW THIS LINE -->
+
                "": {
−
[[Category:Internal link templates|{{PAGENAME}}]]
+
                        "label": "Template Name",
 +
                        "description": "The name of the template, so links work correctly",
 +
                        "type": "string",
 +
                        "default": "",
 +
                        "required": true
 +
                },
 +
                "text": {
 +
                        "label": "Different text",
 +
                        "description": "Allows custom text to replace the default 'this box'",
 +
                        "type": "string",
 +
                        "default": "This box",
 +
                        "required": false
 +
                            },
 +
                "plain": {
 +
                        "label": "Without 'This box:' text",
 +
                        "description": "Removes 'This box'",
 +
                        "type": "number",
 +
                        "default": "0",
 +
                        "required": false
 +
 
 +
                },
 +
                "mini": {
 +
                        "label": "Short Version",
 +
                        "description": "Shortens text to V T E",
 +
                        "type": "number",
 +
                        "default": "0",
 +
                        "required": false
 +
                },
 +
                "brackets": {
 +
                        "label": "with brackets",
 +
                        "description": "adds brackets before and after the links",
 +
                        "type": "number",
 +
                        "default": "0",
 +
                        "required": false
 +
                },
 +
                "fontstyle": {
 +
                        "label": "Font color",
 +
                        "description": "Allows you to change the color of the font (in the format color:green)",
 +
                        "type": "string",
 +
                        "default": "",
 +
                        "required": false
 +
                },
 +
                "style": {
 +
                        "label": "To float to the side",
 +
                        "description": "Allows the template to float to the side (format=float:right)",
 +
                        "type": "string",
 +
                        "default": "float:left",
 +
                        "required": false
 +
 
 +
                }
 +
        }
 +
}
 +
</templatedata>
  
−
<!-- ADD INTERWIKIS BELOW THIS LINE -->
+
<!--- PLEASE ADD METADATA TO THE <includeonly> SECTION HERE --->
−
[[ru:Шаблон:Tnavbar]]
+
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
−
</includeonly>
+
[[Category:Internal link templates]]
 +
}}</includeonly>

Latest revision as of 13:23, 8 April 2016

Script error Script error

Usage

General

When one of the following examples is placed inside a given template, it adds navbar navigational functionality:

{{navbar|{{subst:PAGENAME}}|mini=y}}
{{navbar|{{subst:PAGENAME}}|plain=y}}
{{navbar|{{subst:PAGENAME}}|fontstyle=color: green; font-style: italic;}}

The {{subst:PAGENAME}} will be substituted with the template's name when parsed by the servers. For example, {{navbar|Navbar/doc}} gives:
Script error

Font-size

Font-size is 88% when used in a navbar, and 100% when nested in a navbox. In the navbar, the weight is "normal"; when nested in navbox, it takes on the outer setting. The middot is bold. The |fontstyle= parameter can be used to adjust font size as needed (e.g. to reduce font size even more when the template is used inside a block element with a large font size).

Examples

Required parameters

  • {{navbar|Template Name}} – the template name is required.

Optional parameters

Options Parameters Produces...
Basic {{navbar|Template Name}} Script error
Different text {{navbar|Template Name|text=This template:}} Script error
Without "This box:" text {{navbar|Template Name|plain=y}} Script error
Short version {{navbar|Template Name|mini=y}} Script error
With brackets {{navbar|Template Name|brackets=y}} Script error
With font styling examples (span) {{navbar|Template Name|fontstyle=color: green; font-style: italic;}} Script error
With whole-template styling examples (div) {{navbar|Template Name|style=float:right; background: Beige; padding: 5px; border: 1px solid;}} Script error

Deprecated parameters

The miniv=y, viewplain=y, nodiv=y and fontcolor= parameters have been deprecated. To implement the view-only version, use the {{v}} or {{view}} templates instead.

Notes

Navbar is contained within a <div>...</div> in order to accommodate a horizontal unnumbered list. This means it cannot be placed inside a <span>...</span> or other inline element, because the HTML Tidy extension will 'fix' situations where it finds block elements inside inline elements.

Prepackaged

{{Navbar-header}}
Positions Script error on the right edge of the line, often used in non-collapsible navbox heading.
{{Navbar-navframe}}
For use in conjunction with NavFrame divs, positions Script error opposite of the [hide]/[show] feature.
{{Navbar-collapsible}}
For use in conjunction with collapsible tables, floats Script error opposite of the [hide]/[show] feature.

See also

Script error

  • {{Ed}} – navbar style edit link
  • {{Ed right}} – navbar style edit link aligned to right of page
  • {{Edit}} – plain edit link
  • {{Edit section}} – edit link aligned to right of page
  • {{Navbar}} – with additional links
  • {{Vedit}} – edit with the Visual Editor
Navigation templates comparison
Script error Collapsible Header color Image Groups Style (body)
parameter/s 		Examples
{{Navbox}} collapsible navbox Left/right of body Yes Yes
{{Navbox with collapsible groups}} collapsible navbox Left/right of body and/or in each list Yes Yes
{{Navbox with columns}} collapsible navbox Left/right of columns No Yes
Collapsible attributes
Type CSS classes JavaScript Collapses when Custom
initial state 		Nesting
Collapsible tables collapsible Defined in Common.js 2 or more autocollapse on page Yes Yes

TemplateData

This is the TemplateData documentation for this template used by VisualEditor and other tools.

TemplateData for Navbar/doc

<templatedata> { 

       "description": "When placed inside a given template, it adds navbar navigational functionality",
       "params": {
               "": {
                       "label": "Template Name",
                       "description": "The name of the template, so links work correctly",
                       "type": "string",
                       "default": "",
                       "required": true
               },
               "text": {
                       "label": "Different text",
                       "description": "Allows custom text to replace the default 'this box'",
                       "type": "string",
                       "default": "This box",
                       "required": false
                            },
               "plain": {
                       "label": "Without 'This box:' text",
                       "description": "Removes 'This box'",
                       "type": "number",
                       "default": "0",
                       "required": false

               },
               "mini": {
                       "label": "Short Version",
                       "description": "Shortens text to V T E",
                       "type": "number",
                       "default": "0",
                       "required": false
               },
               "brackets": {
                       "label": "with brackets",
                       "description": "adds brackets before and after the links",
                       "type": "number",
                       "default": "0",
                       "required": false
               },
               "fontstyle": {
                       "label": "Font color",
                       "description": "Allows you to change the color of the font (in the format color:green)",
                       "type": "string",
                       "default": "",
                       "required": false
               },
               "style": {
                       "label": "To float to the side",
                       "description": "Allows the template to float to the side (format=float:right)",
                       "type": "string",
                       "default": "float:left",
                       "required": false

                }
       }

} </templatedata>


Retrieved from "https://wiki.besa.de/index.php?title=Template:Navbar/doc&oldid=1279"