Шаблон:Навигационная таблица/doc: различия между версиями

Материал из Викимультии — энциклопедии мультипликации
Перейти к навигации Перейти к поиску
[непроверенная версия][отпатрулированная версия]
Нет описания правки
Нет описания правки
 
(не показана 1 промежуточная версия этого же участника)
Строка 5: Строка 5:
</includeonly>__NOTOC__
</includeonly>__NOTOC__
{{Навигационные шаблоны}}
{{Навигационные шаблоны}}
Данный шаблон позволяет быстро создавать [[Викимультия:Шаблоны/Навигационные|навигационные шаблоны]], указывая в качестве параметров списки ссылок.
Данный шаблон позволяет быстро создавать навигационные шаблоны, указывая в качестве параметров списки ссылок.


В правом верхнем углу находится кнопка [показать]{{sp/}}[скрыть]. Это реализовано с помощью [https://wikimultia.org/wiki/MediaWiki:Common.js MediaWiki:Common.js].
В правом верхнем углу находится кнопка [показать]{{sp/}}[скрыть]. Это реализовано с помощью [https://wikimultia.org/wiki/MediaWiki:Common.js MediaWiki:Common.js].
Строка 34: Строка 34:


| внизу        =  
| внизу        =  
}}<noinclude>
}}<noinclude>[[Категория:Навигационные шаблоны]]</noinclude>
{{Навигационная таблица/TemplateData}}
[[Категория:Навигационные шаблоны]]
</noinclude>
</pre>
</pre>


