الگو:Navbox/توضیحات: تفاوت میان نسخه‌ها

 

این الگو امکان ایجاد یک [[وح:الگوهای ناوبری|جعبه ناوبری]] با یک یا چند فهرست پیونددار به کاربر می‌دهد. این الگو دارای ظاهر و استایل پیش‌فرض است و در حالت معمول نیازی به تنظیم ندارد؛ این در حالی است که تغییر دادن ظاهر این الگو پیشنهاد نمی‌شود. استفاده از این الگو و الگوهای خواهرش برای یکسان کردن و استانداردسازی تمام الگوهای ناوبری و استفادهٔ راحت‌تر توصیه می‌شود.

|bodyclass  =

|title      =

|titleclass =

|image      =

|above      =

|group1    =

|list1      =

|group2    =

|list2      =

|group20    =

|list20    =

|below      =

:<code>title -</code> متن نوار عنوان؛ مثلا

 

<nowiki>[[شهرهای باستانی و تاریخی ایران]]</nowiki> :<code>titleclass -</code> به نوار عنوان یک کلاس [[اچ‌تی‌ام‌ال|HTML]] نسبت می‌دهد.

:<code>image - </code>درج تصویر اختیاری در سمت چپ الگو. تصویر به نوعی زینتی است و باید به صورت

 

<nowiki>[[Image:XX.jpg|90px|link=|alt=]]</nowiki> کدنویسی شود.

:<code>list_n - </code>متنی است که پیوندهای ویکی را فهرست می‌کند. این پیوندها اغلب با میان‌نقطه ({{·}}) جدا می‌شوند. مانند

 

<nowiki>[[فیزیک]]{{·}}[[شیمی]]</nowiki> که می‌شود: [[فیزیک]]{{·}}[[شیمی]].

{{tl|Navbox}} shares numerous common parameter names as its sister templates {{tl|Navbox with columns}} and {{tl|Navbox with collapsible groups}} for consistency and ease of use.  Parameters marked with an asterisk

 

<nowiki>*</nowiki> are common to all three master templates.

:; ''name''

 

<nowiki>*</nowiki> :: 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 <code>

 

<nowiki>{{subst:PAGENAME}}</nowiki> </code> for this value as a shortcut.  The name parameter is only mandatory if a <code>title</code> is specified, and the <code>border</code> parameter is not set.

:; ''state''

 

<nowiki>*</nowiki> <span style="font-weight:normal;">[<code>autocollapse, uncollapsed, collapsed, plain, off</code>]</span>

:* <code>state = </code>

 

<nowiki><noinclude>uncollapsed</noinclude></nowiki> :* 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.

:*<tt>

 

<nowiki>| state = {{{state<includeonly>|your_desired_initial_state</includeonly>}}}</nowiki> </tt>

:*The

 

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

:; ''navbar''

 

:; ''border''

 

<nowiki>*</nowiki> :: ''See section below on using navboxes within one another for examples and a more complete description.''  If set to <code>child</code> or <code>subgroup</code>, then the navbox can be used as a borderless child that fits snuggly in another navbox.  The border is hidden and there is no padding on the sides of the table, so it fits into the ''list'' area of its parent navbox.  If set to <code>none</code>, then the border is hidden and padding is removed, and the navbox may be used as a child of another container (do not use the <code>none</code> option inside of another navbox; similarly, only use the <code>child</code>/<code>subgroup</code> option inside of another navbox).  If set to anything else (default), then a regular navbox is displayed with a 1px border.  An alternate way to specify the border to be a subgroup style is like this (i.e. use the first unnamed parameter instead of the named ''border'' parameter):

:::<code>

 

<nowiki>{{Navbox|child</nowiki> </code>

:::<code>

 

<nowiki>}}</nowiki> </code>

:; ''title''

<nowiki>*</nowiki> :: 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.  This parameter is technically not mandatory, but using {{tl|Navbox}} is rather pointless without a title.

:; ''group_n''

<nowiki>*</nowiki> :: (i.e. ''group1'', ''group2'', etc.) If specified, text appears in a header cell displayed to the left of ''list_n''. If omitted, ''list_n'' uses the full width of the table.

:; ''list_n''

