Этот шаблон позволяет относительно быстро настроить шаблон навигации , снабдив его одним или несколькими списками ссылок. Он оснащен стилями по умолчанию, которые подходят для большинства шаблонов навигации. Изменение стилей по умолчанию возможно, но не рекомендуется. Использование этого шаблона или одного из его родственных шаблонов «Navbox suite» настоятельно рекомендуется для стандартизации навигационных шаблонов и простоты использования.
Шаблоны, использующие классы class=navbox
({{navbox}}) или class=nomobile
({{ Sidebar }}), не отображаются на мобильном веб-сайте английской Википедии. Просмотры страниц с мобильных устройств составляют примерно 66% всех просмотров страниц (среднее значение за 90 дней по состоянию на январь 2024 г. [обновлять]).
Пожалуйста, удалите параметры, которые остались пустыми.
{{ Навбокс | name = {{ subst : PAGENAME }}{{ subst : void | Ничего не меняйте в этой строке. Он изменится сам при сохранении. }} | заголовок = | класс списка = список | состояние = {{{ состояние |}}}| выше = | изображение =| группа1 = | список1 =| группа2 = | список2 =| группа3 = | список3 =<!-- ... -->| ниже = }}
В навигационном поле имена параметров используются строчными буквами, как показано в поле ( выше ). Требуемое имя и заголовок образуют однострочное поле, если другие параметры опущены.
Обратите внимание: «группа1» (и т. д.) не является обязательной, как и разделы с именами «выше/ниже».
Основные и наиболее распространенные параметры следующие (полный список см. ниже):
name
– имя (расположение в Википедии) шаблона.title
– текст в строке заголовка, например: [[Виджет]].listclass
– класс CSS для ячеек списка, обычно hlist
для горизонтальных списков. Альтернативно, используйте bodyclass для всего ящика.state
– контролирует, когда навигационный блок разворачивается или сворачивается.titlestyle
– стиль CSS для заголовка, например:background: gray;
groupstyle
– стиль CSS для групповых ячеек, например:background: #eee;
above
– текст, который будет отображаться над разделом группы/списка (может быть список всех вики-ссылок).image
– необязательное правое изображение, закодированное как целое изображение, например:[[File:XX.jpg|80px|alt=Alternate text]]
imageleft
– необязательное левое изображение (код такой же, как у параметра «image»).groupn
– текст слева перед списком-n (если группа-n опущена, список-n простирается до левого края поля и по умолчанию используется text-align:center
стиль).listn
– текстовый список вики-ссылок в формате вики-списка .below
– необязательный текст, который будет отображаться под разделом группы/списка.Ниже приведен полный список параметров для использования {{Navbox}}. В большинстве случаев единственными обязательными параметрами являются name
, title
и list1
, хотя дочерние навигационные блоки даже не требуют их установки.
{{Navbox}} имеет множество общих имен параметров со своими родственными шаблонами {{ Navbox со столбцами }} и {{ Navbox со свертываемыми группами }} для единообразия и простоты использования. Параметры, отмеченные звездочкой (*), являются общими для всех трех основных шаблонов.
{{subst:PAGENAME}}
это значение как ярлык. Параметр name является обязательным только в том случае, если title
указан a, border
параметр не установлен и navbar
параметр не используется для отключения панели навигации.autocollapse, collapsed, expanded, plain, off
]autocollapse
. Навбокс autocollapse
изначально будет свернутым, если на одной странице есть два или более сворачиваемых элемента. В противном случае навигационный блок будет расширен. Для технически подкованных см. MediaWiki:Common.js (поиск «autocollapse»).collapsed
, навигационный блок всегда будет запускаться в свернутом состоянии.expanded
, навигационный блок всегда будет запускаться в развернутом состоянии.plain
, поле навигации всегда будет расширяться без ссылки [скрыть] справа, а заголовок останется по центру (с использованием заполнения для смещения ссылок V • T • E ).off
, поле навигации всегда будет расширяться без ссылки [скрыть] справа, но никакие отступы не будут использоваться для сохранения заголовка по центру. Это только для продвинутого использования; опции «plain» должно быть достаточно для большинства приложений, где кнопку [показать]/[скрыть] необходимо скрыть.<noinclude>...</noinclude>
тегов. Этот параметр заставит блок быть видимым в автономном режиме (даже если за ним следуют другие блоки), отображая «[скрыть]», но затем он автоматически свернет блок при размещении внутри статьи:| state =
<noinclude>expanded</noinclude>
| состояние = {{{state<includeonly>|your_desired_initial_state</includeonly>}}}
<includeonly>
|
будет расширяться при просмотре страницы шаблона сам по себе.| состояние = {{{state<includeonly>|расширенное</includeonly>}}}Все транслируемые статьи отображают содержимое по умолчанию, если только нет гипотетической статьи, в которой указано,
{{templatename|state=collapsed}}
когда транслируется.| состояние = {{{state<includeonly>|свернуто</includeonly>}}}Во всех включаемых статьях шаблон по умолчанию будет отображаться в свернутом виде, но шаблон по-прежнему будет развернут при отображении на отдельной странице.
state
параметр. Его можно добавить в <noinclude>...</noinclude>
раздел после определения шаблона или в инструкции на {{ подстранице документации }}.plain
, ссылки V • T • E в левой части заголовка не будут отображаться, а отступы будут автоматически использоваться для удержания заголовка по центру. Используйте off
для удаления ссылок V*T*E , но не применяйте отступы (это только для расширенного использования; опции «простой» должно быть достаточно для большинства приложений, где панель навигации нежелательна). Настоятельно рекомендуется не скрывать панель навигации, чтобы пользователям было проще редактировать шаблон и сохранить стандартный стиль на всех страницах.child
или subgroup
, то навигационный блок можно использовать как дочерний элемент без полей, который плотно вписывается в другой навигационный блок. Граница скрыта, а по бокам таблицы нет отступов, поэтому она помещается в область списка родительского навигационного окна. Если установлено значение none
, то граница скрывается, а отступы удаляются, и навигационный блок может использоваться как дочерний элемент другого контейнера (не используйте параметр none
внутри другого навигационного блока; аналогично используйте параметр child
/ только subgroup
внутри другого навигационного блока). Если установлено любое другое значение (по умолчанию), то отображается обычный навигационный блок с рамкой в 1 пиксель. Альтернативный способ указать границу как стиль подгруппы выглядит следующим образом (т. е. использовать первый безымянный параметр вместо именованного параметра границы ):{{Navbox|ребенок|...}}
{{-}}
для обеспечения правильного центрирования. Технически этот параметр не является обязательным, но без заголовка использовать {{Navbox}} бессмысленно.<div> </div>
. Требуется хотя бы один параметр списка ; каждый дополнительный список отображается в отдельной строке таблицы. Каждому списку n может предшествовать соответствующий параметр группы n , если он предусмотрен (см. ниже).[[Файл:</nowiki><var>XX</var><nowiki>.jpg|80px|link=|alt=]]Примечание: включение «|right» приведет к созданию обычного левого поля для отделения от элементов списка и полосатого рисунка зебры .
{{icon|category}} [[:Category:name|Category]]
Обычно не рекомендуется использовать стили, чтобы обеспечить согласованность шаблонов и страниц Википедии; но предоставляется возможность изменять стили.
bodystyle = background: #nnnnnn;
bodystyle = width: N [em/%/px or width: auto];
bodystyle = float: [left/right/none];
bodystyle = clear: [right/left/both/none];
basestyle = background: lightskyblue;
titlestyle = background: #nnnnnn;
titlestyle = background: name;
titlestyle = background: none;
— без цвета фонаgroupstyle = background: #nnnnnn;
groupstyle = text-align: [left/center/right];
groupstyle = vertical-align: [top/middle/bottom];
group3style = background: red; color: white;
groupwidth = 9em
list5style = background: #ddddff;
listpadding = 0.5em 0;
(устанавливает отступы 0,5em для верха/низа и 0 для левого/правого.)listpadding = 0;
(удаляет все поля списка.)[swap, even, odd, off]
swap
, автоматическое чередование четных и нечетных строк меняется на противоположное. Обычно четные строки имеют светло-серый фон для полосирования; при использовании этого параметра нечетные строки получают серую полоску вместо четных. Устанавливает even
или odd
устанавливает для всех строк этот цвет полос. Установка значения off
отключает автоматическое чередование строк.abovestyle = background: #nnnnnn;
abovestyle = text-align: [left/center/right];
belowstyle = background: #nnnnnn;
belowstyle = text-align: [left/center/right];
imagestyle = width:5em;
Перечисленные здесь настройки стиля — это те, которые редакторы, использующие навигационный блок, меняют чаще всего. Другие, более сложные настройки стиля были исключены из этого списка, чтобы упростить его. Большинство стилей установлены в MediaWiki:Common.css .
bodystyle = фон : # fdfdfd ; ширина : 100 %; вертикальное выравнивание : по середине ; titlestyle = фон : # ccccff ; отступ слева : 1em ; отступ справа : 1em ; выравнивание текста : по центру ; вышестиль = фон : # ddddff ; отступ слева : 1em ; отступ справа : 1em ; выравнивание текста : по центру ; нижестиль = фон : # ddddff ; отступ слева : 1em ; отступ справа : 1em ; выравнивание текста : по центру ; groupstyle = фон : # ddddff ; отступ слева : 1em ; отступ справа : 1em ; выравнивание текста : по правому краю ; стиль списка = фон : прозрачный ; выравнивание текста : по левому краю / по центру ; нечетный стиль = фон : прозрачный ; дажестиль = фон : # f7f7f7 ;
Поскольку liststyle и нечетный стиль прозрачны, нечетные списки имеют цвет bodystyle , который по умолчанию равен #fdfdfd (белый с оттенком серого). По умолчанию список имеет значение, text-align: left;
если у него есть группа, если нет, то по умолчанию используется значение text-align: center;
. Поскольку только bodystyle имеет вертикальное выравнивание, все остальные наследуют его vertical-align: middle;
.
hlist
класса, который будет вызывать горизонтальное отображение списков. Все эти параметры принимают hlist
класс, но если для используется более одного параметра hlist
, используйте |bodyclass=hlist
его.nowraplinks
, который можно переопределить, например, с помощью |listclass=wraplinks
.|nowrapitems=yes
применяет nowrap к каждой строке элемента списка, а также к любому элементу above
или below
.|orphan=yes
в дочернем навигационном блоке исправляет нечетное/четное чередование и удаляет сиротские элементы Category:Navbox .Этот шаблон поддерживает добавление информации в микроформате. Это делается путем добавления атрибутов «класса» к различным ячейкам данных, указывающих, какой тип информации содержится внутри. Например, чтобы пометить навигационный блок как содержащий информацию hCard о человеке, добавьте следующий параметр:
| класс тела = vcard
и
| класс заголовка = фн
или (например):
| title = Книги <span class="fn">[[Иэна Бэнкса]]</span>
...и так далее.
См. Wikipedia:WikiProject Microformats для получения дополнительной информации о добавлении информации о микроформатах в Википедию, а также microformat для получения дополнительной информации о микроформатах в целом.
Таблица, созданная {{Navbox}} без параметров image , выше и ниже (цвет фона серого списка добавлен только для иллюстрации):
Таблица, сгенерированная {{Navbox}} с параметрами image , выше и ниже (цвет фона серого списка добавлен только для иллюстрации):
Таблица, созданная {{Navbox}} с image , imageleft , lists и без групп , сверху и снизу (цвет фона серого списка добавлен только для иллюстрации):
{{ Навбокс | имя = Navbox/док | title = [[ MSC Малайзия ]] | класс списка = список| группа1 = Центр | list1 =
* [[ Сайберджая ]]| группа2 = Площадь | list2 =
* [[ Долина Кланг ]]| группа3 = Основные достопримечательности | list3 =
* [[ Башни-близнецы Петронас ]]
* [[ Башня Куала-Лумпур ]]
* [[ Центральный Куала-Лумпур ]]
* [[ Технологический парк Малайзии ]]
* [[ Путраджайя ]]
* [[ Сайберджая ]]
* [[ Куала Международный аэропорт Лумпур ]]| группа4 = Инфраструктура | list4 =
* [[ Express Rail Link ]]
* [[ Выделенная скоростная автомагистраль KL-KLIA ]]| группа5 = Основные приложения | list5 =
* [[ Электронное правительство ]]
* [[ MyKad ]] }}
Можно разместить несколько навигационных блоков внутри одной границы, используя «child» в качестве первого параметра или установив параметр border . Базовый код для этого следующий (который добавляет подгруппу для первой области группы/списка):
{{Навбокс| имя = {{subst:PAGENAME}}| заголовок = Название| группа1 = [необязательно]| list1 = {{Navbox|ребёнок ... параметры дочернего навигационного окна... }}...}}
В этом примере показаны две подгруппы, созданные child
с использованием первого безымянного параметра. Чередование чередуется автоматически. Чтобы полностью удалить чередование, вы можете установить его liststyle = background:transparent;
в каждом из навигационных блоков.
В приведенном ниже примере используется обычный навигационный блок для основного контейнера, затем каждый из его параметров list1, list2 и list3 содержит еще один навигационный блок с 1 = child
параметром set. Ссылки просмотра (v), разговора (t), редактирования (e) на панели навигации скрыты с помощью navbar = plain
каждой из них или могут быть скрыты, просто опустив параметр имени (дочерние элементы навигации не требуют установки параметра имени, в отличие от обычные навбоксы).
Этот шаблон навигационного окна работает совместно с двумя другими шаблонами: {{ Navbox со столбцами }} и {{ Navbox со сворачиваемыми группами }}. Все три шаблона имеют общие параметры для единообразия и простоты использования (такие параметры отмечены звездочкой (*) в списке описаний параметров выше). Самое главное, что каждый шаблон может использоваться как дочерний элемент друг друга (с помощью параметра |border=child
или путем указания первого безымянного параметра как child
. Например: {{Navbox|child ...}}
, {{Navbox with columns|child ...}}
или {{Navbox with collapsible groups|child ...}}
.)
bodystyle = background:purple;
, ), вам нужно будет сделать так, чтобы цвет левой границы соответствовал цвету фона (т. е liststyle = border-left-color: purple;
.). Если вы хотите, чтобы вокруг каждой ячейки списка была граница, тогда граница в 2 пикселя между ячейками списка и ячейками группы исчезнет; вам придется придумать собственное решение.style/bodystyle
, это не сработает.bodystyle = width: 22em; float: right; margin-left: 1em; margin-right: 0;
Если вы пытаетесь скопировать {{Navbox}} в свою локальную вики, необходимо также установить или скопировать несколько других вещей:
Add support to mw-collapsible for autocollapse, innercollapse and outercollapse
сценарий из MediaWiki:Common.js , если требуется автоматическое свертывание.Данные шаблона для Navbox
Создает навигационное поле для ссылок на другие страницы. Не отображается на мобильном телефоне.
hlist
класса для форматирования списков. См. Flatlist для технического объяснения того, как hlist
работает.