Редактирование: Шаблон:Навигационная таблица/doc (раздел)

== Параметры ==
Для удобства шаблон {{T|Навигационная таблица}} имеет одинаковые названия параметров с дочерними шаблонами {{Tl|Навигационная таблица с колонками}} и {{Tl|Навигационная таблица с блоками}}. Параметры, помеченные звёздочкой {{Символ|*}}, являются общими для всех трёх шаблонов.

{{Навигационная таблица
| имя                     = Навигационная таблица
| state                   = uncollapsed
| класс_списков           = hlist
| заголовок               = {{{title}}}{{{заголовок}}}
| изображение             = 

| вверху        = {{{above}}}{{{вверху}}}

| группа1       = {{{group1}}}{{{группа1}}}
| список1       = {{{list1}}}{{{список1}}}

| группа2       = {{{group2}}}{{{группа2}}}
| список2       = {{{list2}}}{{{список2}}}

| список3       = {{{list3}}}{{{список3}}} без заголовка 3 ({{{group3}}}{{{группа3}}})

| группа4       = {{{group4}}}{{{группа4}}}
| список4       = {{{list4}}}{{{список4}}}

| внизу         = {{{below}}}{{{внизу}}}
}}

=== Основные ===
{| class="wikitable" style="float:right; margin-left:1em;"
! colspan="2" | Список параметров
|-
! Английское название
! Русское название
|-
| {{Para|name}}
| {{Para|имя}}
|-
| {{Para|title}}
| {{Para|заголовок}}
|-
| {{Para|navbar}}
| {{Para|ссылка_на_просмотр}}
|-
| {{Para|border}}
|—
|-
| {{Para|state}}
|—
|-
| {{Para|navigation}}
| {{Para|навигация}}
|-
| {{Para|above}}
| {{Para|вверху}}
|-
| {{Para|image}}
| {{Para|изображение}}
|-
| {{Para|imageleft}}
| {{Para|изображение_слева}}
|-
| {{Para|group<sub>n</sub>}}
| {{Para|группа<sub>n</sub>}}
|-
| {{Para|list<sub>n</sub>}}
| {{Para|список<sub>n</sub>}}
|-
| {{Para|below}}
| {{Para|внизу}}
|-
| {{Para|bodystyle}}
| {{Para|стиль_тела}}
|-
| {{Para|basestyle}}
| {{Para|стиль}}
|-
| {{Para|titlestyle}}
| {{Para|стиль_заголовка}}
|-
| {{Para|groupstyle}}
| {{Para|стиль_групп}}
|-
| {{Para|group<sub>n</sub>style}}
| {{Para|стиль_группы<sub>n</sub>}}
|-
| {{Para|groupwidth}}
| {{Para|ширина_групп}}
|-
| {{Para|liststyle}}
| {{Para|стиль_списков}}
|-
| {{Para|list<sub>n</sub>style}}
| {{Para|стиль_списка<sub>n</sub>}}
|-
| {{Para|listpadding}}
| {{Para|отступ_списков}}
|-
| {{Para|abovestyle}}
| {{Para|стиль_вверху}}
|-
| {{Para|belowstyle}}
| {{Para|стиль_внизу}}
|-
| {{Para|imagestyle}}
| {{Para|стиль_изображения}}
|-
| {{Para|imageleftstyle}}
| {{Para|стиль_изображения_слева}}
|-
| {{Para|bodyclass}}
| {{Para|класс_тела}}
|-
| {{Para|titleclass}}
| {{Para|класс_заголовка}}
|-
| {{Para|imageclass}}
| {{Para|класс_изображения}}
|-
| {{Para|groupclass}}
| {{Para|класс_групп}}
|-
| {{Para|listclass}}
| {{Para|класс_списков}}
|-
| {{Para|aboveclass}}
| {{Para|класс_вверху}}
|-
| {{Para|belowclass}}
| {{Para|класс_внизу}}
|-
| {{Para|titlegroup}}
|—
|-
| {{Para|titlegroupstyle}}
|—
|-
| {{Para|innerstyle}}
|—
|}
; имя*
; name*
: Имя шаблона, необходимое для ссылки [[File:WMF-Agora-Settings 424242.svg|14px|Просмотр этого шаблона|link=Шаблон:Навигационная таблица]] (переход к шаблону) на всех страницах, где используется шаблон. Для простоты можно использовать {{Tc|подст:PAGENAME}}. Если указан параметр {{Para|ссылка_на_просмотр|plain}}, то этот параметр не используется.

