Редактирование: Шаблон:Навигация/Документация

{{Плашка|text=Это один из самых используемых шаблонов. Редактируя его, вы создаёте колоссальную нагрузку на сервер. Так что сперва хорошенько подумайте.|title=Внимание!|imgwidth=32}}

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

== Заготовка для копирования ==
Заготовка ниже предназначена для копирования в новые шаблоны для облегчения их оформления:
<pre>
{{Навигация
 |имя                       = {{подст:PAGENAME}}
 |state                     =  
 |стиль_основного_заголовка = 
 |заголовок                 = 
 |изображение               = 
 |стиль_тела                = <!-- (или "стиль =" если никакие другие стилевые атрибуты не используются) -->
 |стиль_заголовков          = 
 |стиль_списков             = 
 |стиль_нечетных            = 
 |стиль_четных              = background:#f0f0f0

 |стиль_вверху = 
 |вверху       = 

 |заголовок1   = 
 |список1      = 

 |заголовок2   = 
 |список2      = <div style="margin-top:-1ex;margin-bottom:-1ex;padding:0">
</div>

...

 |заголовок23  = 
 |список23     = 

 |стиль_внизу  = 
 |внизу        = 
}}<noinclude>

[[Категория:Википедия:Навигационные шаблоны|{{PAGENAME}}]]
</noinclude>
</pre>

== Параметры ==

=== Обязательные ===
:; ''имя''
:: Имя шаблона, необходимое для корректной работы ссылки на редактирование шаблона. Для простоты можно использовать <code><nowiki>{{subst:PAGENAME}}</nowiki></code>.

:; ''заголовок''
:: Текст, отображаемый в верхней строке таблицы. Обычно это тема шаблона, краткое описание его содержания. Это как правило одна строка, но если требуется отобразить текст в двух строках, используйте <code><nowiki>{{-}}</nowiki></code> для корректного центрирования.
:: Цвета фона по умолчанию — <code><span style="background:#ccf; color:black;">#ccf</span></code> (сокращенная форма от <code><span style="background: #ccccff;">#ccccff</span></code>), он может быть изменен через параметр ''стиль_основного_заголовка'' (см. ниже).