Строка 363: Строка 360:
;; класс_внизу =
;; класс_внизу =
: Задают 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>.
: Задают 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>.
: {{якорь|bookmarklet}} Раньше шаблоны использовали разделители вроде {{t|•}}, {{t|·}} вместо списков с астериском. Чтобы автоматически преобразовать код шаблона из старого формата в новый, вы можете воспользоваться следующим [[ВМ:Букмарклеты|букмарклетом]] (запускается из панели закладок) (код поддерживает Jack who built the house):<source lang="js" style="font-size:85%;">javascript:/* version 2.1 */ var classList = 'hlist'; var textboxContent = $('#wpTextbox1').val().replace(/<br ?\/>/g, '<br>'); var textboxNewContent = textboxContent.replace(/(\|\s*(?:список|list|содержание)\d*\s*=)([^]*?\n\s*)(?=\||\}\})/g, function(s, m1, m2) { var m2r = m2.replace(/\{\{(?:[nN]o(?:wrap|br)|[sS])\|([^•·\}]+?)\s*(?:•|(?:\'\'\')?·(?:\'\'\')?)\s*\}\}\s*/g, '$1\n* '); if (m2 !== m2r && classList.indexOf('hlist-items-nowrap') === -1) { classList += ' hlist-items-nowrap'; } m2r = m2r.replace(/\s*({\{[·•*т!](w(rap)?)?\}\}|·|•|&#124;)\s*/g, '\n* '); if (m2 !== m2r) { m2r = m2r.replace(/^(\s*)<div(?:[\w ]+?=[^<>]+| ?)>([^]*?)\n?<\/div>(\s*)$/, '$1$2$3'); m2r = m2r.replace(/^(\s*)\{\{[nN]owrap begin\}\}([^]*?)\n?\{\{[nN]owrap end\}\}(\s*)$/, '$1$2$3'); m2r = '\n* ' + m2r.replace(/^\s*/g, ''); m2r = m2r.replace(/\* \{\{(?:[nN]o(?:wrap|br)|[sS])\|([^\}]+?)\s*\}\}(\s*)$/, '* $1$2'); m2r = m2r.replace(/ *(\s*)$/, '$1'); } return m1 + m2r; }); if (!textboxNewContent.match(/[Нн]авигационная полоса/) && !textboxNewContent.match(/[^"']hlist[^"']/)) { if (textboxNewContent.indexOf('\n\n') !== -1) { textboxNewContent = textboxNewContent.replace(/^([^]*?)(\n\n)/, '$1\n|класс_списков = ' + classList + '$2'); } else { textboxNewContent = textboxNewContent.replace(/^([^]*\| *state *=[^\n]*\n)/, '$1|класс_списков = ' + classList + '\n'); } } $('#wpTextbox1').val(textboxNewContent); var summaryValue = $('#wpSummary').val(); if (!/hlist/.test(summaryValue)) { $('#wpSummary').val(summaryValue + (/[^,; \/]$/.test(summaryValue) ? ', ' : '') + 'перевод на hlist при помощи [[t:navbox#bookmarklet|букмарклета]]'); }</source>Этот букмарклет не преобразует элементы в скобках в [[#астериски|пункты списка второго уровня]] (<code>**</code>) — это нужно делать вручную.
: {{якорь|bookmarklet}} Раньше шаблоны использовали разделители вроде {{t|•}}, {{t|·}} вместо списков с астериском. Чтобы автоматически преобразовать код шаблона из старого формата в новый, вы можете воспользоваться следующим букмарклетом (запускается из панели закладок) (код поддерживает Jack who built the house):<source lang="js" style="font-size:85%;">javascript:/* version 2.1 */ var classList = 'hlist'; var textboxContent = $('#wpTextbox1').val().replace(/<br ?\/>/g, '<br>'); var textboxNewContent = textboxContent.replace(/(\|\s*(?:список|list|содержание)\d*\s*=)([^]*?\n\s*)(?=\||\}\})/g, function(s, m1, m2) { var m2r = m2.replace(/\{\{(?:[nN]o(?:wrap|br)|[sS])\|([^•·\}]+?)\s*(?:•|(?:\'\'\')?·(?:\'\'\')?)\s*\}\}\s*/g, '$1\n* '); if (m2 !== m2r && classList.indexOf('hlist-items-nowrap') === -1) { classList += ' hlist-items-nowrap'; } m2r = m2r.replace(/\s*({\{[·•*т!](w(rap)?)?\}\}|·|•|&#124;)\s*/g, '\n* '); if (m2 !== m2r) { m2r = m2r.replace(/^(\s*)<div(?:[\w ]+?=[^<>]+| ?)>([^]*?)\n?<\/div>(\s*)$/, '$1$2$3'); m2r = m2r.replace(/^(\s*)\{\{[nN]owrap begin\}\}([^]*?)\n?\{\{[nN]owrap end\}\}(\s*)$/, '$1$2$3'); m2r = '\n* ' + m2r.replace(/^\s*/g, ''); m2r = m2r.replace(/\* \{\{(?:[nN]o(?:wrap|br)|[sS])\|([^\}]+?)\s*\}\}(\s*)$/, '* $1$2'); m2r = m2r.replace(/ *(\s*)$/, '$1'); } return m1 + m2r; }); if (!textboxNewContent.match(/[Нн]авигационная полоса/) && !textboxNewContent.match(/[^"']hlist[^"']/)) { if (textboxNewContent.indexOf('\n\n') !== -1) { textboxNewContent = textboxNewContent.replace(/^([^]*?)(\n\n)/, '$1\n|класс_списков = ' + classList + '$2'); } else { textboxNewContent = textboxNewContent.replace(/^([^]*\| *state *=[^\n]*\n)/, '$1|класс_списков = ' + classList + '\n'); } } $('#wpTextbox1').val(textboxNewContent); var summaryValue = $('#wpSummary').val(); if (!/hlist/.test(summaryValue)) { $('#wpSummary').val(summaryValue + (/[^,; \/]$/.test(summaryValue) ? ', ' : '') + 'перевод на hlist при помощи [[t:navbox#bookmarklet|букмарклета]]'); }</source>Этот букмарклет не преобразует элементы в скобках в [[#астериски|пункты списка второго уровня]] (<code>**</code>) — это нужно делать вручную.


== Примеры ==
== Примеры ==
Строка 797: Строка 794:
* {{tl|Навигационная таблица музыкального исполнителя}}
* {{tl|Навигационная таблица музыкального исполнителя}}
* {{tl|Сворачивающийся список}}
* {{tl|Сворачивающийся список}}
* {{tl|Сокрытие}}
* {{tl|Сокрытие}}<includeonly>[[Категория:Шаблоны:Для навигационных шаблонов]]</includeonly>
* [[Викимультия:Сворачивающиеся блоки]]
 
== TemplateData ==
<templatedata>
{
"params": {
"state": {
"description": "По умолчанию (если параметр отсутствует или с пустым значением) — autocollapse. Навигационная таблица с этим параметром будет появляться в скрытом состоянии, если на странице есть две или более навигационных таблицы с CSS-классом collapsible. Если указано значение collapsed, навигационная таблица всегда будет появляться в свёрнутом состоянии. Также возможны значения plain и off (см. документацию). Для значения uncollapsed и любого другого навигационная таблица всегда будет появляться в раскрытом состоянии."
},
"стиль": {
"aliases": [
"basestyle",
"стиль_базовый"
],
"autovalue": ""
},
"стиль_тела": {
"description": "Дополняет и/или перекрывает значения из параметра стиль.",
"autovalue": "",
"aliases": [
"bodystyle"
]
},
"изображение": {
"description": "изображение справа",
"example": "[[Файл:Wikimultia-logo.svg|120px]]",
"aliases": [
"image"
]
},
"ссылка_на_просмотр": {
"description": "Показывать ссылку «Просмотр этого шаблона» для перехода к шаблону, указанному в параметре «имя». Если указано значение plain, либо параметр «имя» пустой или не задан, ссылка в левой части заголовка показана не будет.",
"aliases": [
"navbar"
]
},
"имя": {
"description": "Название шаблона. Используется для ссылок на шаблон.",
"autovalue": "{{подст:PAGENAME}}",
"aliases": [
"name"
]
},
"заголовок": {
"description": "Текст, отображаемый в верхней строке таблицы. Обычно это тема шаблона, краткое описание его содержания.",
"autovalue": "",
"aliases": [
"title"
]
},
"вверху": {
"description": "Ячейка во всю ширину таблицы, располагающаяся непосредственно под основным заголовком (над заголовками/списками тела шаблона). Список из этого параметра по умолчанию будет отцентрирован.",
"aliases": [
"above"
]
},
"стиль_вверху": {
"aliases": [
"abovestyle"
]
},
"список1": {
"description": "Тело шаблона; как правило, набор ссылок. Элементы списка должны быть указаны на одной строке, но, заключив их в <div></div>, можно использовать перенос строки (см. ниже). Каждый список отображается в отдельной строке таблицы.",
"aliases": [
"list1"
]
},
"стиль_списков": {
"aliases": [
"liststyle"
]
},
"стиль_нечётных": {
"aliases": [
"oddstyle",
"стиль_нечетных"
]
},
"список2": {
"aliases": [
"list2"
]
},
"список3": {
"aliases": [
"list3"
]
},
"список4": {
"aliases": [
"list4"
]
},
"список5": {
"aliases": [
"list5"
]
},
"список6": {
"aliases": [
"list6"
]
},
"список7": {
"aliases": [
"list7"
]
},
"список8": {
"aliases": [
"list8"
]
},
"список9": {
"aliases": [
"list9"
]
},
"список10": {
"aliases": [
"list10"
]
},
"список11": {
"aliases": [
"list11"
]
},
"список12": {
"aliases": [
"list12"
]
},
"список13": {
"aliases": [
"list13"
]
},
"список14": {
"aliases": [
"list14"
]
},
"список15": {
"aliases": [
"list15"
]
},
"список16": {
"aliases": [
"list16"
]
},
"список17": {
"aliases": [
"list17"
]
},
"список18": {
"aliases": [
"list18"
]
},
"список19": {
"aliases": [
"list19"
]
},
"список20": {
"aliases": [
"list20"
]
},
"список21": {
"aliases": [
"list21"
]
},
"список22": {
"aliases": [
"list22"
]
},
"список23": {
"aliases": [
"list23"
]
},
"группа2": {
"aliases": [
"group2",
"заголовок2"
]
},
"стиль_чётных": {
"aliases": [
"evenstyle",
"стиль_четных"
]
},
"группа3": {
"aliases": [
"group3",
"заголовок3"
]
},
"группа4": {
"aliases": [
"group4",
"заголовок4"
]
},
"группа5": {
"aliases": [
"group5",
"заголовок5"
]
},
"группа6": {
"aliases": [
"group6",
"заголовок6"
]
},
"группа7": {
"aliases": [
"group7",
"заголовок7"
]
},
"группа8": {
"aliases": [
"group8",
"заголовок8"
]
},
"группа9": {
"aliases": [
"group9",
"заголовок9"
]
},
"группа10": {
"aliases": [
"group10",
"заголовок10"
]
},
"группа11": {
"aliases": [
"group11",
"заголовок11"
]
},
"группа12": {
"aliases": [
"group12",
"заголовок12"
]
},
"группа13": {
"aliases": [
"group13",
"заголовок13"
]
},
"группа14": {
"aliases": [
"group14",
"заголовок14"
]
},
"группа15": {
"aliases": [
"group15",
"заголовок15"
]
},
"группа16": {
"aliases": [
"group16",
"заголовок16"
]
},
"группа17": {
"aliases": [
"group17",
"заголовок17"
]
},
"группа18": {
"aliases": [
"group18",
"заголовок18"
]
},
"группа19": {
"aliases": [
"group19",
"заголовок19"
]
},
"группа20": {
"aliases": [
"group20",
"заголовок20"
]
},
"группа21": {
"aliases": [
"group21",
"заголовок21"
]
},
"группа22": {
"aliases": [
"group22",
"заголовок22"
]
},
"группа23": {
"aliases": [
"group23",
"заголовок23"
]
},
"внизу": {
"description": "Ячейка во всю ширину таблицы, располагающаяся внизу тела шаблона (под заголовками/списками и изображением).  Список из этого параметра по умолчанию будет отцентрирован.",
"aliases": [
"below"
]
},
"стиль_внизу": {
"aliases": [
"belowstyle"
]
},
"группа1": {
"aliases": [
"group1",
"заголовок1"
],
"description": "Заголовок группыN для спискаN"
},
"изображение_слева": {
"aliases": [
"imageleft",
"изображение2"
],
"label": "изображение слева",
"description": "изображение вставляется слева до заголовков",
"example": "[[Файл:Wikimultia-logo.svg|120px]]"
},
"стиль_заголовка": {
"aliases": [
"titlestyle",
"стиль_основного_заголовка"
]
},
"стиль_групп": {
"aliases": [
"groupstyle",
"стиль_заголовков"
],
"description": "Стили для всех параметров заголовокN. Этот параметр имеет более высокий приоритет, нежели стиль. Как правило, цвет фона",
"example": "background: #cccccc",
"default": "background: #cfe3ff"
},
"стиль_изображения": {
"aliases": [
"imagestyle"
],
"description": "стиль для блока в который заключено изображение, CSS"
},
"стиль_изображения_слева": {
"aliases": [
"imageleftstyle",
"imagestyle2"
]
},
"класс_тела": {
"aliases": [
"bodyclass"
]
},
"класс_заголовка": {
"aliases": [
"titleclass"
]
},
"класс_вверху": {
"aliases": [
"aboveclass"
]
},
"класс_внизу": {
"aliases": [
"belowclass"
]
},
"класс_групп": {
"aliases": [
"groupclass"
]
},
"класс_списков": {
"aliases": [
"listclass"
]
},
"класс_изображения": {
"aliases": [
"imageclass"
]
},
"ширина_групп": {
"aliases": [
"groupwidth"
]
},
"отступ_списков": {
"aliases": [
"listpadding"
]
},
"чётные_нечётные": {
"aliases": [
"evenodd",
"четные_нечетные"
]
},
"стиль_списка1": {
"aliases": [
"list1style"
]
},
"стиль_списка2": {
"aliases": [
"list2style"
]
},
"стиль_списка3": {
"aliases": [
"list3style"
]
},
"стиль_списка4": {
"aliases": [
"list4style"
]
},
"стиль_списка5": {
"aliases": [
"list5style"
]
},
"стиль_списка6": {
"aliases": [
"list6style"
]
},
"стиль_списка7": {
"aliases": [
"list7style"
]
},
"стиль_списка8": {
"aliases": [
"list8style"
]
},
"стиль_списка9": {
"aliases": [
"list9style"
]
},
"стиль_списка10": {
"aliases": [
"list10style"
]
},
"стиль_списка11": {
"aliases": [
"list11style"
]
},
"стиль_списка12": {
"aliases": [
"list12style"
]
},
"стиль_списка13": {
"aliases": [
"list13style"
]
},
"стиль_списка14": {
"aliases": [
"list14style"
]
},
"стиль_списка15": {
"aliases": [
"list15style"
]
},
"стиль_списка16": {
"aliases": [
"list16style"
]
},
"стиль_списка17": {
"aliases": [
"list17style"
]
},
"стиль_списка18": {
"aliases": [
"list18style"
]
},
"стиль_списка19": {
"aliases": [
"list19style"
]
},
"стиль_списка20": {
"aliases": [
"list20style"
]
},
"стиль_списка21": {
"aliases": [
"list21style"
]
},
"стиль_списка22": {
"aliases": [
"list22style"
]
},
"стиль_списка23": {
"aliases": [
"list23style"
]
},
"стиль_группы1": {
"aliases": [
"group1style",
"стиль_заголовка1"
]
},
"стиль_группы2": {
"aliases": [
"group2style",
"стиль_заголовка2"
]
},
"стиль_группы3": {
"aliases": [
"group3style",
"стиль_заголовка3"
]
},
"стиль_группы4": {
"aliases": [
"group4style",
"стиль_заголовка4"
]
},
"стиль_группы5": {
"aliases": [
"group5style",
"стиль_заголовка5"
]
},
"стиль_группы6": {
"aliases": [
"group6style",
"стиль_заголовка6"
]
},
"стиль_группы7": {
"aliases": [
"group7style",
"стиль_заголовка7"
]
},
"стиль_группы8": {
"aliases": [
"group8style",
"стиль_заголовка8"
]
},
"стиль_группы9": {
"aliases": [
"group9style",
"стиль_заголовка9"
]
},
"стиль_группы10": {
"aliases": [
"group10style",
"стиль_заголовка10"
]
},
"стиль_группы11": {
"aliases": [
"group11style",
"стиль_заголовка11"
]
},
"стиль_группы12": {
"aliases": [
"group12style",
"стиль_заголовка12"
]
},
"стиль_группы13": {
"aliases": [
"group13style",
"стиль_заголовка13"
]
},
"стиль_группы14": {
"aliases": [
"group14style",
"стиль_заголовка14"
]
},
"стиль_группы15": {
"aliases": [
"group15style",
"стиль_заголовка15"
]
},
"стиль_группы16": {
"aliases": [
"group16style",
"стиль_заголовка16"
]
},
"стиль_группы17": {
"aliases": [
"group17style",
"стиль_заголовка17"
]
},
"стиль_группы18": {
"aliases": [
"group18style",
"стиль_заголовка18"
]
},
"стиль_группы19": {
"aliases": [
"group19style",
"стиль_заголовка19"
]
},
"стиль_группы20": {
"aliases": [
"group20style",
"стиль_заголовка20"
]
},
"стиль_группы21": {
"aliases": [
"group21style",
"стиль_заголовка21"
]
},
"стиль_группы22": {
"aliases": [
"group22style",
"стиль_заголовка22"
]
},
"стиль_группы23": {
"aliases": [
"group23style",
"стиль_заголовка23"
]
},
"border": {}
},
"description": "Основа для навигационных шаблонов",
"format": "block",
"paramOrder": [
"имя",
"заголовок",
"изображение",
"ссылка_на_просмотр",
"border",
"state",
"стиль",
"стиль_тела",
"стиль_групп",
"стиль_списков",
"стиль_чётных",
"стиль_нечётных",
"стиль_заголовка",
"стиль_изображения",
"стиль_изображения_слева",
"изображение_слева",
"стиль_вверху",
"вверху",
"группа1",
"список1",
"группа2",
"список2",
"группа3",
"список3",
"группа4",
"список4",
"группа5",
"список5",
"группа6",
"список6",
"группа7",
"список7",
"группа8",
"список8",
"группа9",
"список9",
"группа10",
"список10",
"группа11",
"список11",
"группа12",
"список12",
"группа13",
"список13",
"группа14",
"список14",
"группа15",
"список15",
"группа16",
"список16",
"группа17",
"список17",
"группа18",
"список18",
"группа19",
"список19",
"группа20",
"список20",
"группа21",
"список21",
"группа22",
"список22",
"группа23",
"список23",
"стиль_внизу",
"внизу",
"класс_внизу",
"класс_тела",
"класс_заголовка",
"класс_вверху",
"класс_групп",
"класс_списков",
"класс_изображения",
"ширина_групп",
"отступ_списков",
"чётные_нечётные",
"стиль_списка1",
"стиль_списка2",
"стиль_списка3",
"стиль_списка4",
"стиль_списка5",
"стиль_списка6",
"стиль_списка7",
"стиль_списка8",
"стиль_списка9",
"стиль_списка10",
"стиль_списка11",
"стиль_списка12",
"стиль_списка13",
"стиль_списка14",
"стиль_списка15",
"стиль_списка16",
"стиль_списка17",
"стиль_списка18",
"стиль_списка19",
"стиль_списка20",
"стиль_списка21",
"стиль_списка22",
"стиль_списка23",
"стиль_группы1",
"стиль_группы2",
"стиль_группы3",
"стиль_группы4",
"стиль_группы5",
"стиль_группы6",
"стиль_группы7",
"стиль_группы8",
"стиль_группы9",
"стиль_группы10",
"стиль_группы11",
"стиль_группы12",
"стиль_группы13",
"стиль_группы14",
"стиль_группы15",
"стиль_группы16",
"стиль_группы17",
"стиль_группы18",
"стиль_группы19",
"стиль_группы20",
"стиль_группы21",
"стиль_группы22",
"стиль_группы23"
]
}
</templatedata>
 
<includeonly>
[[Категория:Шаблоны:Для навигационных шаблонов]]
</includeonly>

Текущая версия от 20:34, 18 марта 2019

Данный шаблон позволяет быстро создавать навигационные шаблоны, указывая в качестве параметров списки ссылок.

В правом верхнем углу находится кнопка [показать] / [скрыть]. Это реализовано с помощью MediaWiki:Common.js.

Заготовка для копирования

Заготовка ниже предназначена для копирования в новые шаблоны для облегчения их оформления:

{{Навигационная таблица
| имя                     = {{подст:PAGENAME}}{{подст:пустой шаблон|Не меняйте ничего на этой строке. Она изменится сама при сохранении.}}
| заголовок               = 
| изображение             = 
| state                   = <includeonly>{{{state|autocollapse}}}</includeonly>
| стиль                   = <!-- Стиль всех заголовков (вверху, сбоку, внизу), например: background: {{цвет|Россия}}; -->
| класс_списков           = hlist

| вверху        = 

| группа1       = 
| список1       =

| группа2       = 
| список2       =

<!-- ... -->

| группа23      = 
| список23      =

| внизу         = 
}}<noinclude>[[Категория:Навигационные шаблоны]]</noinclude>

Параметры

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

Основные

Список параметров и их имен
Параметры Алиасы
name= имя=
title= заголовок=
navbar= ссылка_на_просмотр=
border=
state=
above= вверху=
image= изображение=
imageleft= изображение_слева=
groupn= группаn=
listn= списокn=
below= внизу=
titlestyle= стиль_заголовка=
groupstyle= стиль_групп=
bodystyle= стиль_тела=
basestyle= стиль_базовый=
groupnstyle= стиль_группыn=
listnstyle= стиль_спискаn=
groupwidth= ширина_групп=
liststyle= стиль_списков=
listpadding= отступ_списков=
oddstyle= стиль_нечётных=
evenstyle= стиль_чётных=
abovestyle= стиль_вверху=
belowstyle= стиль_внизу=
imagestyle= стиль_изображения=
imageleftstyle= стиль_изображения_слева=
bodyclass= класс_тела=
aboveclass= класс_вверху=
groupclass= класс_групп=
listclass= класс_списков=
belowclass= класс_внизу=
titlegroup=
titlegroupstyle=
innerstyle=
titleclass= класс_заголовка=
имя* =
name* =
Имя шаблона, необходимое для ссылки Просмотр этого шаблона (переход к шаблону) на всех страницах, где используется шаблон. Для простоты можно использовать {{подст:PAGENAME}}. Если указан параметр |ссылка_на_просмотр=plain, то этот параметр не используется.
state* = [autocollapse, collapsed, uncollapsed, plain, off]
autocollapse — значение по умолчанию, если |state= пустой или отсутствует;
collapsed — при данном значении таблица всегда будет свернута;
uncollapsed — при данном значение таблица всегда будет развернута;
plain — при данном значении таблица всегда будет развернута и будут убраны ссылки [показать] / [скрыть] справа. Заголовок будет отцентрирован относительно всей ячейки, игнорируя размеры «шестеренки»;
off — при данном значении таблица всегда будет развернута и будут убраны ссылки [показать] / [скрыть] справа. Заголовок не будет отцентрирован относительно всей ячейки, игнорируя размеры «шестеренки». Предпочтительно использовать plain вместо off. Используйте данный параметр, только если знаете что делаете.
Навигационная таблица с параметром autocollapse будет появляться в скрытом состоянии, если на странице есть две или более навигационных таблицы с CSS-классом collapsible (технические детали см. в MediaWiki:Common.js).
Иногда требуется навигационный шаблон с состоянием по умолчанию, которое можно переопределить в статье. Для этого в навигационном шаблоне используйте параметр |state=, просто передающий значение базовому шаблону (вместо состояние по умолчанию нужно подставить необходимое значение — например, autocollapse):
| state = <includeonly>{{{state|состояние по умолчанию}}}</includeonly>
(теги <includeonly> нужны для того, чтобы при просмотре шаблона на его странице он всегда оставался в раскрытом состоянии). Соответственно, при использовании такого навигационного шаблона можно указывать его состояние, например:
{{Наш навигационный шаблон|state=collapsed}}
ссылка_на_просмотр* =
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= не будет указан |список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=, но при этом список из параметра |внизу= по умолчанию будет отцентрирован.

Стили

В следующих параметрах указываются CSS-стили.

Внимание! Значения стилей таблиц по умолчанию в Википедии в настоящее время заданы с помощью MediaWiki:Common.css.

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

style =
Аналог |bodystyle=, используемый в английском разделе Википедии для совместимости со старыми шаблонами. Рекомендуется заменять его на |bodystyle= или |стиль_тела=. Обратите внимание: параметры |style= и |стиль= имеют разное назначение, |стиль= описан ниже.
titlestyle =
стиль_заголовка =
Стили для параметра |заголовок=. Как правило, цвет фона:
| стиль_заголовка = background: #nnnnnn;
| стиль_заголовка = background: name;
Цвет фона по умолчанию — #cfe3ff.
basestyle =
стиль =
Задает общий стиль для |вверху=, |внизу=, |заголовок= и |группаn=, не затрагивая ячейки списков.
background: #nnnnnn;
bodystyle =
стиль_тела =
Стили для тела (фона) шаблона. Примеры аргументов этих параметров:
background: #nnnnnn;
text-align: [right/center/left/justified]
width: N[em/%/px]
float: [left/right/none]
clear: [right/left/both/none]
groupstyle =
стиль_групп =
Стили для всех параметров |группаn=. Этот параметр имеет более высокий приоритет, нежели |стиль=. Примеры аргументов этого параметра:
background: #nnnnnn;
text-align: [left/center/right];
vertical-align: [top/middle/bottom];
white-space: nowrap;
Цвет фона по умолчанию — #dcebff. Как можно видеть, этот цвет чуть светлее стандартного цвета фона заголовка шаблона. Если вы подбираете цвет фона по тому же принципу, отталкиваясь от другого цвета фона заголовка, вы можете воспользоваться инструментом подбора цвета на базе HSL-шкалы, сдвинув значение третьего параметра (светлоты) на треть ближе к 100 (например, 85 → 90; пример инструмента).
groupnstyle =
стиль_группыn =
Стиль для одного из заголовков групп. Переписывает параметр |groupstyle=. Пример:
| group2style = background: red; color: white;
groupwidth =
ширина_групп =
Параметр используется для упрощения работы с шириной заголовков групп, когда меньшие заголовки имеют меньшую ширину. Особенно полезно при использовании дочерних шаблонов. Пример:
| groupwidth = 10em
liststyle =
стиль_списков =
Стили для всех параметров |списокn=. Этот параметр имеет более высокий приоритет, нежели |стиль=.
Цвета фона списка (и всей таблицы) по умолчанию — #f9f9f9.
listnstyle =
стиль_спискаn =
Стиль для одного из списков. Переписывает параметр |liststyle=. Пример:
| list2style = background: red; color: white;
listpadding =
отступ_списков =
Задает значение внутренних отступов для всех списков, по умолчанию этот параметр равен 0em — сверху и снизу, 0.25em — справа и слева.
| listpadding = 0.5em 0 — задаст отступы 0.5em — сверху и снизу, 0em — справа и слева.
| listpadding = 0 — уберёт все отступы в ячейках списков.
oddstyle =
стиль_нечётных =
evenstyle =
стиль_чётных =
Стили для всех нечётных (|список1=, |список3= и т. д.) и чётных (|список2=, |список4= и т. д.) списков. Эти параметры имеют более высокий приоритет, нежели |стиль= и |стиль_списков=. Обычно используются для задания цвета фона (background: #nnnnnn;), чтобы получить строки таблицы с фоновой чересполосицей. Цвет нечётных списков по умолчанию — #fdfdfd, чётных — #f7f7f7.
evenodd = [swap, even, odd, off]
чётные_нечётные =
Если задано значение swap, то автоматическое чередование чётных и нечётных строк станет обратным. Обычно, если чётным строкам задан светло-серый фон, то при использовании этого параметра нечётные строки получат серый фон вместо чётнчётных строк. Значения even и odd заставит все строки стать чётными или нечётными. off отключает автоматическое чередование строк. Этот дополнительный параметр следует использовать только для устранения проблем, когда навигационная таблица используется как дочерний элемент другой навигационной таблицы и строки не совпадают. Примеры и дальнейшее описание можно найти в разделе, посвященном дочерним шаблонам.
abovestyle =
стиль_вверху =
belowstyle =
стиль_внизу =
Стили для параметров |вверху= и |внизу=, соответственно. Обычно используются для задания цвета фона и выравнивания текста:
background: #nnnnnn;
text-align: [left/center/right];
imagestyle =
стиль_изображения =
imageleftstyle =
стиль_изображения_слева =
Задает стиль ячеек для изображений. Может быть использован, если ширина ячейки, в которой находится изображение, слишком большая.
стиль_изображения = width: 5em;

Классы

bodyclass =
класс_тела =
aboveclass =
класс_вверху =
groupclass =
класс_групп =
listclass =
класс_списков =
belowclass =
класс_внизу =
Задают CSS-класс для элементов шаблона. Обычно используется hlist для горизонтальных списков |класс_списков=. Каждый из параметров может принимать значение hlist, и если в шаблоне вы используете более одного параметра с hlist, то лучше использовать |bodyclass= для всего шаблона. Также можно использовать класс hlist-items-nowrap, чтобы запретить перенос строки внутри элементов, но это создаёт проблемы в IE9 и ниже (ими можно будет пренебречь, когда доля их использования станет очень малой).
Раньше шаблоны использовали разделители вроде {{}}, {{·}} вместо списков с астериском. Чтобы автоматически преобразовать код шаблона из старого формата в новый, вы можете воспользоваться следующим букмарклетом (запускается из панели закладок) (код поддерживает Jack who built the house):
javascript:/* version 2.1 */ var classList = 'hlist'; var textboxContent = $('#wpTextbox1').val().replace(/<br ?\/>/g, '<br>'); var textboxNewContent = textboxContent.replace(/(\|\s*(?:список|list|содержание)\d*\s*=)([^]*?\n\s*)(?=\||\}\})/g, function(s, m1, m2) { var m2r = m2.replace(/\{\{(?:[nN]o(?:wrap|br)|[sS])\|([^•·\}]+?)\s*(?:•|(?:\'\'\')?·(?:\'\'\')?)\s*\}\}\s*/g, '$1\n* '); if (m2 !== m2r && classList.indexOf('hlist-items-nowrap') === -1) { classList += ' hlist-items-nowrap'; } m2r = m2r.replace(/\s*({\{[·•*т!](w(rap)?)?\}\}|·|•||)\s*/g, '\n* '); if (m2 !== m2r) { m2r = m2r.replace(/^(\s*)<div(?:[\w ]+?=[^<>]+| ?)>([^]*?)\n?<\/div>(\s*)$/, '$1$2$3'); m2r = m2r.replace(/^(\s*)\{\{[nN]owrap begin\}\}([^]*?)\n?\{\{[nN]owrap end\}\}(\s*)$/, '$1$2$3'); m2r = '\n* ' + m2r.replace(/^\s*/g, ''); m2r = m2r.replace(/\* \{\{(?:[nN]o(?:wrap|br)|[sS])\|([^\}]+?)\s*\}\}(\s*)$/, '* $1$2'); m2r = m2r.replace(/ *(\s*)$/, '$1'); } return m1 + m2r; }); if (!textboxNewContent.match(/[Нн]авигационная полоса/) && !textboxNewContent.match(/[^"']hlist[^"']/)) { if (textboxNewContent.indexOf('\n\n') !== -1) { textboxNewContent = textboxNewContent.replace(/^([^]*?)(\n\n)/, '$1\n|класс_списков = ' + classList + '$2'); } else { textboxNewContent = textboxNewContent.replace(/^([^]*\| *state *=[^\n]*\n)/, '$1|класс_списков = ' + classList + '\n'); } } $('#wpTextbox1').val(textboxNewContent); var summaryValue = $('#wpSummary').val(); if (!/hlist/.test(summaryValue)) { $('#wpSummary').val(summaryValue + (/[^,; \/]$/.test(summaryValue) ? ', ' : '') + 'перевод на hlist при помощи [[t:navbox#bookmarklet|букмарклета]]'); }
Этот букмарклет не преобразует элементы в скобках в пункты списка второго уровня (**) — это нужно делать вручную.

Примеры

Без изображения

С изображением

</source> }}

С изображением и стилями

Дочерние шаблоны

Больше примеров на тестовой странице шаблона.

Существует возможность разместить несколько навигационных таблиц в одной, при этом внешние рамки будут убраны. Для этого необходимо использовать параметр |border= или просто первый параметр со значением child. Как пример, в следующем коде дополнительная навигационная таблица добавляется в первый список:

{{Навигационная таблица
| имя = {{подст:PAGENAME}}
| заголовок = Заголовок

| заголовок1 = [опционально]
| список1 = {{Навигационная таблица|child
   ...параметры дочерней навигационной таблицы...
}}

...
}}

Пример с подгруппами

Данный пример показывает как могут создаваться подгруппы. Рекомендуется использовать {{Подгруппы навигационной таблицы}}, но похожего результата можно добиться и с помощью {{Навигационная таблица}} с использованием праметра |border= или первого параметра со значением child. В данном примере использованы оба способа создания подгрупп. Параметр |evenodd= позволяет сменить чередование цвета строк, для создания правильной последовательности, а для того чтобы в подгруппах совсем убрать чередование и использовать цвет основного списка, необходимо добавить строку liststyle = background: transparent; в каждую подгруппу.

Пример со сворачивающимися блоками

Приведенный ниже пример создан с помощью обычной Навигационной таблицы в качестве основного контейнера, а то его каждый список |list1=, |list2= и |list3= содержит еще одну Навигационную таблицу с первым параметром child. Шестеренка у каждой внутренней таблицы убрана с помощью заданного параметра navbar|navbar=plain. Но в данном примере, так как у внутренних Навигационных таблиц не задан параметр |имя= шестеренка не будет отображаться даже если параметра |navbar= не будет.

Взаимодействие с другими шаблонами

Данный шаблон разработан специально для работы в сочетании с двумя другими родственными шаблонами: {{Навигационная таблица с колонками}} и {{Навигационная таблица с блоками}}. Все три эти шаблона имеют одинаковые параметры для простоты использования (такие параметры отмеченны звездочкой (*) в списке описания параметров). Самое главное, что каждый шаблон может быть использован в качестве дочернего друг для друга (с помощью |border=child, либо указав значение первого неименованного параметра равное child, например: {{Навигационная таблица|child ...}}, {{Навигационная таблица с колонками|child ...}} or {{Навигационная таблица с блоками|child ...}}).

См. также