<nowiki>*</nowiki> ::  (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>.  At least one ''list'' parameter is required; each additional ''list'' is displayed in a separate row of the table.  Each ''list_n'' may be preceded by a corresponding ''group_n'' parameter, if provided (see below).

 

:; ''image''

 

<nowiki>*</nowiki> :: 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, ''e.g.'':

 

 

 

 

 

 

 

 

<nowiki>*</nowiki> :: 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_n'' parameter without a ''group_n'' parameter. For an example of the ''below'' parameter in use, see {{tl|Lists of the provinces and territories of Canada}}.

Styles are generally not recommended as to maintain consistency among templates and pages in Wikishia.  However, the option to modify styles is given.

:; ''style''

 

<nowiki>*</nowiki> :: Specifies [[برگه‌های سبک آبشاری|CSS]] styles to apply to the template body.  The parameter ''bodystyle'' also does the exact same thing and can be used in place of this ''style'' parameter.  This option should be used sparingly as it can lead to visual inconsistencies. Examples:

:; ''basestyle''

 

<nowiki>*</nowiki> :: CSS styles to apply to the ''title'', ''above'', ''below'', and ''group'' cells all at once.  The styles are not applied to ''list'' cells.  This is convenient for easily changing the basic color of the navbox without having to repeat the style specifications for the different parts of the navbox.  Examples:

:; ''titlestyle''

 

 

 

:; ''groupstyle''

 

<nowiki>*</nowiki> :: CSS styles to apply to the ''groupN'' cells. This option overrides any styles that are applied to the entire table. Examples:

:; ''group_nstyle''

 

<nowiki>*</nowiki> :: CSS styles to apply to a specific group, in addition to any styles specified by the ''groupstyle'' parameter.  This parameter should only be used when absolutely necessary in order to maintain standardization and simplicity.  Examples:

:; ''liststyle''

 

<nowiki>*</nowiki> :: CSS styles to apply to all lists. Overruled by the ''oddstyle'' and ''evenstyle'' parameters (if specified) below. When using backgound colors in the navbox, see the [[#Intricacies|note below]].

 

 

:; ''listpadding''

<nowiki>*</nowiki> :: A number and unit specifying the padding in each ''list'' cell.  The ''list'' cells come equipped with a default padding of 0.25em on the left and right, and 0em on the top and bottom.  Due to complex technical reasons, simply setting "liststyle=padding:0.5em;" (or any other padding setting) will not work.  Examples:

:; ''abovestyle''

 

<nowiki>*</nowiki> :; ''belowstyle''

 

<nowiki>*</nowiki> :: 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:

:; ''imagestyle''

 

<nowiki>*</nowiki> :; ''imageleftstyle''

 

<nowiki>*</nowiki> :: CSS styles to apply to the cells where the image/imageleft sits.  These styles should only be used in exceptional circumstances, usually to fix width problems if the width of groups is set and the width of the image cell grows too large.  Examples:

:<code>titlestyle = background:#ccccff; padding-left:1em; padding-right:1em; text-align:center;</code>

:<code>abovestyle = background:#ddddff; padding-left:1em; padding-right:1em; text-align:center;</code>

:<code>belowstyle = background:#ddddff; padding-left:1em; padding-right:1em; text-align:center;</code>

:<code>groupstyle = background:#ddddff; padding-left:1em; padding-right:1em; text-align:right;</code>

:<code>evenstyle  = background:#f7f7f7;</code>

<pre>

 

<nowiki>

</nowiki> </pre>

See [[Wikishia:WikiProject Microformats]] for more information on adding microformat information to Wikishia, and [[microformat]] for more information on microformats in general.

| list1 = [[Petronas Twin Towers]]{{·}} [[Kuala Lumpur Tower]]{{·}}

|list2 =

|list4 =

  |group2 = [[French West Africa]]

  |group4 = [[French Equatorial Africa]]

  |list4  = [[Colonial Chad|Chad]]{{·}} [[History of Gabon|Gabon]]{{·}} [[History of the Republic of the Congo|Middle Congo]]{{·}} [[Oubangui-Chari]]

  |list5  = [[Anjouan]]{{·}} [[Grande Comore]]{{·}} [[Mohéli]]

  |titlestyle =

  |groupstyle =

  |list1 = [[فرانسه نو]]{{spaces|2}}<small>([[آکادی (مستعمره فرانسوی)]]&nbsp;• [[Louisiana (New France)|Louisiana]]&nbsp;• [[Canada, New France|Canada]]&nbsp;• [[نیوفاندلند (جزیره)|Terre&nbsp;Neuve]]) 1655 – 1763 </small>

  |list2 = [[Inini]]{{·}} [[Berbice]]{{·}} [[Saint-Domingue]]&nbsp;<small>([[هائیتی]])</small>{{·}} [[Tobago]]{{·}} [[History of the British Virgin Islands|Virgin&nbsp;Islands]]{{·}} {{nowrap|[[France Antarctique]]}}{{·}} {{nowrap|[[فرانسه استوایی]]}}

  |belowstyle =

  |groupstyle =

  |group2 = [[French Indochina]]

  |list2  = [[Colonial Cambodia|Cambodia]]{{·}} [[History of Laos to 1945#French Laos|Laos]]{{·}} [[French Indochina|Vietnam]]&nbsp;<small>([[Annam (French colony)|Annam]]&nbsp;• [[Cochinchina]]&nbsp;• [[Tonkin]])</small>

  |belowstyle =

This navbox template is specifically designed to work in conjunction two other sister templates: {{tl|Navbox with columns}} and {{tl|Navbox with collapsible groups}}.  All three of these templates share common parameters for consistency and ease of use (such parameters are marked with a ^'''†''' in the complete parameter list above).  Most importantly, all three of these templates can each be used as children of one another (by using the <code>border = child</code> parameter, or by specifying the first unnamed parameter to be <code>child</code> (i.e. use <code>

 

<nowiki>{{Navbox|child</nowiki> </code>, <code>

 

<nowiki>{{Navbox with columns|child</nowiki> </code>, or <code>

 

<nowiki>{{Navbox with collapsible groups|child</nowiki> </code>).  For examples on how this is done, see the page on [[Template:Navbox/doc/Advanced examples|advanced navbox examples]].

If the heading of the navbox spans more than one line, the second line will be displayed to the right of center.  This can be avoided by hard-coding linebreaks with {{nowrap|<code>

 

<nowiki><br clear=all></nowiki> </code>.}}