:; ''список<sub>n</sub>''
:: (то есть ''список1'', ''список2'' и т. д.) Тело шаблона, как правило набор ссылок. Элементы списка должны быть указаны на одной строке, но заключив их в <code><nowiki><div> </div></nowiki></code> , можно использовать перенос строки (см. [[#Пример с исходным кодом]]). Должен быть указан крайней мере один параметр ''список'' ; каждый дополнительный ''список'' отображается в отдельной строке таблицы. Каждый ''список<sub>n</sub>'' может быть сопровожден параметром ''заголовок<sub>n</sub>'' (см. ниже).
:: Цвета фона списка (и всей таблицы) по умолчанию — <code><span style="background:#f9f9f9; color:black;">#f9f9f9</span></code>, он может быть изменен через параметры ''стиль_тела'', ''стиль_нечетных'' и/или ''стиль_четных'' (см. ниже).

=== Необязательные ===

==== Ячейки ====
:; ''заголовок<sub>n</sub>''
:: (то есть ''заголовок1'', ''заголовок2'' и т. д.) Если этот параметр указан, слева от ''списка<sub>n</sub>'' будет отображен заданный текст . Если параметр не указан, ''список<sub>n</sub>'' займет всю ширину таблицы.
:: Цвет фона по умолчанию — <code><span style="background:#ddf; color:black;">#ddf</span></code> (сокращенная форма от <code><span style="background: #ddddff;">#ddddff</span></code>), он может быть изменен через параметр ''стиль_заголовков'' (см. ниже).

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

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

:; ''внизу''
:: Ячейка во всю ширину таблицы, располагающаяся внизу тела шаблона (то есть под заголовками/списками и изображением). В шаблоне без изображения ''внизу'' аналогичен указанию последнего параметра ''список<sub>n</sub>'' без соответствующего ''заголовок<sub>n</sub>''.
<!-- Здесь возможно стоит добавить пример реального шаблона, использующего данный параметр -->

==== Стили ====
:; ''стиль_основного_заголовка''
:: [[Каскадная таблица стилей|CSS]]-стили, которые должны быть применены для ''основного_заголовка'', как правило цвет фона:
::: <code><nowiki>background:</nowiki>''#nnnnnn'';</code>
::: <code><nowiki>background:</nowiki>''name'';</code>

:; ''стиль_тела'' или ''стиль''
:: CSS-стили, которые должны быть применены для тела шаблона. Если никакие другие стилевые параметры не указываются, может быть использована сокращенная форма ''стиль''. Эта опция должна применяться в редких случаях, так как может вести к визуальным расхождениям. Примеры:
::: <code>background:#''nnnnnn'';</code>
::: <code>text-align:[''right/center/left/justified''];</code>
::: <code>width:''N''[em/%/px];</code>
::: <code>float:[''left/right/none''];</code>
::: <code>clear:[''right/left/both/none''];</code>
:: Для получения таблицы, похожей на вариант из англовики [[:en:template:navbar]], нужно задать стиль:
::: <code>|стиль_тела= font-size:85%;</code>

:; ''стиль_заголовков''
:: CSS-стили, которые должны быть применены для ячеек ''заголовок<sub>n</sub>''. Этот параметр имеет более высокий приоритет по сравнению со стилями, примененными к таблице целиком. Примеры:
::: <code>background:#''nnnnnn'';</code>
::: <code>text-align:[''left/center/right''];</code>
::: <code>vertical-align:[''top/middle/bottom''];</code>
::: <code>white-space:nowrap;</code>

:; ''стиль_списков''
:: CSS-стили, которые должны быть применены ко всем спискам. Имеет более низкий приоритет по сравнению с параметрами ''стиль_нечетных'' и ''стиль_четных'' (если они указаны).

:; ''стиль_нечетных''
:; ''стиль_четных''
:: CSS-стили, которые должны быть применены к нечетным (''список1'', ''список3'' и т. д.) или четным (''список2'', ''список4'' и т. д.) спискам соответственно. Обычно используется для задания цвета фона (<code>background:#''nnnnnn'';</code>), для того чтобы получить строки таблицы перемежающегося цвета. <!-- Здесь не мешало бы добавить пример -->

:; ''стиль_вверху''
:; ''стиль_внизу''
:: CSS-стили, которые должны быть применены к верхней (указанной параметром ''вверху'') и нижней (указанной параметром ''внизу'') ячейкам. Обычно используется для задания цвета фона или выравнивания текста:
::: <code>background:#''nnnnnn'';</code>
::: <code>text-align:[''left/center/right''];</code>

==== Другое ====
:; ''state''
:: По умолчанию — <code>autocollapse</code>. Если указано значение <code>state = collapsed</code>, навигационная таблица всегда будет появляться в скрытом состоянии. Если указано пустое значение или любое значение за исключением <code>autocollapse</code> и <code>collapsed</code>, навигационная таблица будет всегда появляться в раскрытом состоянии. Навигационная таблица с параметром <code>autocollapse</code> будет появляться в скрытом состоянии, если на странице есть две или более таблицы с атрибутом <tt>collapsible</tt>. Технически продвинутым сюда: [[MediaWiki:Common.js]].
:: Иногда редакторам требуется навигационный шаблон с состоянием по умолчанию, которое можно переопределить в статье. Для этого в Вашем промежуточном шаблоне создайте одноименный параметр «state», просто передающий значение базовому шаблону:
:: <tt><nowiki>| state = <includeonly>{{{state|состояние по умолчанию}}}</includeonly></nowiki></tt>
:: (&lt;includeonly&gt; нужно для того, чтобы при просмотре шаблона на его странице он всегда оставался в раскрытом состоянии).

== Пример ==

=== Обычный ===
{{Навигация
|имя = Ктулху
|state            = 
|заголовок        = [[Lovecraft/Cthulhu|Ктулху]] фхтагн!
|стиль_тела = background-color:white

|заголовок1 = История
|список1 = [[До засыпания]] • [[До пробуждения]] • [[Планы на будущее]]

|заголовок2 = Друзья
|список2 = [[Ньярли]] • [[Йог-Сотот]]

|заголовок3 = Любимые занятия
|список3 =<div style="margin-top:-1ex;margin-bottom:-1ex;padding:0"> 
[[Спать]] • [[Насылать сновидения]] • [[Призываться культистами]] • [[Пожирать культистов]] • [[Ждать парад планет]]</div>

|заголовок4 = Любимые книги
|список4 = [[Некрономикон]] • [[Собрание сочинений Говарда Лавкрафта]]
}}

Исходный код:

<pre>
{{Навигация
|имя = Ктулху
|state            = 
|заголовок        = [[Lovecraft/Cthulhu|Ктулху]] фхтагн!
|стиль_тела = background-color:white

|заголовок1 = История
|список1 = [[До засыпания]] • [[До пробуждения]] • [[Планы на будущее]] 

|заголовок2 = Друзья
|список2 = [[Ньярли]] • [[Йог-Сотот]]

|заголовок3 = Любимые занятия
|список3 =<div style="margin-top:-1ex;margin-bottom:-1ex;padding:0"> 
[[Спать]] • [[Насылать сновидения]] • [[Призываться культистами]] • [[Пожирать культистов]] • [[Ждать парад планет]]</div>

|заголовок4 = Любимые книги
|список4 = [[Некрономикон]] • [[Собрание сочинений Говарда Лавкрафта]]
}}</pre>

=== С картинками и кастомными стилями ===
{{Навигация
|имя = Ктулху
|state            = 
|заголовок        = [[Lovecraft/Cthulhu|Ктулху]] фхтагн!
|стиль_основного_заголовка = background:#ddffdd
|изображение = [[Файл:Fhtagn.jpg|120px]]
|стиль_тела = background-color:white
|стиль_четных = background:#f0f0f0

|заголовок1 = История
|список1 = [[До засыпания]] • [[До пробуждения]] • [[Планы на будущее]]

|заголовок2 = Друзья
|список2 = [[Ньярли]] • [[Йог-Сотот]]

|заголовок3 = Любимые занятия
|список3 =<div style="margin-top:-1ex;margin-bottom:-1ex;padding:0"> 
[[Спать]] • [[Насылать сновидения]] • [[Призываться культистами]] • [[Пожирать культистов]] • [[Ждать парад планет]]</div>

|заголовок4 = Любимые книги
|список4 = [[Некрономикон]] • [[Собрание сочинений Говарда Лавкрафта]]

|стиль_внизу = background:#ddffdd
|внизу = Website: [http://www.goominet.com/unspeakable-vault/ Unspeakable Vault (Of Doom)]
}}

Исходный код:

<pre>
{{Навигация
|имя = Ктулху
|state            = 
|заголовок        = [[Lovecraft/Cthulhu|Ктулху]] фхтагн!
|стиль_основного_заголовка = background:#ddffdd
|изображение = [[Файл:Fhtagn.jpg|120px]]
|стиль_тела = background-color:white
|стиль_четных = background:#f0f0f0

|заголовок1 = История
|список1 = [[До засыпания]] • [[До пробуждения]] • [[Планы на будущее]]

|заголовок2 = Друзья
|список2 = [[Ньярли]] • [[Йог-Сотот]]

|заголовок3 = Любимые занятия
|список3 =<div style="margin-top:-1ex;margin-bottom:-1ex;padding:0"> 
[[Спать]] • [[Насылать сновидения]] • [[Призываться культистами]] • [[Пожирать культистов]] • [[Ждать парад планет]]</div>

|заголовок4 = Любимые книги
|список4 = [[Некрономикон]] • [[Собрание сочинений Говарда Лавкрафта]]

|стиль_внизу = background:#ddffdd
|внизу = Website: [http://www.goominet.com/unspeakable-vault/ Unspeakable Vault (Of Doom)]
}}</pre>
<includeonly>

</includeonly>