استعرض مصدر قالب:Navbox generic/شرح

<includeonly>{{template doc page transcluded}}
{{tdeprecated|Navbox generic|Navbox}}
{{intricate template}}
</includeonly><noinclude>{{template doc page viewed directly}}</noinclude>
{{ambox | نص = يمكنك استعمال القالب المكافئ المترجم للعربية : [[قالب:صندوق تصفح عام]]
| نوع = تذكير
| صورة = [[ملف:Other languages square icon.svg|40px]]
}}
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
This template allows a [[Wikipedia:Navigational templates|navigational template]] to be set up relatively quickly by supplying it one or more lists of links.

== Blank template ==
<pre>
{{Navbox generic
|name       = {{subst:PAGENAME}}
|navbar     =
|state      = 
|titlestyle = 
|title      = 
|image      = 
|bodystyle  = <!-- (or "style =" if no other style parameters used) -->
|groupstyle = 
|liststyle  = 
|oddstyle   = 
|evenstyle  = 

|abovestyle = 
|above = 

|group1 = 
|list1  = 

|group2 = 
|list2  = 

 ...

|group20 = 
|list20  = 

|belowstyle = 
|below = 
}}
</pre>

==Parameters==
===Mandatory===
:; ''name''
:: The name of the template, which is needed for the "ع{{·}} ن{{·}} ت" ("view{{·}} discuss{{·}} edit") links to work properly on all pages where the template is used. You can enter <code><nowiki>{{subst:PAGENAME}}</nowiki></code> for this value as a shortcut.

:; ''title''
:: Text that appears centered in the top row of the table. It is usually the template's topic, i.e. a succinct description of the body contents. This should be a single line, but if a second line is needed, use <code><nowiki>{{-}}</nowiki></code> to ensure proper centering.
:: The background color defaults to <code><span style="background:#ccf; color:black;">#ccf</span></code> (truncated form of <code><span style="background: #ccccff;">#ccccff</span></code>), but can be changed via the ''titlestyle'' parameter (see below).

