Каждое его изменение создаёт дополнительную нагрузку на сервера проекта. Пожалуйста, убедитесь в адекватности и правильности ваших изменений, проверьте их на тестовых страницах. Узнать число включений.
Этот шаблон реализован на основе Lua с использованием функции navbox() из модуля Navbox.
Заготовка ниже предназначена для копирования в новые шаблоны для облегчения их оформления:
{{Навигационная таблица
| имя = {{подст:PAGENAME}}{{подст:пустой шаблон|Не меняйте ничего на этой строке. Она изменится сама при сохранении.}}
| заголовок =
| state = {{{state|}}}
| класс_списков = hlist hlist-items-nowrap
| вверху =
| группа1 =
| список1 =
| группа2 =
| список2 =
<!-- ... -->
| группа23 =
| список23 =
| внизу =
}}<noinclude>
{{doc-inline}}
{{Навигационная таблица/TemplateData}}
{{doc-end}}
[[Категория:Навигационные шаблоны]]
</noinclude>
Параметры
Для удобства шаблон {{Навигационная таблица}} имеет одинаковые названия параметров с дочерними шаблонами {{Навигационная таблица с колонками}} и {{Навигационная таблица с блоками}}. Параметры, помеченные звёздочкой (*), являются общими для всех трёх шаблонов.
{{{title}}}{{{заголовок}}}
{{{above}}}{{{вверху}}}
{{{group1}}}{{{группа1}}}
{{{list1}}}{{{список1}}}
{{{group2}}}{{{группа2}}}
{{{list2}}}{{{список2}}}
{{{list3}}}{{{список3}}} без заголовка 3 ({{{group3}}}{{{группа3}}})
{{{group4}}}{{{группа4}}}
{{{list4}}}{{{список4}}}
{{{below}}}{{{внизу}}}
Основные
Список параметров
Английское название
Русское название
|name =
|имя =
|title =
|заголовок =
|navbar =
|ссылка_на_просмотр =
|border =
—
|state =
—
|navigation =
|навигация =
|above =
|вверху =
|image =
|изображение =
|imageleft =
|изображение_слева =
|groupn =
|группаn =
|listn =
|списокn =
|below =
|внизу =
|bodystyle =
|стиль_тела =
|basestyle =
|стиль =
|titlestyle =
|стиль_заголовка =
|groupstyle =
|стиль_групп =
|groupnstyle =
|стиль_группыn =
|groupwidth =
|ширина_групп =
|liststyle =
|стиль_списков =
|listnstyle =
|стиль_спискаn =
|listpadding =
|отступ_списков =
|abovestyle =
|стиль_вверху =
|belowstyle =
|стиль_внизу =
|imagestyle =
|стиль_изображения =
|imageleftstyle =
|стиль_изображения_слева =
|bodyclass =
|класс_тела =
|titleclass =
|класс_заголовка =
|imageclass =
|класс_изображения =
|groupclass =
|класс_групп =
|listclass =
|класс_списков =
|aboveclass =
|класс_вверху =
|belowclass =
|класс_внизу =
|titlegroup =
—
|titlegroupstyle =
—
|innerstyle =
—
имя*
name*
Имя шаблона, необходимое для ссылки (переход к шаблону) на всех страницах, где используется шаблон. Для простоты можно использовать {{подст:PAGENAME}}. Если указан параметр |ссылка_на_просмотр = plain, то этот параметр не используется.
autocollapse — значение по умолчанию, если |state = пустой или отсутствует;
collapsed — при данном значении таблица всегда будет свернута;
uncollapsed — при данном значении таблица всегда будет развернута;
plain — при данном значении таблица всегда будет развернута и будут убраны ссылки [показать] / [скрыть] справа. Заголовок будет отцентрирован относительно всей ячейки, игнорируя размеры «шестеренки»;
off — при данном значении таблица всегда будет развернута и будут убраны ссылки [показать] / [скрыть] справа. Заголовок не будет отцентрирован относительно всей ячейки, игнорируя размеры «шестеренки». Предпочтительно использовать plain вместо off. Используйте данный параметр, только если знаете что делаете.
Навигационная таблица с параметром autocollapse будет появляться в скрытом состоянии, если на странице есть две или более навигационных таблицы с CSS-классом collapsible (технические детали см. в MediaWiki:Common.js).
Иногда требуется навигационный шаблон с состоянием по умолчанию, которое можно переопределить в статье. Для этого в навигационном шаблоне используйте параметр |state =, просто передающий значение базовому шаблону (вместо состояние по умолчанию нужно подставить необходимое значение — например, autocollapse):
| state = <includeonly>{{{state|состояние по умолчанию}}}</includeonly>
(теги <includeonly> нужны для того, чтобы при просмотре шаблона на его странице он всегда оставался в раскрытом состоянии). Соответственно, при использовании такого навигационного шаблона можно указывать его состояние, например:
{{Наш навигационный шаблон|state=collapsed}}
навигация [да, нет]
navigation
Включает динамическую навигацию для ссылок на другие шаблоны.
нет — при данном значении полностью отключается навигация между ссылками, даже теми, что отмечены шаблоном {{nn}};
ссылка_на_просмотр*
navbar*
Значение по умолчанию — показывать ссылку (или — цвет подбирается автоматически в зависимости от цвета фона) для перехода к шаблону, указанному в параметре |имя =. Если указано значение plain, либо параметр |имя = пустой или не задан, ссылка в левой части заголовка показана не будет и заголовок будет отцентрирован относительно всей ячейки. Если указано значение off, то центрирование не будет включать в себя размер ссылок [показать] / [скрыть].
border*
Если значение установлено как child или subgroup, то навигационная таблица может быть использована в качестве дочернего элемента, который плотно прилегает в другой навигационной таблице. Граница будет скрыта и исчезнет внешнее расстояние между таблицами, так что она вписывалась в список (|list =) родительской навигационной таблицы. Если установлено значение none, то граница также будет скрыта и исчезнет внешнее расстояние (padding), а навигационная таблица сможет быть использована в качестве дочернего элемента другого контейнера (не используйте это значение если собираетесь использовать навигационную таблицу внутри навигационной таблицы, используйте только child или subgroup). Если установлено любое другое значение, то обычная навигационная таблица отображается с границей в 1px. Альтернативный способ указать границу чтобы задать стиль подгруппы, это использовать первый неименованный параметр вместо |border =:
{{Навигационный шаблон|child
...
}}
Ячейки
заголовок*
title*
Текст, отображаемый в верхней строке таблицы. Обычно это тема шаблона, краткое описание его содержания.
вверху
above
Ячейка во всю ширину таблицы, располагающаяся непосредственно под основным заголовком (над заголовками/списками тела шаблона). В шаблоне без параметра |изображение = задание параметра |вверху = аналогично заданию параметра |список1 = без |заголовок1 =, но при этом список из параметра |вверху = по умолчанию будет отцентрирован.
группаn
groupn
(группа1, группа2, ..., группа23) Если этот параметр указан, слева от соответствующего |списокn = будет отображён заданный текст. Если параметр не указан, |списокn = займёт всю ширину таблицы.
списокn
listn
(список1, список2, ..., список23) Тело шаблона; как правило, набор ссылок. Каждый список отображается в отдельной строке таблицы. Каждый |списокn = может быть сопровождён параметром |группаn = (см. выше). Если параметр |класс_списков = (или |класс_тела =) содержит значение hlist, каждый элемент списка должен начинаться с новой строки и использовать астериск (*). Если в строка будет начинаться с двух и более астерисков (**), то элементы начнут оборачиваться в скобки, как дочерние для основного. Пример:
| список1 =
* 1
* 2
** 3
* 4
даст результат: 1 · 2 (3) · 4.
Также можно использовать мини-группы, чтобы их заголовки выделялись жирным. С этой целью следует использовать ; перед заголовком мини-группы и : перед каждым из элементов. Пример:
| список1 =
; Заголовок
: 1
: 2
:* 3
: 4
даст результат:
Заголовок
1
2
3
4
Если не используется класс hlist, элементы списка должны быть указаны на одной строке, но, заключив их в <div></div>, можно использовать перенос строки.
изображение
image
Изображение, которое будет показано под основным заголовком в правой части таблицы (правее заголовков/списков). Для того, чтобы изображение отображалось, должен быть хоть один |список = либо |группа =. Параметр |изображение = допускает стандартный викикод для отображения, то есть
| изображение = [[Файл:Пример.jpg|100px]]
В шаблоне, не растянутом на всю ширину страницы, изображение будет показано со сдвигом от правого края шаблона. Для того, чтобы этого избежать, используйте параметр right в викикоде, то есть
| изображение = [[Файл:Пример.jpg|80px|right]]
изображение_слева
imageleft
Аналогично стандартному изображению, но которое будет показано под основным заголовком в левой части таблицы (левее заголовков/списков). Для того, чтобы изображение отображалось, должен быть хоть один |список = либо |группа =.
внизу
below
Ячейка во всю ширину таблицы, располагающаяся внизу тела шаблона (под заголовками/списками и изображением). В шаблоне без параметра |изображение = задание параметра |внизу = аналогично заданию последнего параметра |списокn = без |группаn =, но при этом список из параметра |внизу = по умолчанию будет отцентрирован.
Внимание! Значения стилей таблиц по умолчанию в Википедии в настоящее время заданы с помощью MediaWiki:Common.css.
Так как разделение строк происходит через CSS-свойство border-top, то возможны сложности с созданием границ ячеек. Проблему могут помочь решить CSS-тени или шаблон {{Box-shadow border}}.
стиль_тела
bodystyle
Стили для тела (фона) шаблона. Примеры аргументов этих параметров:
background: #nnnnnn;
text-align: [right/center/left/justified]
width: N[em/%/px or width: auto]
float: [left/right/none]
clear: [right/left/both/none]
style
Аналог |bodystyle =, используемый в английском разделе Википедии для совместимости со старыми шаблонами. Рекомендуется заменять его на |bodystyle = или |стиль_тела =.Обратите внимание: параметры |style = и |стиль = имеют разное назначение, |стиль = описан ниже.
стиль
basestyle
Задает общий стиль для |вверху =, |внизу =, |заголовок = и |группаn =, не затрагивая ячейки списков.
background: #nnnnnn;
стиль_заголовка
titlestyle
Стили для параметра |заголовок =. Как правило, цвет фона:
| стиль_заголовка = background: #nnnnnn;
| стиль_заголовка = background: name;
Цвет фона по умолчанию — #cfe3ff.
стиль_групп
groupstyle
Стили для всех параметров |группаn =. Этот параметр имеет более высокий приоритет, нежели |стиль =. Примеры аргументов этого параметра:
background: #nnnnnn;
text-align: [left/center/right];
vertical-align: [top/middle/bottom];
white-space: nowrap;
Цвет фона по умолчанию — #dcebff. Как можно видеть, этот цвет чуть светлее стандартного цвета фона заголовка шаблона. Если вы подбираете цвет фона по тому же принципу, отталкиваясь от другого цвета фона заголовка, вы можете воспользоваться инструментом подбора цвета на базе HSL-шкалы, сдвинув значение третьего параметра (светлоты) на треть ближе к 100 (например, 85 → 90; пример инструмента).
стиль_группыn
groupnstyle
Стиль для одного из заголовков групп. Переписывает параметр |groupstyle =. Пример:
| group2style = background: red; color: white;
ширина_групп
groupwidth
Параметр используется для упрощения работы с шириной заголовков групп, когда меньшие заголовки имеют меньшую ширину. Особенно полезно при использовании дочерних шаблонов. Пример:
| groupwidth = 10em
стиль_списков
liststyle
Стили для всех параметров |списокn =. Этот параметр имеет более высокий приоритет, нежели |стиль =.
Цвета фона списка (и всей таблицы) по умолчанию — #f9f9f9.
стиль_спискаn
listnstyle
Стиль для одного из списков. Переписывает параметр |liststyle =. Пример:
| list2style = background: red; color: white;
отступ_списков
listpadding
Задает значение внутренних отступов для всех списков, по умолчанию этот параметр равен 0em — сверху и снизу, 0.25em — справа и слева.
| listpadding = 0.5em 0 — задаст отступы 0.5em — сверху и снизу, 0em — справа и слева.
| listpadding = 0 — уберёт все отступы в ячейках списков.
чётные_нечётные [swap, even, odd, off]
evenodd
Если задано значение swap, то автоматическое чередование чётных и нечётных строк станет обратным. Обычно, если чётным строкам задан светло-серый фон, то при использовании этого параметра нечётные строки получат серый фон вместо чётных строк. Значения even и odd заставит все строки стать чётными или нечётными. off отключает автоматическое чередование строк. Этот дополнительный параметр следует использовать только для устранения проблем, когда навигационная таблица используется как дочерний элемент другой навигационной таблицы и строки не совпадают. Примеры и дальнейшее описание можно найти в разделе, посвященном дочерним шаблонам.
стиль_вверху
abovestyle
стиль_внизу
belowstyle
Стили для параметров |вверху = и |внизу =, соответственно. Обычно используются для задания цвета фона и выравнивания текста:
background: #nnnnnn;
text-align: [left/center/right];
стиль_изображения
imagestyle
стиль_изображения_слева
imageleftstyle
Задает стиль ячеек для изображений. Может быть использован, если ширина ячейки, в которой находится изображение, слишком большая.
стиль_изображения = width: 5em;
Классы
класс_тела
bodyclass
класс_групп
groupclass
класс_списков
listclass
класс_вверху
aboveclass
класс_внизу
belowclass
Задают CSS-класс для элементов шаблона. Обычно используется hlist в |класс_списков = для горизонтальных списков. Каждый из параметров может принимать значение hlist, но если в шаблоне вы используете более одного параметра с hlist, то лучше использовать |bodyclass = для всего шаблона. Также можно использовать класс hlist-items-nowrap, чтобы запретить перенос строки внутри элементов (ссылки не переносятся в любом случае), но это создаёт проблемы в IE9 и ниже (ими можно будет пренебречь, когда доля их использования станет очень малой).
Раньше шаблоны использовали разделители вроде {{•}}, {{·}} вместо списков с астериском. Чтобы автоматически преобразовать код шаблона из старого формата в новый, вы можете воспользоваться следующим букмарклетом (запускается из панели закладок):
Существует возможность разместить несколько навигационных таблиц в одной, при этом внешние рамки будут убраны. Для этого необходимо использовать параметр |border = или просто первый параметр со значением child. Как пример, в следующем коде дополнительная навигационная таблица добавляется в первый список:
Данный пример показывает как могут создаваться подгруппы. Рекомендуется использовать {{Подгруппы навигационной таблицы}}, но похожего результата можно добиться и с помощью {{Навигационная таблица}} с использованием параметра |border = или первого параметра со значением child. В данном примере использованы оба способа создания подгрупп. Параметр |evenodd = позволяет сменить чередование цвета строк, для создания правильной последовательности, а для того чтобы в подгруппах совсем убрать чередование и использовать цвет основного списка, необходимо добавить строку liststyle = background: transparent; в каждую подгруппу.
Приведенный ниже пример создан с помощью обычной Навигационной таблицы в качестве основного контейнера, а то его каждый список |list1 =, |list2 = и |list3 = содержит еще одну Навигационную таблицу с первым параметром child. Шестеренка у каждой внутренней таблицы убрана с помощью заданного параметра navbar — |navbar = plain. Но в данном примере, так как у внутренних Навигационных таблиц не задан параметр |имя = шестеренка не будет отображаться даже если параметра |navbar = не будет.
Заголовок
Заголовок первого блока
Группа 1
Список 1
Список 1
Список 1
Группа 2
Список 2
Список 2
Список 2
Группа 3
Список 3
Список 3
Список 3
Группа 4
Список 4
Список 4
Список 4
Заголовок второго блока
Список 1.2
Список 2.2
Список 2.2
Внизу
Заголовок третьего блока
Группа 1
Список 1
Список 1
Список 1
Группа 2
Список 2
Список 2
Список 2
Группа 3
Список 3
Список 3
Список 3
Группа 4
Список 4
Список 4
Список 4
Внизу 2
Оригинальный текст (рус.)
{{Навигационная таблица
| name = Навигационная таблица/doc
| title = Заголовок
| state = uncollapsed
| list1 = {{Навигационная таблица|child
| navbar = plain
| title = Заголовок первого блока
| listclass = hlist
| group1 = Группа 1
| list1 =
* Список 1
* Список 1
* Список 1
| group2 = Группа 2
| list2 =
* Список 2
* Список 2
* Список 2
| group3 = Группа 3
| list3 =
* Список 3
* Список 3
* Список 3
| group4 = Группа 4
| list4 =
* Список 4
* Список 4
* Список 4
}}
| list2 = {{Навигационная таблица|child
| navbar = plain
| title = Заголовок второго блока
| listclass = hlist
| list1 =
* Список 1.2
| list2 =
* Список 2.2
* Список 2.2
| below = Внизу
}}
| list3 = {{Навигационная таблица|child
| navbar = plain
| title = Заголовок третьего блока
| listclass = hlist
| group1 = Группа 1
| list1 =
* Список 1
* Список 1
* Список 1
| group2 = Группа 2
| list2 =
* Список 2
* Список 2
* Список 2
| group3 = Группа 3
| list3 =
* Список 3
** Список 3
* Список 3
| group4 = Группа 4
| list4 =
* Список 4
** Список 4
** Список 4
| below = Внизу 2
}}
}}
Взаимодействие с другими шаблонами
Данный шаблон разработан специально для работы в сочетании с двумя другими родственными шаблонами: {{Навигационная таблица с колонками}} и {{Навигационная таблица с блоками}}. Все три эти шаблона имеют одинаковые параметры для простоты использования (такие параметры отмечены звездочкой (*) в списке описания параметров). Самое главное, что каждый шаблон может быть использован в качестве дочернего друг для друга (с помощью |border = child, либо указав значение первого неименованного параметра равное child, например: {{Навигационная таблица|child ...}}, {{Навигационная таблица с колонками|child ...}} or {{Навигационная таблица с блоками|child ...}}).
Шаблон использует блочное форматирование параметров.
Параметр
Описание
Тип
Статус
имя
имяname
Название шаблона. Используется для ссылок на шаблон.
Автозначение
{{подст:PAGENAME}}
Неизвестно
необязательный
заголовок
заголовокtitle
Текст, отображаемый в верхней строке таблицы. Обычно это тема шаблона, краткое описание его содержания.
Автозначение
Неизвестно
необязательный
изображение
изображениеimage
изображение справа
Пример
[[Файл:Flag of Malaysia.svg|120px]]
Неизвестно
необязательный
изображение слева
изображение_слеваimageleftизображение2
изображение вставляется слева до заголовков
Пример
[[Файл:Flag of Malaysia.svg|120px]]
Неизвестно
необязательный
ссылка_на_просмотр
ссылка_на_просмотрnavbar
Показывать ссылку «Просмотр этого шаблона» для перехода к шаблону, указанному в параметре «имя». Если указано значение plain, либо параметр «имя» пустой или не задан, ссылка в левой части заголовка показана не будет.
Неизвестно
необязательный
border
border
без описания
Неизвестно
необязательный
state
state
По умолчанию (если параметр отсутствует или с пустым значением) — autocollapse. Навигационная таблица с этим параметром будет появляться в скрытом состоянии, если на странице есть две или более навигационных таблицы с CSS-классом collapsible. Если указано значение collapsed, навигационная таблица всегда будет появляться в свёрнутом состоянии. Также возможны значения plain и off (см. документацию). Для значения uncollapsed и любого другого навигационная таблица всегда будет появляться в раскрытом состоянии.
Предлагаемые значения
autocollapsecollapseduncollapsedplainoff
По умолчанию
autocollapse
Неизвестно
необязательный
навигация
навигацияnavigation
По умолчанию (если параметр отсутствует или с пустым значением) — «да» для основного пространства имён. Если указано значение «нет», полностью отключается навигация между ссылками.
Неизвестно
необязательный
стиль_тела
стиль_телаbodystyle
Дополняет и/или перекрывает значения из параметра стиль.
Стили для всех параметров заголовокN. Этот параметр имеет более высокий приоритет, нежели стиль. Как правило, цвет фона
По умолчанию
background: #cfe3ff
Пример
background: #cccccc
Неизвестно
необязательный
стиль_списков
стиль_списковliststyle
без описания
Неизвестно
необязательный
стиль_изображения
стиль_изображенияimagestyle
стиль для блока в который заключено изображение, CSS
Неизвестно
необязательный
стиль_изображения_слева
стиль_изображения_слеваimageleftstyleimagestyle2
без описания
Неизвестно
необязательный
стиль_вверху
стиль_вверхуabovestyle
без описания
Неизвестно
необязательный
вверху
вверхуabove
Ячейка во всю ширину таблицы, располагающаяся непосредственно под основным заголовком (над заголовками/списками тела шаблона). Список из этого параметра по умолчанию будет отцентрирован.
Неизвестно
необязательный
группа1
группа1group1заголовок1
Заголовок группыN для спискаN
Неизвестно
необязательный
список1
список1list1
Тело шаблона; как правило, набор ссылок. Элементы списка должны быть указаны на одной строке, но, заключив их в <div></div>, можно использовать перенос строки (см. ниже). Каждый список отображается в отдельной строке таблицы.
Неизвестно
необязательный
группа2
группа2group2заголовок2
без описания
Неизвестно
необязательный
список2
список2list2
без описания
Неизвестно
необязательный
группа3
группа3group3заголовок3
без описания
Неизвестно
необязательный
список3
список3list3
без описания
Неизвестно
необязательный
группа4
группа4group4заголовок4
без описания
Неизвестно
необязательный
список4
список4list4
без описания
Неизвестно
необязательный
группа5
группа5group5заголовок5
без описания
Неизвестно
необязательный
список5
список5list5
без описания
Неизвестно
необязательный
группа6
группа6group6заголовок6
без описания
Неизвестно
необязательный
список6
список6list6
без описания
Неизвестно
необязательный
группа7
группа7group7заголовок7
без описания
Неизвестно
необязательный
список7
список7list7
без описания
Неизвестно
необязательный
группа8
группа8group8заголовок8
без описания
Неизвестно
необязательный
список8
список8list8
без описания
Неизвестно
необязательный
группа9
группа9group9заголовок9
без описания
Неизвестно
необязательный
список9
список9list9
без описания
Неизвестно
необязательный
группа10
группа10group10заголовок10
без описания
Неизвестно
необязательный
список10
список10list10
без описания
Неизвестно
необязательный
группа11
группа11group11заголовок11
без описания
Неизвестно
необязательный
список11
список11list11
без описания
Неизвестно
необязательный
группа12
группа12group12заголовок12
без описания
Неизвестно
необязательный
список12
список12list12
без описания
Неизвестно
необязательный
группа13
группа13group13заголовок13
без описания
Неизвестно
необязательный
список13
список13list13
без описания
Неизвестно
необязательный
группа14
группа14group14заголовок14
без описания
Неизвестно
необязательный
список14
список14list14
без описания
Неизвестно
необязательный
группа15
группа15group15заголовок15
без описания
Неизвестно
необязательный
список15
список15list15
без описания
Неизвестно
необязательный
группа16
группа16group16заголовок16
без описания
Неизвестно
необязательный
список16
список16list16
без описания
Неизвестно
необязательный
группа17
группа17group17заголовок17
без описания
Неизвестно
необязательный
список17
список17list17
без описания
Неизвестно
необязательный
группа18
группа18group18заголовок18
без описания
Неизвестно
необязательный
список18
список18list18
без описания
Неизвестно
необязательный
группа19
группа19group19заголовок19
без описания
Неизвестно
необязательный
список19
список19list19
без описания
Неизвестно
необязательный
группа20
группа20group20заголовок20
без описания
Неизвестно
необязательный
список20
список20list20
без описания
Неизвестно
необязательный
группа21
группа21group21заголовок21
без описания
Неизвестно
необязательный
список21
список21list21
без описания
Неизвестно
необязательный
группа22
группа22group22заголовок22
без описания
Неизвестно
необязательный
список22
список22list22
без описания
Неизвестно
необязательный
группа23
группа23group23заголовок23
без описания
Неизвестно
необязательный
список23
список23list23
без описания
Неизвестно
необязательный
стиль_внизу
стиль_внизуbelowstyle
без описания
Неизвестно
необязательный
внизу
внизуbelow
Ячейка во всю ширину таблицы, располагающаяся внизу тела шаблона (под заголовками/списками и изображением). Список из этого параметра по умолчанию будет отцентрирован.