; state* <span style="font-weight:normal;">[<code>autocollapse, collapsed, uncollapsed, plain, off</code>]</span>
:: <code>autocollapse</code> — значение по умолчанию, если {{Para|state}} пустой или отсутствует;
:: <code>collapsed</code> — при данном значении таблица всегда будет свернута;
:: <code>uncollapsed</code> — при данном значении таблица всегда будет развернута;
:: <code>plain</code> — при данном значении таблица всегда будет развернута и будут убраны ссылки [показать]{{Sp/}}[скрыть] справа. Заголовок будет отцентрирован относительно всей ячейки, игнорируя размеры «шестеренки»;
:: <code>off</code> — при данном значении таблица всегда будет развернута и будут убраны ссылки [показать]{{Sp/}}[скрыть] справа. Заголовок не будет отцентрирован относительно всей ячейки, игнорируя размеры «шестеренки». Предпочтительно использовать <code>plain</code> вместо <code>off</code>. Используйте данный параметр, только если знаете что делаете.
: Навигационная таблица с параметром <code>autocollapse</code> будет появляться в скрытом состоянии, если на странице есть две или более навигационных таблицы с CSS-классом <code>collapsible</code> (технические детали см. в [[MediaWiki:Common.js]]).
: Иногда требуется навигационный шаблон с состоянием по умолчанию, которое можно переопределить в статье. Для этого в навигационном шаблоне используйте параметр {{Para|state}}, просто передающий значение базовому шаблону (вместо ''состояние по умолчанию'' нужно подставить необходимое значение — например, <code>autocollapse</code>):
:: <code><nowiki>| state = &lt;includeonly&gt;{{{state|</nowiki>''состояние по умолчанию''<nowiki>}}}&lt;/includeonly&gt;</nowiki></code>
: (теги {{Tago|includeonly}} нужны для того, чтобы при просмотре шаблона на его странице он всегда оставался в раскрытом состоянии). Соответственно, при использовании такого навигационного шаблона можно указывать его состояние, например:
:: {{Tc|''Наш навигационный шаблон''|state=collapsed}}

; навигация <span style="font-weight:normal;">[<code>да, нет</code>]</span>
; navigation
: Включает [[AJAX|динамическую]] навигацию для ссылок на другие шаблоны.
:: <code>да</code> — значение по умолчанию для [[ВП:ПРИ|основного пространства]];
:: <code>нет</code> — при данном значении полностью отключается навигация между ссылками, даже теми, что отмечены шаблоном {{Tl|nn}};

; ссылка_на_просмотр*
; navbar*
: Значение по умолчанию — показывать ссылку [[Файл:Wikipedia interwiki section gear icon.svg|14px|Просмотр этого шаблона|link=Шаблон:Навигационная таблица]] (или [[Файл:Wikipedia interwiki section gear icon white.svg|14px|Просмотр этого шаблона|link=Шаблон:Навигационная таблица]] — цвет подбирается автоматически в зависимости от цвета фона) для перехода к шаблону, указанному в параметре {{Para|имя}}. Если указано значение <code>plain</code>, либо параметр {{Para|имя}} пустой или не задан, ссылка в левой части заголовка показана не будет и заголовок будет отцентрирован относительно всей ячейки. Если указано значение <code>off</code>, то центрирование не будет включать в себя размер ссылок [показать]{{Sp/}}[скрыть].