:; ''list<sub>n</sub>''
::  (i.e. ''list1'', ''list2'', etc.) The body of the template, usually a list of links. Format is inline, although the text can be entered on separate lines if the entire list is enclosed within <code><nowiki><div> </div></nowiki></code> (see [[#Example with code]]).  At least one ''list'' parameter is required; each additional ''list'' is displayed in a separate row of the table. Each ''list<sub>n</sub>'' may be preceded by a corresponding ''group<sub>n</sub>'' parameter, if provided (see below).
:: The background color of the list items (and the entire table) defaults to <code><span style="background:#f9f9f9; color:black;">#f9f9f9</span></code>, but can be changed via the ''bodystyle'', ''oddstyle'' and/or ''evenstyle'' parameters (see below).

===Optional===

====Cells====
:; ''group<sub>n</sub>''
:: (i.e. ''group1'', ''group2'', etc.) If specified, text appears in a header cell displayed to the left of ''list<sub>n</sub>''. If omitted, ''list<sub>n</sub>'' uses the full width of the table.
:: The background color defaults to <code><span style="background:#ddf; color:black;">#ddf</span></code> (truncated form of <code><span style="background: #ddddff;">#ddddff</span></code>), but can be changed via the ''groupstyle'' parameter (see below).

:; ''image''
:: An image to be displayed in a cell below the title and to the right of the body (the groups/lists). For the image to display properly, the ''list1'' parameter must be specified. The ''image'' parameter accepts standard wikicode for displaying an image, i.e.
::: <code><nowiki>[[Image:Example.jpg|100px]]</nowiki><code>
:: In a template where the body (the groups and/or lists) does not extend all the way to the right side, the image will shift away from the right edge of the template. This can be avoided by using the ''right'' parameter within the image wikicode, i.e.
::: <code><nowiki>[[Image:Example.jpg|80px|right]]</nowiki><code>

:; ''above''
:: A full-width cell displayed between the titlebar and first group/list, i.e. ''above'' the template's body (groups, lists and image). In a template without an image, ''above'' behaves in the same way as the ''list1'' parameter without the ''group1'' parameter.

:; ''below''
:: A full-width cell displayed ''below'' the template's body (groups, lists and image). In a template without an image, ''below'' behaves in the same way as the template's final ''list<sub>n</sub>'' parameter without a ''group<sub>n</sub>'' parameter. For an example of the ''below'' parameter in use, see {{tl|Lists of the provinces and territories of Canada}}.

====Styles====
:; ''titlestyle''
:: [[Cascading Style Sheets|CSS]] styles to apply to ''title'', most often the titlebar's background color:
::: <code><nowiki>titlestyle = background:</nowiki>''#nnnnnn'';</code>
::: <code><nowiki>titlestyle = background:</nowiki>''name'';</code>

:; ''bodystyle'' {{nobold|or}} ''style''
:: Specifies [[Cascading Style Sheets|CSS]] styles to apply to the template body. The shorter name ''style'' may be used when no other style parameters are specified. This option should be used sparingly as it can lead to visual inconsistencies. Examples:
::: <code>background:#''nnnnnn'';</code>
::: <code>width:''N''&nbsp;[em/%/px];</code>
::: <code>float:[''left/right/none''];</code>
::: <code>clear:[''right/left/both/none''];</code>

:; ''groupstyle''
:: CSS styles to apply to the ''groupN'' cells. This option overrides any styles that are applied to the entire table. Examples:
::: <code>background:#''nnnnnn'';</code>
::: <code>text-align:[''left/center/right''];</code>
::: <code>vertical-align:[''top/middle/bottom''];</code>
::: <code>white-space:nowrap;</code>

:; ''liststyle''
:: CSS styles to apply to all lists. Overruled by the ''oddstyle'' and ''evenstyle'' parameters (if specified) below.

:; ''oddstyle''
:; ''evenstyle''
:: CSS styles to apply to the odd-numbered list items (''list1'', ''list3'', etc) or even-numbered list items (''list2'', ''list4'', etc), respectively. Typically used to set background color (<code>background:#''nnnnnn'';</code>) in order to achieve an alternating background color between odd and even-numbered lists; see {{tl|Turkey topics}} for an example.

:; ''abovestyle''
:; ''belowstyle''
:: CSS styles to apply to the top cell (specified via the ''above'' parameter) and bottom cell (specified via the ''below'' parameter). Typically used to set background color or text alignment:
::: <code>background:#''nnnnnn'';</code>
::: <code>text-align:[''left/center/right''];</code>

===== Default styles =====

The style settings listed here are those that editors using the navbox change most often. The other more complex style settings were left out of this list to keep it simple.

:<code>titlestyle   = background:#ccccff; text-align:center;</code>
:<code>bodystyle    = background:#f9f9f9; width:100%; text-align:center; vertical-align:middle;</code>
:<code>groupstyle   = background:#ddddff;</code>
:<code>liststyle    = background:transparent;</code>
:<code>oddstyle     = background:transparent;</code>
:<code>evenstyle    = background:transparent;</code>
:<code>abovestyle   = background:transparent;</code>
:<code>belowstyle   = background:transparent;</code>

Since all but ''groupstyle'' and ''titlestyle'' have transparent background and no text-align all others inherit the ''bodystyle'', which defaults to a light gray background and centered text: <code>background:#f9f9f9; text-align:center; vertical-align:middle;</code>. 

====Other====
:; ''state''  
:: Variables = <code>expand | collapsed | autocollapse</code>. The default is set to <code>autocollapse</code>. If set to <code>collapsed</code>, the navbox will always start out in a collapsed state. If set to blank or anything other than <code>autocollapse</code> or <code>collapsed</code>, the navbox will always start out in an expanded state. A navbox with <code>autocollapse</code> will start out collapsed if there are two or more tables on the same page that use <tt>collapsible</tt>. For the technically minded, see [[MediaWiki:Common.js]].
:: Often times, editors will want a default initial state for a nav box, 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
::<tt><nowiki>| state = {{{state<includeonly>|your_desired_initial_state</includeonly>}}}</nowiki></tt>

::Example: {{tl|peso}} with autocollapse as the default initial state. [[Bolivian peso]] transcludes it and has only one nav box. So the peso nav box shows. [[Chilean peso]] has two nav boxes. So the peso nav box collapses.

::Example: {{tl|Historical currencies of Hungary}} with expanded as the default initial state. All transcluding articles shows the content by default, unless there were an hypothetical article that specifies state = collapsed when transcluding.

::The <nowiki><includeonly>|</nowiki> will make the template expanded when viewing the template page by itself.

:; ''navbar''
:: Defaults to <code>Tnavbar</code>. If set to <code>plain</code>, the {{navbar|Navbox generic|mini=1}} links on the left side of the titlebar will not be displayed.

== Layout of table ==
{| border="1" class="navbox collapsible" style="margin:auto;"
|+ <div style="text-align:left;">Table generated by {{tl|Navbox generic}} '''without''' ''image'', ''above'' and ''below'' parameters (borders added for illustration only):</div>
!colspan="2"| <div style="float:left; text-align:left; width:6em;">{{navbar|Navbox generic|mini=1}}</div><nowiki>{{{title}}}</nowiki>
|- 
! style="background:#ddf;" width="17%" | <nowiki>{{{group1}}}</nowiki>
| <nowiki>{{{list1}}}</nowiki>
|-
! style="background:#ddf;" | <nowiki>{{{group2}}}</nowiki>
| <nowiki>{{{list2}}}</nowiki>
|-
|colspan="2"| <nowiki>{{{list3}}} without {{{group3}}}</nowiki>
|}

{| border="1" class="navbox collapsible" style="margin:auto;"
|+ <div style="text-align:left;"><br>Table generated by {{tl|Navbox generic}} '''with''' ''image'', ''above'' and ''below'' parameters (borders added for illustration only):</div>
!colspan="3"| <div style="float:left; text-align:left; width:6em;">{{navbar|Navbox generic|mini=1}}</div><nowiki>{{{title}}}</nowiki>
|-
| colspan="3" style="background:#ddf;" | <nowiki>{{{above}}}</nowiki>
|-
! width="17%" style="background:#ddf;" | <nowiki>{{{group1}}}</nowiki>
| <nowiki>{{{list1}}}</nowiki>
| width="17%" rowspan="3"| <nowiki>{{{image}}}</nowiki>
|-
! style="background:#ddf;" | <nowiki>{{{group2}}}</nowiki>
| <nowiki>{{{list2}}}</nowiki>
|-
| colspan="2"| <nowiki>{{{list3}}} without {{{group3}}}</nowiki>
|-
| colspan="3" style="background:#ddf;" | <nowiki>{{{below}}}</nowiki>
|}

== Example with code ==
{| style="background:transparent; font-size:90%;"
|
<pre>
{{Navbox generic
|name      = {{subst:PAGENAME}}
|state     = {{{state|uncollapsed}}}
|title     = [[Wikipedia:Navigational templates|Navigational templates]]
|bodystyle = width:50%;

|group1    = Physics
|list1     = [[Template:Cosmology|Cosmology]]{{·}} [[Template:General relativity|Relativity]]{{·}}
[[Template:String-theory|String theory]]

|group2    = Continents
|list2     = <div>
[[Template:Africafooter|Africa]]{{·}}
[[Template:Asia topics|Asia]]{{·}}
[[Template:Europefooter|Europe]]
</div>

|list3     = [[Template:National parks of Argentina|Argentinian National Parks]]
}}
</pre>
|}

{{msg:{{BASEPAGENAME}}
|name      = Navbox generic/doc
|state     = {{{state|uncollapsed}}}
|title     = [[Wikipedia:Navigational templates|Navigational templates]]
|bodystyle = width:50%;
|group1    = Physics
|list1     = [[Template:Cosmology|Cosmology]]{{·}} [[Template:General relativity|Relativity]]{{·}} [[Template:String-theory|String theory]]
|group2    = Continents
|list2     = <div>
[[Template:Africafooter|Africa]]{{·}}
[[Template:Asia topics|Asia]]{{·}}
[[Template:Europefooter|Europe]]
</div>
|list3  = [[Template:National parks of Argentina|Argentinian National Parks]]
}}

== Additional examples ==
===No image===
{{Navbox generic
|name   = Navbox generic/doc
|state  = uncollapsed
|title  = [[Multimedia Super Corridor|MSC (Multimedia Super Corridor) Malaysia]]{{-}}''without image''
|group1 = Centre
|list1  = [[Cyberjaya]]
|group2 = Area
|list2  = [[Klang Valley]]
|group3 = Major landmarks
|list3  = [[Petronas Twin Towers]]{{·}} [[Kuala Lumpur Tower]]{{·}} [[Kuala Lumpur Sentral]]{{·}} [[Technology Park Malaysia]]{{·}} [[Putrajaya]]{{·}} [[Cyberjaya]]{{·}} {{nowrap|[[Kuala Lumpur International Airport]]}}
|group4 = Infrastructure
|list4  = [[Express Rail Link]]{{·}} [[KL-KLIA Dedicated Expressway]]
|group5 = Prime applications
|list5  = [[EGovernment]]{{·}} [[MyKad]]  
}}

===With image===
{{Navbox generic
|name   = Navbox generic/doc
|state  = uncollapsed
|title  = [[Multimedia Super Corridor|MSC (Multimedia Super Corridor) Malaysia]]{{-}}''with image''
|image  = [[Image:Flag of Malaysia.svg|120px]]
|group1 = Centre
|list1  = [[Cyberjaya]]
|group2 = Area
|list2  = [[Klang Valley]]
|group3 = Major landmarks
|list3  = [[Petronas Twin Towers]]{{·}} [[Kuala Lumpur Tower]]{{·}}  [[Kuala Lumpur Sentral]] {{·}} [[Technology Park Malaysia]]{{·}}  [[Putrajaya]]{{·}}  [[Cyberjaya]]{{·}} [[Kuala Lumpur International Airport]]
|group4 = Infrastructure
|list4  = [[Express Rail Link]]{{·}} [[KL-KLIA Dedicated Expressway]]
|group5 = Prime applications
|list5  = [[EGovernment]]{{·}} [[MyKad]]  
}}

===With image and styles===
{{Navbox generic
|name  = Navbox generic/doc
|state = uncollapsed
|title = [[Multimedia Super Corridor|MSC (Multimedia Super Corridor) Malaysia]]{{-}}''with image; body (lists): white background; groups: top and right-aligned, don't wrap white space; even rows: light grey background; bottom: center-aligned, light blue background''
|image = [[Image:Flag of Malaysia.svg|120px]]
|bodystyle = background-color:white;
|groupstyle = text-align:right; vertical-align:top; white-space:nowrap;
|evenstyle  = background:#f0f0f0;
|group1 = Centre
|list1  = [[Cyberjaya]]
|group2 = Area
|list2  = [[Klang Valley]]
|group3 = Major landmarks
|list3  = [[Petronas Twin Towers]]{{·}} [[Kuala Lumpur Tower]]{{·}} [[Kuala Lumpur Sentral]]{{·}} [[Technology Park Malaysia]]{{·}} [[Putrajaya]]{{·}} [[Cyberjaya]]{{·}} [[Kuala Lumpur International Airport]]
|group4 = Infrastructure
|list4  = [[Express Rail Link]]{{·}} [[KL-KLIA Dedicated Expressway]]
|group5 = Prime applications
|list5  = [[EGovernment]]{{·}} [[MyKad]]
|belowstyle = text-align:center; background:#ddddff;
|below  = Website: [http://www.msc.com.my/ www.msc.com.my]
}}

== انظر أيضا ==

* {{tn|·}} and {{tn|•}} - The dots and bullets usually used in the link lists in the navboxes.


{{Navigational templates}}


<includeonly>


<!--Other languages-->
[[en:Template:Navbox generic]]
[[cy:Nodyn:Blwch llywio generig]]
[[fi:Malline:Navbox generic]]
[[fr:Modèle:Méta palette de navigation]]
[[gl:Modelo:Navbox]]
[[id:Templat:Navbox]]
[[ja:Template:Navbox generic]]
[[lv:Veidne:Navbox generic]]
[[ms:Templat:Navbox generic]]
[[no:Mal:Navbox generic]]
[[pt:Predefinição:Navbox generic]]
[[ro:Format:Casetă de navigare de bază]]
[[ru:Шаблон:Навигационная таблица]]
[[simple:Template:Navbox generic]]
[[sl:Predloga:Navpolje]]
[[su:Citakan:Navbox generic]]
[[sv:Mall:Navbox generic]]
[[uk:Шаблон:Навігаційна таблиця]]
[[vi:Tiêu bản:Navbox generic]]
[[zh:Template:Navbox generic]]
[[it:Template:Navbox generic/man]]
[[ja:Template:Navbox generic/doc]]
[[pt:Predefinição:Navbox generic]]
[[ru:Шаблон:Navbox]]
[[uk:Шаблон:Навігаційна таблиця/Документація]]
[[zh:Template:Navbox]]

</includeonly>