الگو:Navbox subgroup/توضیحات

این زیرصفحهٔ مستندات الگو:Navbox subgroup است.
این شامل اطلاعات استفاده، الگوها، پیوندهای بین زبانی و سایر اطلاعات است که در اصل الگو صفحه قرار نمی‌گیرد.

این الگو از ویژگی و دستورهای پیچیده استفاده می‌کند.

توصیه می‌شود پیش از ویرایش الگو با دستورهای الگو و توابع تجزیه‌کننده آشنا شوید. اگر ویرایش‌تان باعث بروز مشکلات غیرمنتظره شد، خواهشمند است آن را به‌سرعت برگردانید، زیرا ممکن است این الگو در شمار زیادی صفحه ظاهر شود.
به‌یاد داشته باشید که شما می‌توانید آزمایش انجام دهید، اما باید همهٔ بهسازی‌ها را پیش از آن‌که در اینجا اعمال کنید، در یا فضای کاربری‌تان بیازمایید.

This template is designed to be used with {{Navbox}} or other navigation templates that allow creating lists of links with groups headers or titles. This template allows the creation of subgroups that can be assigned to a list item within {{Navbox}}. A subgroup may contain up to 20 list items.

Blank template[ویرایش مبدأ]

{{Navbox subgroup
| groupstyle = 
| liststyle  = 

| group1 = 
| list1  = 
| group2 = 
| list2  = 
...
| group20 = 
| list20  = 
}}

Parameters[ویرایش مبدأ]

This template employs all parameters of {{Navbox}}. Please see the documentation there for more complete descriptions. In fact, the only differences between this template and {{Navbox}} are as follows:

The border parameter defaults to "child"
The group padding defaults to 0.75em on the left/right, and can only be changed with the grouppadding parameter. This is done to prevent the Internet Explorer box model bug from affecting the width of groups.

Everything else is exactly the same as {{Navbox}}.

Only the most common parameters are listed below.

Cells[ویرایش مبدأ]

list_n: (i.e. list1, list2, ... list20) The body of the template, usually a list of links. Format is inline. 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). The background color of the list items (and the entire table) defaults to transparent, therefore it displays the same background color used in the parent navigation box.

group_n: (i.e. group1, group2, ..., group20) 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. The background color defaults to #e5edff, but can be changed via the groupstyle parameter (see below).

Styles[ویرایش مبدأ]

bodystyle

Specifies CSS styles to apply to the template body. Examples:

background:#nnnnnn;

text-align:[right/center/left/justified];

groupstyle

CSS styles to apply to the group_n cells. This option overrides any styles that are applied to the entire table. Examples:

background:#nnnnnn;

text-align:[left/center/right];

vertical-align:[top/middle/bottom];

white-space:nowrap;

grouppadding

CSS style to specify group padding. Should usually be specified using em units. It is recommended to leave this parameter alone and use the default padding. Examples:

grouppadding = 0em 1em; (1em on left/right, 0em on top/bottom)

grouppadding = 0em 0.5em 0em 1em; (0em top, 0.5em right, 0em bottom, 1em left)