; border*
: Если значение установлено как <code>child</code> или <code>subgroup</code>, то навигационная таблица может быть использована в качестве дочернего элемента, который плотно прилегает в другой навигационной таблице. Граница будет скрыта и исчезнет внешнее расстояние между таблицами, так что она вписывалась в список ({{Para|list}}) родительской навигационной таблицы. Если установлено значение <code>none</code>, то граница также будет скрыта и исчезнет внешнее расстояние (<code>padding</code>), а навигационная таблица сможет быть использована в качестве дочернего элемента другого контейнера (не используйте это значение если собираетесь использовать навигационную таблицу внутри навигационной таблицы, используйте только <code>child</code> или <code>subgroup</code>). Если установлено любое другое значение, то обычная навигационная таблица отображается с границей в 1px. Альтернативный способ указать границу чтобы задать стиль подгруппы, это использовать первый неименованный параметр вместо {{Para|border}}:
:: {{Pre|<nowiki>{{Навигационный шаблон|child
...
}}</nowiki>}}

=== Ячейки ===
; заголовок*
; title*
: Текст, отображаемый в верхней строке таблицы. Обычно это тема шаблона, краткое описание его содержания.<!-- Это, как правило, одна строка, но если требуется отобразить текст в двух строках, используйте <code><nowiki>{{-}}</nowiki></code> для корректного центрирования. // сейчас вторая строка центрируется нормально — AVB -->

; вверху
; above
: Ячейка во всю ширину таблицы, располагающаяся непосредственно под основным заголовком (над заголовками/списками тела шаблона). В шаблоне без параметра {{Para|изображение}} задание параметра {{Para|вверху}} аналогично заданию параметра {{Para|список1}} без {{Para|заголовок1}}, но при этом список из параметра {{Para|вверху}} по умолчанию будет отцентрирован.

; группа<sub>n</sub>
; group<sub>n</sub>
: ''(группа1, группа2, ..., группа23)'' Если этот параметр указан, слева от соответствующего {{Para|список<sub>n</sub>}} будет отображён заданный текст. Если параметр не указан, {{Para|список<sub>n</sub>}} займёт всю ширину таблицы.

; список<sub>n</sub>
; list<sub>n</sub>
: ''(список1, список2, ..., список23)'' Тело шаблона; как правило, набор ссылок. Каждый список отображается в отдельной строке таблицы. Каждый {{Para|список<sub>n</sub>}} может быть сопровождён параметром {{Para|группа<sub>n</sub>}} (см. выше). {{Якорь|астериски}}Если параметр {{Para|класс_списков}} (или {{Para|класс_тела}}) содержит значение <code>hlist</code>, каждый элемент списка должен начинаться с новой строки и использовать [[астериск]] (<code>*</code>). Если в строка будет начинаться с двух и более астерисков (<code>**</code>), то элементы начнут оборачиваться в скобки, как дочерние для основного. Пример:
:: {{Pre|<nowiki>
| список1 =
* 1
* 2
** 3
* 4</nowiki>}}
: даст результат: <div class="hlist">
* 1
* 2 (3)
* 4.
</div>
: Также можно использовать мини-группы, чтобы их заголовки выделялись жирным. С этой целью следует использовать <code>;</code> перед заголовком мини-группы и <code>:</code> перед каждым из элементов. Пример:
:: {{Pre|<nowiki>
| список1 =
; Заголовок
: 1
: 2
:* 3
: 4</nowiki>}}
<dl><dd>даст результат: <div class="hlist inline">
; Заголовок
: 1
: 2
:* 3
: 4
</div></dd></dl>
: Если не используется класс <code>hlist</code>, элементы списка должны быть указаны на одной строке, но, заключив их в {{Tag|div}}, можно использовать перенос строки.

