قالب:Navbox/doc

This template allows a navigational template to be set up relatively quickly by supplying it one or more lists of links. It comes equipped with default styles that should work for most navigational templates. Changing the default styles is not recommended, but is possible. Using this template, or one of its "Navbox suite" sister templates, is highly recommended for standardization of navigational templates, and for ease of use.

Usage

Please remove the parameters that are left blank.

{{Navbox
|bodyclass  = 
|name   = {{subst:PAGENAME}}
|title  = 
|titleclass = 
|image  = 
|above  = 

|group1 = 
|list1  = 

|group2 = 
|list2  = 
 ...
|group20    = 
|list20 = 

|below  = 
}}

Parameter list

The navbox uses lowercase parameter names, as shown in the box (at right). The mandatory name and title will create a one-line box if other parameters are omitted.

Notice "group1" (etc.) is optional, as are sections named "above/below".
The basic and most common parameters are as follows (see below for the full list):

bodyclass - applies an HTML class attribute to the entire navbox.

name - the name of the template.

title - text in the title bar, such as: Widget stuff.

titleclass - applies an HTML class attribute to the title bar.

state - autocollapse, uncollapsed, collapsed: the status of box expansion, where "autocollapse" hides stacked navboxes automatically.

titlestyle - a CSS style for the title-bar, such as: background:gray;

groupstyle - a CSS style for the group-cells, such as: background:#eee;

image - an optional right-side image, coded as the whole image. Typically it is purely decorative, so it should be coded as [[ملف:XX.jpg|90px|link=|alt=]].

imageleft - an optional left-side image (code the same as the "image" parameter).

above - text to appear above the group/list section (could be a list of overall wikilinks).

groupn - the left-side text before list-n (if group-n omitted, list-n starts at left of box).

listn - text listing wikilinks, often separated by middot templates, such as: [[A]]{{·}} [[B]]

below - optional text to appear below the group/list section.

Further details, and complex restrictions, are explained below under section Parameter descriptions. See some alternate navbox formats under: Layout of table.

Parameter descriptions

The following is a complete list of parameters for using {{Navbox}}. In most cases, the only required parameters are name, title, and list1, though child navboxes do not even require those to be set.

{{Navbox}} shares numerous common parameter names as its sister templates {{Navbox with columns}} and {{Navbox with collapsible groups}} for consistency and ease of use. Parameters marked with an asterisk * are common to all three master templates.

Setup parameters

name*

The name of the template, which is needed for the "v · d · e" ("view · discuss · edit") links to work properly on all pages where the template is used. You can enter Navbox/doc for this value as a shortcut. The name parameter is only mandatory if a title is specified, and the border parameter is not set.

state* [autocollapse, uncollapsed, collapsed, plain, off]

• Defaults to autocollapse. A navbox with autocollapse will start out collapsed if there are two or more tables on the same page that use other collapsible tables. Otherwise, the navbox will be expanded. For the technically minded, see MediaWiki:Common.js.
• If set to collapsed, the navbox will always start out in a collapsed state.
• If set to plain, the navbox will always be expanded with no [hide] link on the right, and the title will remain centered (by using padding to offset the v • d • e links).
• If set to off, the navbox will always be expanded with no [hide] link on the right, but no padding will be used to keep the title centered. This is for advanced use only; the "plain" option should suffice for most applications where the [show]/[hide] button needs to be hidden.
• If set to anything other than autocollapse, collapsed, plain, or off (such as "uncollapsed"), the navbox will always start out in an expanded state, but have the "hide" button.

To show the box when standalone (non-included) but then auto-hide contents when in an article, put "uncollapsed" inside <noinclude> tags:

• state = uncollapsed
• That setting will force the box visible when standalone (even when followed by other boxes), displaying "[hide]" but then auto-collapse the box when stacked inside an article.

Often times, editors will want a default initial state for a navbox, which may be overridden in an article. Here is the trick to do this:

• In your intermediate template, create a parameter also named "state" as a pass-through like this:
• | state = {{{state}}}
• The