liststyle: CSS styles to apply to all lists. Overridden 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 (background:#nnnnnn;) in order to achieve an alternating background color between odd and even-numbered lists.

evenodd [swap, even, odd, off]: If set to swap, then the automatic striping of even and odd rows is reversed. Normally, even rows get a light gray background for striping; when this parameter is used, the odd rows receive the gray striping instead of the even rows. Setting to even or odd sets all rows to have that striping color. Setting to off disables automatic row striping. NOTE: Due to system limitations, do not use a semi-colon to close this command.

Setting the width of groups[ویرایش مبدأ]

If multiple {{Navbox subgroup}} templates are used inside of a parent {{Navbox}}, it generally looks better if the width of the groups matches up. In order to do this, one must set the groupwidth parameter:

groupwidth = 10em

An alternative way is to set the groupstyle parameters to contain the desired width, and the liststyle parameters to have width:auto (due to HTML/CSS reasons). For example, place the following code in each {{Navbox subgroup}} to adjust the widths:

groupstyle = width:10em;

liststyle = width:auto;

NOTE: For the groupstyle widths to work, you must set the liststyle width to "auto".

If you also use the image or imageleft parameters, then you will most likely also need to set their width manually using the imagestyle and imageleftstyle parameters.

نمونه[ویرایش مبدأ]

در زیر مثالی از استفاده Navbox subgroup در یک الگوی ناوباکس است.

{{Navbox
| state  = uncollapsed
| name   = مناطق حفاظت‌شده کلرادو
| title  = مناطق حفاظت‌شده کلرادو
| listclass = hlist
| group1 = سازمان پارک‌های ملی
| list1  = {{Navbox subgroup
  | group1 = پارک‌های ملی
  | list1  =
*[[پارک ملی بلک کنیون آو د گانیسون| بلک کنیون آو د گانیسون]]
*[[پارک ملی تل‌ماسه‌های بزرگ|تل‌ماسه‌های بزرگ]]
*[[پارک ملی میزا ورده|میزا ورده]]
*[[پارک ملی کوه راکی|کوه راکی]]
  | group2 = آثار ملی
  | list2  =
*[[Colorado National Monument|Colorado]]
*[[Florissant Fossil Beds National Monument|Florissant Fossil Beds]]
*[[Hovenweep National Monument|Hovenweep]]
*[[Yucca House National Monument|Yucca House]]
  | group3 = مکان‌های تاریخی و ملی
  | list3  =
*[[Bent's Old Fort National Historic Site|Bent's Old Fort]]
*[[Sand Creek Massacre National Historic Site|Sand Creek Massacre]]
  | group4 = منطقه تفریحی ملی
  | list4  =
*[[Curecanti National Recreation Area|Curecanti]]
  }}
| group2 = جنگل‌های ملی
| list2  =
*[[Arapaho National Forest|Arapaho]]
*[[Grand Mesa National Forest|Grand Mesa]]
*[[Gunnison National Forest|Gunnison]]
*[[جنگل ملی پایک|پایک]]
*[[جنگل ملی ریوگراند|ریوگراند]]
*[[جنگل ملی آراپاهو و روزولت|آراپاهو و روزولت]]
*[[جنگل ملی مدیسین بو-راوت|مدیسین بو-راوت]]
*[[جنگل ملی سن ایزابل|سن ایزابل]]
*[[جنگل ملی سن خوان|سن خوان]]
*[[Uncompahgre National Forest|Uncompahgre]]
*[[جنگل ملی وایت ریور|وایت ریور]]
}}

جستارهای وابسته[ویرایش مبدأ]

{{Navbox}} – Basic navbox
{{Navbox with columns}} – Allows columns instead of groups/lists
{{Navbox with collapsible groups}} – Another variation.
~~Wikipedia:Line-break handling – The how-to guide about how to handle word wraps (line breaks) on Wikipedia, such as the wrapping of the link lists used in navboxes.~~ Deprecated; use the hlist class.
~~{{Nowrap begin}} – The recommended format for adding bullets, pipes, or dashes between list items.~~ Deprecated; use the hlist class.
{{Nobold}} – To display text at normal font-weight within a context where the default font-weight is bold, e.g. header cells in tables.

مقایسهٔ الگوهای ناوبری
نمایش بحث ویرایش	تاشو	رنگ عنوان	تصویر	گروه‌ها	سبک (بدنه) پارامتر(ها)	نمونه‌ها
{{Navbox}}	تاشو	نوباکس	چپ/راست بدنه	بله	بله	{{Solar System}} {{Governance of Greater London}}
{{Navbox with collapsible groups}}	تاشو	نوباکس	چپ/راست بدنه و/یا در هر فهرست	بله	بله	{{Scouting}} {{University of Michigan}}
{{Navbox with columns}}	تاشو	نوباکس	چپ/راست ستون‌ها	خیر	بله	{{Current U.S. Senators}} {{Historical regions of the Czech Republic}}

خصوصیت‌های تاشو
گونه	کلاس‌های سی‌اس‌اس	جاوااسکریپت	تامی‌شود هنگامی که	سفارشی حالت ابتدایی	تودرتو
جدول‌های تاشو	تاشو	تعریف‌شده در Common.js	دو یا بیشتر خودکارتاشو در صفحه	بله	بله