; изображение
; image
: Изображение, которое будет показано под основным заголовком в правой части таблицы (правее заголовков/списков). Для того, чтобы изображение отображалось, должен быть хоть один {{Para|список}} либо {{Para|группа}}. Параметр {{Para|изображение}} допускает стандартный викикод для отображения, то есть
:: <code><nowiki>| изображение = [[Файл:Пример.jpg|100px]]</nowiki></code>
: В шаблоне, не растянутом на всю ширину страницы, изображение будет показано со сдвигом от правого края шаблона. Для того, чтобы этого избежать, используйте параметр right в викикоде, то есть
:: <code><nowiki>| изображение = [[Файл:Пример.jpg|80px|right]]</nowiki></code>

; изображение_слева
; imageleft
: Аналогично стандартному изображению, но которое будет показано под основным заголовком в левой части таблицы (левее заголовков/списков). Для того, чтобы изображение отображалось, должен быть хоть один {{Para|список}} либо {{Para|группа}}.

; внизу
; below
: Ячейка во всю ширину таблицы, располагающаяся внизу тела шаблона (под заголовками/списками и изображением). В шаблоне без параметра {{Para|изображение}} задание параметра {{Para|внизу}} аналогично заданию последнего параметра {{Para|список<sub>n</sub>}} без {{Para|группа<sub>n</sub>}}, но при этом список из параметра {{Para|внизу}} по умолчанию будет отцентрирован.

=== Стили ===
В следующих параметрах указываются [[Каскадная таблица стилей|CSS]]-стили.

