Menyunting Templat:Navbar/doc

{{documentation subpage}}
{{high-risk|240.000+}}
{{lua|Modul:Navbar}}{{#ifeq:{{BASEPAGENAME}}|VTE|{{tsh|V}}}}
<!---PLEASE ADD METADATA TO THE <includeonly> SECTION AT THE BOTTOM OF THIS PAGE--->

== Usage ==
=== General ===
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=1}}</nowiki></code>
:<code><nowiki>{{navbar|{{subst:PAGENAME}}|plain=1}}</nowiki></code>
:<code><nowiki>{{navbar|{{subst:PAGENAME}}|fontstyle=color:green}}</nowiki></code>

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

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

== Examples ==
=== Required parameters ===
*<code><nowiki>{{navbar|Template Name}}</nowiki></code> – the template name is required.

=== Optional parameters ===
{| class="wikitable"
! Options !! Parameters !! Produces...
|-
| Basic || <code><nowiki>{{navbar|Template Name}}</nowiki></code> || {{navbar|navbar/doc}}
|-
| Different text || <code><nowiki>{{navbar|Template Name|text=This template:}}</nowiki></code> || {{navbar|navbar/doc|text=This template:}}
|-
| Without "This box:" text || <code><nowiki>{{navbar|Template Name|plain=1}}</nowiki></code> || {{navbar|navbar/doc|plain=1}}
|-
| Short version || <code><nowiki>{{navbar|Template Name|mini=1}}</nowiki></code> || {{navbar|navbar/doc|mini=1}}
|-
| With brackets
| <code><nowiki>{{navbar|Template Name|brackets=1}}</nowiki></code>
| {{navbar|navbar/doc|brackets=1}}
|-
| With a color option ([[Span and div|span]]) || <code><nowiki>{{navbar|Template Name|fontstyle=color:green}}</nowiki></code> || {{navbar|navbar/doc|fontstyle=color:green}}
|-
| To float to the side ([[Span and div|div]]) || <code><nowiki>{{navbar|Template Name|style=float:right}}</nowiki></code> || {{navbar|navbar/doc|style=float:right}}
|}

=== Deprecated parameters ===
The <code>miniv=1</code>, <code>viewplain=1</code>, <code>nodiv=1</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|Tnavbar-navframe}}: For use in conjunction with [[Wikipedia:NavFrame|Navframe div]]s, 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 ==
{{Edit templates}}
{{Navigational templates}}

<!--- PLEASE ADD METADATA TO THE <includeonly> SECTION HERE --->
<includeonly>
[[Kategori:Internal link templates]]
</includeonly>
<templatedata>
{
        "description": "When placed inside a given template, it adds navbar navigational functionality",
        "params": {
                "1": {
                        "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>