Template:Navbox: Difference between revisions

Latest revision as of 09:04, 6 March 2024

Template Documentation

This page has been put into protection by a PZwiki administrator.

Reason: This template is considered High Risk as it is used on multiple pages.

Only users in the sysop user group may edit this page.

This is a metatemplate used to quickly create a navigational template in a standardized style.

Navboxes are used to provide a convenient way to navigate between related articles. They are not always related to the article directly, but are instead related to the overarching topic. E.g., Template:Navbox weapons, or Template:Navbox locations. They will usually be placed at the bottom of an article in the "see also" section.

Usage

{{Navbox
| title = Example
| content = {{Navbox/row
  | group = group1
  | list = list, list, list, list, list, list, list, list, list, list, list, list, 
  }}
| id = example
}}

Parameters

title ^Required: Title.
content ^Required: Container for the content. {{Navbox/row}} will usually be here.
id ^Required: The unique ID for the navbox.
image: Image to be displayed beneath the title and next to the content.
above: Displayed beneath the title but below the content.
below: Displayed beneath the content.
theme: Color of the navbox, can be blue or red. Default is red.
collapsed: Initial state of the content. Will be collapsed by default (true). Set to false to start expanded.

The following are from {{Navbox/row}}.

group: Group name. Used from {{Navbox/row}}
list: List of articles to be linked to. Usually separated with a bullet point • or •

Examples

How to translate

This template doesn't need to/shouldn't be translated, but you can translate the documentation of this template with the following steps:

Create a subpage of this template with the language code of the language you want to translate to.
Copy the code wrapped in the <noinclude> tag in this template into the page you created.
{{Translation guide}} template should be removed from the translated documentation.
Translate the page according to the translation requirements of normal pages.

@@ Line 1: / Line 1: @@
 <noinclude>
 {{Documentation/sandbox|doc =
-{{Underconstruction}}
+{{Protection|This template is considered '''High Risk''' as it is used on multiple pages.}}
-{{Navbox/sandbox
+This is a metatemplate used to quickly create a navigational template in a standardized style.
+Navboxes are used to provide a convenient way to navigate between related articles. They are not always related to the article directly, but are instead related to the overarching topic. E.g., [[Template:Navbox weapons]], or [[Template:Navbox locations]]. They will usually be placed at the bottom of an article in the "see also" section.
+==Usage==
+<pre>{{Navbox
 | title = Example
-| content = {{Navbox/sandbox
+| content = {{Navbox/row
+  | group = group1
+  | list = list, list, list, list, list, list, list, list, list, list, list, list,
+  }}
+| id = example
+}}</pre>
+===Parameters===
+;<code>title</code> {{sup|required}}
+:Title.
+;<code>content</code> {{sup|required}}
+:Container for the content. {{tll|Navbox/row}} will usually be here.
+;<code>id</code> {{sup|required}}
+:The unique ID for the navbox.
+;<code>image</code>
+:Image to be displayed beneath the title and next to the content.
+;<code>above</code>
+:Displayed beneath the title but below the content.
+;<code>below</code>
+:Displayed beneath the content.
+;<code>theme</code>
+:Color of the navbox, can be <code>blue</code> or <code>red</code>. Default is <code>red</code>.
+;<code>collapsed</code>
+:Initial state of the content. Will be collapsed by default (<code>true</code>). Set to <code>false</code> to start expanded.
+'''''The following are from {{tll|Navbox/row}}.'''''
+;<code>group</code>
+:Group name. Used from {{tll|Navbox/row}}
+;<code>list</code>
+:List of articles to be linked to. Usually separated with a bullet point <code>&bull;</code> or {{code|&bull;}}
+==Examples==
+{{Navbox
+| title = Example
+| collapsed = false
+| above = above
+| below = below
+| content = {{Navbox
    | title = Sub-title
+  | collapsed = false
+  | above = above
    | content = {{Navbox/row
      | group = group1
@@ Line 18: / Line 62: @@
    | id = sub
    | image = [[File:Image.png|80px]]
+  | theme = blue
    }}
 | image = [[File:Image.png|100px]]
@@ Line 23: / Line 68: @@
 }}
+{{Translation guide}}
+==See also==
+{{Navbox see also}}
 }}
 {{ll|Category:Navbox}}
-</noinclude><includeonly><div class="navbox">
+</noinclude><includeonly><div class="navbox theme-{{#switch:{{{theme|}}}|blue=blue|#default=red}}" style="clear: both;">
-   <div class="navbox-row navbox-title">{{#if:{{{title|}}}|{{{title}}}|Title}}</div>
+   <div>{{#if:{{{title|}}}|{{{title}}}|Title}}<!--## Start temporary show/hide ##
-  {{#if:{{{above|}}}|<div class="navbox-row mw-collapsible">{{{above}}}</div>}}
+--><span class="mw-customtoggle-navbox-{{{id|}}}" title="{{int:show}} / {{int:hide}}" style="float:right; padding-right:30px; padding-top:4px; font-size:0.7em; font-weight:normal;">{{int:show}} / {{int:hide}}</span><!--
-   <div class="navbox-section mw-collapsible" id="mw-customcollapsible-navbox-{{{id|[[Category:Incorrect template usage]]}}}">
+## End temporary show/hide ## --></div>
-  <div>{{{content|}}}</div>
+   <div class="mw-collapsible {{yesno|{{{collapsed|yes}}}|yes=mw-collapsed}}" id="mw-customcollapsible-navbox-{{{id|[[Category:Incorrect template usage]]}}}">
-  {{#if:{{{image|}}}|<div class="navbox-image">{{{image}}}</div>}}
+    {{#if:{{{above|}}}|<div class="navbox-row">{{{above}}}</div>}}
+    <div class="navbox-section">
+      <div>{{{content|}}}</div>
+      {{#if:{{{image|}}}|<div>{{{image}}}</div>}}
+    </div>
+    {{#if:{{{below|}}}|<div class="navbox-row">{{{below}}}</div>}}
    </div>
-   <div class="navbox-toggle mw-customtoggle-navbox-{{{id|[[Category:Incorrect template usage]]}}}">×</div>
+   <div class="toggle mw-customtoggle-navbox-{{{id|}}}" title="{{int:show}} / {{int:hide}}"></div>
-  {{#if:{{{below|}}}|<div class="navbox-row mw-collapsible" id="mw-customcollapsible-navbox-{{{id|[[Category:Incorrect template usage]]}}}">{{{below}}}</div>}}
 </div></includeonly>