''Внимание! Значения стилей таблиц по умолчанию в Википедии в настоящее время заданы с помощью [https://ru.wikipedia.org/wiki/MediaWiki:Common.css MediaWiki:Common.css].''

Так как разделение строк происходит через CSS-свойство <code>border-top</code>, то возможны сложности с созданием границ ячеек. Проблему могут помочь решить CSS-тени или шаблоны {{Tl|Box-shadow}} и {{Tl|Box-shadow border}}.

; стиль_тела
; bodystyle
: Стили для тела (фона) шаблона. Примеры аргументов этих параметров:
:: <code>background: #''nnnnnn'';</code>
:: <code>text-align: [''right/center/left/justified'']</code>
:: <code>width: ''N''[em/%/px or width: auto]</code>
:: <code>float: [''left/right/none'']</code>
:: <code>clear: [''right/left/both/none'']</code>

; style
: Аналог {{Para|bodystyle}}, используемый в английском разделе Википедии для совместимости со старыми шаблонами. ''Рекомендуется заменять его на {{Para|bodystyle}} или {{Para|стиль_тела}}.'' '''Обратите внимание:''' параметры {{Para|style}} и {{Para|стиль}} имеют разное назначение, {{Para|стиль}} описан ниже.

; стиль
; basestyle 
: Задает общий стиль для {{Para|вверху}}, {{Para|внизу}}, {{Para|заголовок}} и {{Para|группа<sub>n</sub>}}, не затрагивая ячейки списков.
:: <code>background: #''nnnnnn'';</code>

; стиль_заголовка
; titlestyle
: Стили для параметра {{Para|заголовок}}. Как правило, цвет фона:
:: <code>| стиль_заголовка = background: ''#nnnnnn'';</code>
:: <code>| стиль_заголовка = background: ''name'';</code>
: Цвет фона по умолчанию — <code><span style="background: #cfe3ff;">#cfe3ff</span></code>.

; стиль_групп
; groupstyle 
: Стили для всех параметров {{Para|группа<sub>n</sub>}}. Этот параметр имеет более высокий приоритет, нежели {{Para|стиль}}. Примеры аргументов этого параметра:
:: <code>background: #''nnnnnn'';</code>
:: <code>text-align: [''left/center/right''];</code>
:: <code>vertical-align: [''top/middle/bottom''];</code>
:: <code>white-space: nowrap;</code>
: Цвет фона по умолчанию — <code><span style="background: #dcebff;">#dcebff</span></code>. Как можно видеть, этот цвет чуть светлее стандартного цвета фона заголовка шаблона. Если вы подбираете цвет фона по тому же принципу, отталкиваясь от другого цвета фона заголовка, вы можете воспользоваться инструментом подбора цвета на базе [[HSL|HSL-шкалы]], сдвинув значение третьего параметра (светлоты) на треть ближе к 100 (например, 85 → 90; [http://hslpicker.com/ пример инструмента]).

; стиль_группы<sub>n</sub>
; group<sub>n</sub>style
: Стиль для одного из заголовков групп. Переписывает параметр {{Para|groupstyle}}. Пример:
::<code>| group2style = background: red; color: white;</code>

; ширина_групп
; groupwidth
: Параметр используется для упрощения работы с шириной заголовков групп, когда меньшие заголовки имеют меньшую ширину. Особенно полезно при использовании дочерних шаблонов. Пример:
::<code>| groupwidth = 10em</code>

; стиль_списков
; liststyle
: Стили для всех параметров {{Para|список<sub>n</sub>}}. Этот параметр имеет более высокий приоритет, нежели {{Para|стиль}}.
: Цвета фона списка (и всей таблицы) по умолчанию — <code><span style="background: #f9f9f9;">#f9f9f9</span></code>.

; стиль_списка<sub>n</sub>
; list<sub>n</sub>style
: Стиль для одного из списков. Переписывает параметр {{Para|liststyle}}. Пример:
::<code>| list2style = background: red; color: white;</code>

; отступ_списков
; listpadding
: Задает значение внутренних отступов для всех списков, по умолчанию этот параметр равен 0em — сверху и снизу, 0.25em — справа и слева. 
::<code>| listpadding = 0.5em 0</code> — задаст отступы 0.5em — сверху и снизу, 0em — справа и слева.
::<code>| listpadding = 0</code> — уберёт все отступы в ячейках списков.

; чётные_нечётные <span style="font-weight: normal;">[<code>swap, even, odd, off</code>]</span>
; evenodd
: Если задано значение <code>swap</code>, то автоматическое чередование чётных и нечётных строк станет обратным. Обычно, если чётным строкам задан светло-серый фон, то при использовании этого параметра нечётные строки получат серый фон вместо чётных строк. Значения <code>even</code> и <code>odd</code> заставит все строки стать чётными или нечётными. <code>off</code> отключает автоматическое чередование строк. Этот дополнительный параметр следует использовать только для устранения проблем, когда навигационная таблица используется как дочерний элемент другой навигационной таблицы и строки не совпадают. Примеры и дальнейшее описание можно найти в разделе, посвященном дочерним шаблонам.

; стиль_вверху
; abovestyle
; стиль_внизу
; belowstyle
: Стили для параметров {{Para|вверху}} и {{Para|внизу}}, соответственно. Обычно используются для задания цвета фона и выравнивания текста:
:: <code>background: #''nnnnnn'';</code>
:: <code>text-align: [''left/center/right''];</code>

; стиль_изображения
; imagestyle
; стиль_изображения_слева
; imageleftstyle
: Задает стиль ячеек для изображений. Может быть использован, если ширина ячейки, в которой находится изображение, слишком большая.
:: <code>стиль_изображения = width: 5em;</code>

=== Классы ===
; класс_тела
; bodyclass
; класс_групп
; groupclass
; класс_списков
; listclass
; класс_вверху
; aboveclass
; класс_внизу
; belowclass
: Задают CSS-класс для элементов шаблона. Обычно используется <code>hlist</code> в {{Para|класс_списков}} для горизонтальных списков. Каждый из параметров может принимать значение <code>hlist</code>, но если в шаблоне вы используете более одного параметра с <code>hlist</code>, то лучше использовать {{Para|bodyclass}} для всего шаблона. Также можно использовать класс <code>hlist-items-nowrap</code>, чтобы запретить перенос строки внутри элементов (ссылки не переносятся в любом случае), но это создаёт проблемы в IE9 и ниже <small>(ими можно будет пренебречь, когда [http://www.liveinternet.ru/stat/ru/browsers.html?period=month&slice=desktop&id=49&id=50&id=55&id=54&show=перестроить+график&per_page=50&report=browsers.html%3Fslice%3Ddesktop;period%3Dmonth доля их использования] станет очень малой)</small>.