Этот шаблон позволяет относительно быстро настроить навигационный шаблон , снабдив его одним или несколькими списками ссылок. Он оснащен стилями по умолчанию, которые должны работать для большинства навигационных шаблонов. Изменение стилей по умолчанию возможно, но не рекомендуется. Использование этого шаблона или одного из его родственных шаблонов "Navbox suite" настоятельно рекомендуется для стандартизации навигационных шаблонов и для простоты использования.
Шаблоны, использующие классы class=navbox( {{ navbox }} ) или class=nomobile( {{ sidebar }} ), не отображаются в пространстве статей на мобильном веб-сайте английской Википедии. Просмотры мобильных страниц составляют примерно 68% всех просмотров страниц (90-дневное среднее значение по состоянию на сентябрь 2024 г. [update]). Вкратце, эти шаблоны не включены в статьи, потому что 1) они плохо разработаны для мобильных устройств и 2) они значительно увеличивают размеры страниц — плохо для мобильных загрузок — таким образом, что это бесполезно для мобильного использования. Вы можете просмотреть/посмотреть phab:T124168 для дальнейшего обсуждения.
Пожалуйста, удалите параметры, которые остались пустыми.
.svg/1280px-Test_Template_Info-Icon_-_Version_(2).svg.png){kind=icon}
{{ Navbox | name = {{ subst : PAGENAME }}{{ subst : void | Ничего не меняйте в этой строке. Она изменится сама, когда вы сохраните. }} | title = | listclass = hlist | state = {{{ state |}}}| выше = | изображение =| группа1 = | список1 =| группа2 = | список2 =| группа3 = | список3 =<!-- ... -->| ниже = }}< noinclude > {{ navbox documentation }} <!-- добавьте категорию navbox здесь --> </ noinclude >В навигационном поле используются строчные буквы в именах параметров, как показано в поле ( выше ). Требуемое имя и заголовок создадут однострочное поле, если другие параметры пропущены.
Обратите внимание, что «group1» (и т. д.) является необязательным, как и разделы с названиями «выше/ниже».
Основные и наиболее распространенные параметры следующие (полный список см. ниже):
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– левый текст перед list-n (если group-n опущен, list-n простирается до левого края поля и по умолчанию применяется text-align:centerстиль).listn– текстовый список вики-ссылок с использованием формата викилиста .below– необязательный текст, отображаемый под разделом группы/списка.Ниже приведен полный список параметров для использования {{ Navbox }} . В большинстве случаев единственными обязательными параметрами являются name, title, и list1, хотя дочерние навигационные блоки даже не требуют их установки.
{{ Navbox }} разделяет многочисленные общие имена параметров с его родственными шаблонами, {{ Navbox with columns }} и {{ Navbox with collapible groups }} , для согласованности и простоты использования. Параметры, отмеченные звездочкой (*), являются общими для всех трех основных шаблонов.
{{subst:PAGENAME}}это значение как ярлык. Параметр имени является обязательным, только если 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>тегов. Эта настройка заставит блок быть видимым, когда он автономен (даже если за ним следуют другие блоки), отображая "[hide]", но затем он автоматически свернется, когда он находится внутри статьи:| state = <noinclude>expanded</noinclude>| state = {{{state<includeonly>|ваше_желаемое_начальное_состояние</includeonly>}}}<includeonly>|будет развернут при просмотре страницы шаблона отдельно.| состояние = {{{состояние<includeonly>|расширено</includeonly>}}}Все транслируемые статьи показывают содержимое по умолчанию, если только нет гипотетической статьи, которая указывает, {{templatename|state=collapsed}}когда транслируется.| состояние = {{{состояние<includeonly>|свернуто</includeonly>}}}Все включенные статьи по умолчанию будут отображать свернутый шаблон, но при отображении на собственной странице шаблон все равно будет развернутым.stateпараметр. Его можно добавить в <noinclude>...</noinclude>раздел после определения шаблона или в инструкции на {{ documentation subpage }} .plain, ссылки V • T • E на левой стороне заголовка не будут отображаться, а отступ будет автоматически использоваться для центрирования заголовка. Используйте offдля удаления ссылок V • T • E , но не применяйте отступ (это только для продвинутого использования; вариант «plain» должен быть достаточен для большинства приложений, где панель навигации нежелательна). Настоятельно рекомендуется не скрывать панель навигации, чтобы пользователям было проще редактировать шаблон и сохранить стандартный стиль на всех страницах.childили subgroup, то навигационный блок можно использовать как дочерний элемент без границ, который плотно вписывается в другой навигационный блок. Граница скрыта, а по бокам таблицы нет отступов, поэтому он вписывается в область списка своего родительского навигационного блока. Если установлено значение none, то граница скрыта, отступы удалены, и навигационный блок можно использовать как дочерний элемент другого контейнера (не используйте параметр noneвнутри другого навигационного блока; аналогично, используйте только параметр child/ subgroupвнутри другого навигационного блока). Если установлено значение любого другого (по умолчанию), то обычный навигационный блок отображается с границей в 1 пиксель. Альтернативный способ указать границу как стиль подгруппы выглядит следующим образом (т. е. используйте первый неименованный параметр вместо именованного параметра границы ):{{Navbox|дочерний|...}}{{-}}для обеспечения надлежащего центрирования. Этот параметр технически не является обязательным, но использование {{ Navbox }} довольно бессмысленно без заголовка.<div> </div>как минимум один параметр списка ; каждый дополнительный список отображается в отдельной строке таблицы. Каждому списку n может предшествовать соответствующий параметр группы n , если он указан (см. ниже).childили , subgroupчтобы обозначить, что список использует встроенные #Child навигационные блоки (не работает с {{ Navbox with columns }} или {{ Navbox with collapsible groups }} ).[[Файл:</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 = 9emlist5style = 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;Настройки стиля, перечисленные здесь, — это те, которые редакторы, использующие navbox, меняют чаще всего. Другие, более сложные настройки стиля, были исключены из этого списка, чтобы сделать его простым. Большинство стилей задаются в Module:Navbox/styles.css .
bodystyle = background : # fdfdfd ; width : 100 %; vertical-align : middle ; titlestyle = background : # ccccff ; padding-left : 1em ; padding-right : 1em ; text-align : center ; abovestyle = background : # ddddff ; padding-left : 1em ; padding-right : 1em ; text-align : center ; belowstyle = background : # ddddff ; padding-left : 1em ; padding-right : 1em ; text-align : center ; groupstyle = background : # ddddff ; padding-left : 1em ; padding-right : 1em ; text-align : right ; liststyle = background : transparent ; text-align : left / center ; oddstyle = background : transparent ; evenstyle = фон : # f7f7f7 ; Так как liststyle и oddstyle прозрачны, нечетные списки имеют цвет 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 .Этот шаблон поддерживает добавление информации микроформата. Это делается путем добавления атрибутов "class" к различным ячейкам данных, указывающих, какой тип информации содержится внутри. Например, чтобы пометить navbox как содержащий информацию hCard о человеке, добавьте следующий параметр:
| bodyclass = vcard
и
| titleclass = fn
или (например):
| title = Книги <span class="fn">[[Иэна Бэнкса]]</span>
...и так далее.
Дополнительную информацию о добавлении информации о микроформатах в Википедию см . в разделе Wikipedia:WikiProject Microformats , а также в разделе microformat для получения дополнительной информации о микроформатах в целом.
Таблица, созданная {{ Navbox }} без параметров изображения , выше и ниже (серый цвет фона списка добавлен только для иллюстрации):
Таблица, созданная {{ Navbox }} с параметрами изображения , выше и ниже (цвет фона серого списка добавлен только для иллюстрации):
Таблица, созданная {{ Navbox }} с изображением , imageleft , списками и без групп , сверху , снизу (серый цвет фона списка добавлен только для иллюстрации):
{{ Navbox | имя = Navbox/doc | заголовок = [[ MSC Malaysia ]] | listclass = hlist| группа1 = Центр | list1 =
* [[ Сайберджая ]]| group2 = Область | list2 =
* [[ Долина Кланг ]]| группа3 = Основные достопримечательности | list3 =
* [[ Башни-близнецы Петронас ]]
* [[ Башня Куала-Лумпур ]]
* [[ Центральный Куала-Лумпур ]]
* [[ Технологический парк Малайзии ]]
* [[ Путраджайя ]]
* [[ Киберджая ]]
* [[ Куала Международный аэропорт Лумпур ]]| group4 = Инфраструктура | list4 =
* [[ Скоростная железнодорожная линия ]]
* [[ Выделенная скоростная автомагистраль KL-KLIA ]]| group5 = Prime-приложения | list5 =
* [[ Электронное правительство ]]
* [[ MyKad ]] }}Можно разместить несколько навигационных блоков в пределах одной границы. Они могут быть указаны либо в строке, либо с помощью вложенного шаблона навигационного блока, хотя последний метод может привести к значительно большему размеру включаемого пост-расширения .
Чтобы указать дочерние навигационные окна в строке, установите параметр на или . Элементы дочернего навигационного окна можно указать, добавив , или просто к именам параметров (например ). Дочерние навигационные окна можно вложить, добавив дополнительный префикс (например ). Базовый код для этого выглядит следующим образом (который добавляет подгруппу для первой области группы/списка):listnchildsubgroupchildn_subgroupn_n_1_list11_1_list1
{{Навигационный блок| имя = {{subst:PAGENAME}}| название = Название| группа1 = [необязательно]| список1 = ребенок | 1_title = [необязательно] | 1_group1 = [необязательно] | 1_list1 = ребенок | 1_1_title = [необязательно] | 1_1_group1 = [необязательно] | 1_1_list1 = ...содержимое списка... ......}}Чтобы указать дочерние навигационные окна с помощью вложенного шаблона, используйте "child" в качестве первого параметра или задайте параметр border . Базовый код для этого выглядит следующим образом (который добавляет подгруппу для первой группы/области списка):
{{Навигационный блок| имя = {{subst:PAGENAME}}| название = Название| группа1 = [необязательно]| list1 = {{Navbox|дочерний ...параметры дочернего навигационного блока... }}...}}В этом примере показаны две подгруппы и подподгруппа, созданные с использованием ключевых слов childи subgroup(оба взаимозаменяемы). Чередование чередуется автоматически. Чтобы полностью убрать чередование, вы можете установить в каждом.childn_liststyle = background:transparent;
Пример ниже создан с использованием обычного navbox для основного контейнера, затем его параметры list1, list2 и list3 содержат childключевое слово. Ссылки на панель навигации view (v), talk (t), edit (e) автоматически скрываются, поскольку используется ключевое слово "child" или "subgroup", поэтому использование navbar = plainfor для каждого из них не является необходимым. Код используется для копирования функциональности {{ Navbox with collapsible groups }} .N_state = {{#ifeq:{{{selected|}}|ABBREVIATION|uncollapsed|{{{stateN|collapsed}}}}}abbrN = ABBREVIATION
Этот шаблон navbox работает в сочетании с двумя другими шаблонами: {{ Navbox with columns }} и {{ Navbox with collapsible groups }} . Все три шаблона имеют общие параметры для обеспечения согласованности и простоты использования (такие параметры отмечены звездочкой (*) в списке описаний параметров выше). Самое главное, что каждый шаблон может использоваться как дочерний по отношению друг к другу (используя параметр |border=childили указав первый неименованный параметр как child. Например: {{Navbox|child ...}}, {{Navbox with columns|child ...}}или {{Navbox with collapsible groups|child ...}}.)
bodystyle = background:purple;), то вам нужно сделать так, чтобы border-left-color совпадал с цветом фона (т. е. liststyle = border-left-color: purple;). Если вы хотите иметь границу вокруг каждой ячейки списка, то граница шириной 2 пикселя между ячейками списка и ячейками группы исчезнет; вам придется придумать свое собственное решение.style/bodystyle, то это не будет работать.bodystyle = width: 22em; float: right; margin-left: 1em; margin-right: 0;{{ #invoke : Navbox | navbox | name = {{ subst : PAGENAME }} | title = Заголовок| group1 = [необязательно] | list1 = {{ #invoke : Navbox | navbox | child ...параметры дочернего навигационного блока... }}...}}Если вы пытаетесь скопировать {{Navbox}} в локальную вики, необходимо установить или скопировать еще несколько вещей:
Add support to mw-collapsible for autocollapse, innercollapse and outercollapseскрипт из MediaWiki:Common.js , если требуется автоматическое сворачивание.TemplateData для Navbox
Создает навигационное поле для ссылок на другие страницы. Не отображается на мобильных устройствах.
hlisthlist