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

<includeonly>{{СИШ|94}}{{esoteric}}</includeonly><noinclude>{{docpage}}</noinclude>
{{Внимание|Если вы переносите шаблон из английской Википедии, используйте [[Шаблон:Navbox]]}}

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

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

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

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

 |заголовок2   = 
 |список2      = <div style="margin-top:-1ex;margin-bottom:-1ex;padding:0">
{{Nowrap begin}}
[[Ссылка на статью1]]{{•wrap}}
[[Ссылка на статью2]]{{•wrap}}
[[Ссылка на статью3]]
{{Nowrap end}}
</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>

:; ''стиль_тела'' {{nobold|или}} ''стиль''
:: 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; нужно для того, чтобы при просмотре шаблона на его странице он всегда оставался в раскрытом состоянии).

:; ''navbar''
:: Значение по умолчанию — <code>Tnavbar</code>. Если указано значение <code>plain</code>, ссылки {{Tnavbar|Navbox generic|mini=1}} в левой части заголовка показаны не будут.

== Оформление списков ==

В случае, если список ссылок содержит много ссылок, его становится неудобно редактировать. В этом случае список можно разбить на отдельные строки. Но поскольку шаблон некорректно отрабатывает многострочные аргументы, такие списки следует заключать в теги <code>&lt;div&gt;&lt;/div&gt;</code>. А чтобы избавиться от отступов сверху и снизу, добавляемых этими тегами, можно использовать параметр <code>style=</code>.

<!---------- многострочные списки без div ---------->
{| width="100%" style="background:transparent"
| valign="top" | {{начало цитаты}}
{{Навигационная таблица
|navbar                    = plain
|state                     = nocollapse
|заголовок                 = однострочные списки
|стиль_четных              = background:#f0f0f0

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

|заголовок2   = 2
|список2      = бла-бла бла-бла бла-бла
}}
{{oq||<source lang="text">
{{Навигационная таблица
|navbar                    = plain
|state                     = nocollapse
|заголовок                 = однострочные списки
|стиль_четных              = background:#f0f0f0

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

|заголовок2   = 2
|список2      = бла-бла бла-бла бла-бла
}}
</source>}}
{{конец цитаты}}
| valign="top" | <!---------- ---------->
{{начало цитаты}}
{{Навигационная таблица
|navbar                    = plain
|state                     = nocollapse
|заголовок                 = многострочные списки без div
|стиль_четных              = background:#f0f0f0

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

|заголовок2   = 2
|список2      =
бла-бла
бла-бла
бла-бла
}}
{{oq||<source lang="text">
{{Навигационная таблица
|navbar                    = plain
|state                     = nocollapse
|заголовок                 = многострочные списки без div
|стиль_четных              = background:#f0f0f0

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

|заголовок2   = 2
|список2      =
бла-бла
бла-бла
бла-бла
}}
</source>}}
{{конец цитаты}}
|-<!---------- многострочные списки с div ---------->
| valign="top" | {{начало цитаты}}
{{Навигационная таблица
|navbar                    = plain
|state                     = nocollapse
|заголовок                 = однострочные списки
|стиль_четных              = background:#f0f0f0

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

|заголовок2   = 2
|список2      = бла-бла бла-бла бла-бла
}}
{{oq||<source lang="text">
{{Навигационная таблица
|navbar                    = plain
|state                     = nocollapse
|заголовок                 = однострочные списки
|стиль_четных              = background:#f0f0f0

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

|заголовок2   = 2
|список2      = бла-бла бла-бла бла-бла
}}
</source>}}
{{конец цитаты}}
|<!---------- ---------->
{{начало цитаты}}
{{Навигационная таблица
|navbar                    = plain
|state                     = nocollapse
|заголовок                 = многострочные списки с div
|стиль_четных              = background:#f0f0f0

|заголовок1   = 1
|список1      =<div>
бла-бла
бла-бла
бла-бла
</div>

|заголовок2   = 2
|список2      =<div>
бла-бла
бла-бла
бла-бла
</div>
}}
{{oq||<source lang="text">
{{Навигационная таблица
|navbar                    = plain
|state                     = nocollapse
|заголовок                 = многострочные списки с div
|стиль_четных              = background:#f0f0f0

|заголовок1   = 1
|список1      =<div>
бла-бла
бла-бла
бла-бла
</div>

|заголовок2   = 2
|список2      =<div>
бла-бла
бла-бла
бла-бла
</div>
}}
</source>}}
{{конец цитаты}}
|-<!---------- div с параметрами ---------->
|{{начало цитаты}}
{{Навигационная таблица
|navbar                    = plain
|state                     = nocollapse
|заголовок                 = однострочные списки
|стиль_четных              = background:#f0f0f0

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

|заголовок2   = 2
|список2      = бла-бла бла-бла бла-бла
}}
{{oq||<source lang="text">
{{Навигационная таблица
|navbar                    = plain
|state                     = nocollapse
|заголовок                 = однострочные списки
|стиль_четных              = background:#f0f0f0

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

|заголовок2   = 2
|список2      = бла-бла бла-бла бла-бла
}}
</source>}}
{{конец цитаты}}
|<!---------- ---------->
{{начало цитаты}}
{{Навигационная таблица
|navbar                    = plain
|state                     = nocollapse
|заголовок                 = div с параметрами
|стиль_четных              = background:#f0f0f0

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

|заголовок2   = 2
|список2      =<div style="margin-top:-1ex;margin-bottom:-1ex;padding:0">
бла-бла
бла-бла
бла-бла
</div>
}}
{{oq||<source lang="text">
{{Навигационная таблица
|navbar                    = plain
|state                     = nocollapse
|заголовок                 = div с параметрами
|стиль_четных              = background:#f0f0f0

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

|заголовок2   = 2
|список2      =<div style="margin-top:-1ex;margin-bottom:-1ex;padding:0">
бла-бла
бла-бла
бла-бла
</div>
}}
</source>}}
{{конец цитаты}}
|}

== Примеры ==

=== Без изображения ===
{{начало цитаты}}
{{Навигационная таблица
|имя        = Навигационная таблица/Документация
|state      = uncollapsed
|заголовок  = MSC ([[Multimedia Super Corridor]]) Malaysia{{-}}''без изображения''

|заголовок1 = Centre
|список1 = [[Cyberjaya]]

|заголовок2 = Area
|список2 = [[Klang Valley]]

|заголовок3 = Major landmarks
|список3 = [[Petronas Twin Towers]]{{*}}[[Kuala Lumpur Tower]]{{*}}[[Kuala Lumpur Central]]{{*}}[[Technology Park Malaysia]]{{*}}[[Putrajaya]]{{*}}[[Cyberjaya]]{{*}}[[Kuala Lumpur International Airport]]

|заголовок4 = Infrastructure
|список4 = [[Express Rail Link]]{{*}}[[KL-KLIA Dedicated Expressway]]

|заголовок5 = Prime applications
|список5 = [[EGovernment]]{{*}}[[MyKad]]
}}
{{oq||<source lang="text">
{{Навигационная таблица
|имя        = Навигационная таблица/Документация
|state      = uncollapsed
|заголовок  = MSC ([[Multimedia Super Corridor]]) Malaysia{{-}}''без изображения''

|заголовок1 = Centre
|список1 = [[Cyberjaya]]

|заголовок2 = Area
|список2 = [[Klang Valley]]

|заголовок3 = Major landmarks
|список3 = [[Petronas Twin Towers]]{{*}}[[Kuala Lumpur Tower]]{{*}}[[Kuala Lumpur Central]]{{*}}[[Technology Park Malaysia]]{{*}}[[Putrajaya]]{{*}}[[Cyberjaya]]{{*}}[[Kuala Lumpur International Airport]]

|заголовок4 = Infrastructure
|список4 = [[Express Rail Link]]{{*}}[[KL-KLIA Dedicated Expressway]]

|заголовок5 = Prime applications
|список5 = [[EGovernment]]{{*}}[[MyKad]]
}}
</source>}}
{{конец цитаты}}

=== С изображением ===
{{начало цитаты}}
{{Навигационная таблица
|имя         = Навигационная таблица/Документация
|state       = uncollapsed
|заголовок   = MSC ([[Multimedia Super Corridor]]) Malaysia{{-}}''с изображением''
|изображение = [[Файл:Flag of Malaysia.svg|120px]]

|заголовок1 = Centre
|список1 = [[Cyberjaya]]

|заголовок2 = Area
|список2 = [[Klang Valley]]

|заголовок3 = Major landmarks
|список3 = [[Petronas Twin Towers]]{{*}}[[Kuala Lumpur Tower]]{{*}}[[Kuala Lumpur Central]]{{*}}[[Technology Park Malaysia]]{{*}}[[Putrajaya]]{{*}}[[Cyberjaya]]{{*}}[[Kuala Lumpur International Airport]]

|заголовок4 = Infrastructure
|список4 = [[Express Rail Link]]{{*}}[[KL-KLIA Dedicated Expressway]]

|заголовок5 = Prime applications
|список5 = [[EGovernment]]{{*}}[[MyKad]]
}}
{{oq||<source lang="text">
{{Навигационная таблица
|имя         = Навигационная таблица/Документация
|state       = uncollapsed
|заголовок   = MSC ([[Multimedia Super Corridor]]) Malaysia{{-}}''с изображением''
|изображение = [[Файл:Flag of Malaysia.svg|120px]]

|заголовок1 = Centre
|список1 = [[Cyberjaya]]

|заголовок2 = Area
|список2 = [[Klang Valley]]

|заголовок3 = Major landmarks
|список3 = [[Petronas Twin Towers]]{{*}}[[Kuala Lumpur Tower]]{{*}}[[Kuala Lumpur Central]]{{*}}[[Technology Park Malaysia]]{{*}}[[Putrajaya]]{{*}}[[Cyberjaya]]{{*}}[[Kuala Lumpur International Airport]]

|заголовок4 = Infrastructure
|список4 = [[Express Rail Link]]{{*}}[[KL-KLIA Dedicated Expressway]]

|заголовок5 = Prime applications
|список5 = [[EGovernment]]{{*}}[[MyKad]]
}}
</source>}}
{{конец цитаты}}

=== С изображением и стилями ===
{{начало цитаты}}
{{Навигационная таблица
|имя              = Навигационная таблица/Документация
|state            = uncollapsed
|заголовок        = MSC ([[Multimedia Super Corridor]]) Malaysia{{-}}''с изображением, списки без переноса слов в ссылках, белый фон списков и чётные списки со светло-серым фоном, нижняя строка светло-голубого цвета и выровнена по центру''
|изображение = [[Файл:Flag of Malaysia.svg|120px]]
|стиль_тела = background-color:white
|стиль_четных = background:#f0f0f0

|заголовок1 = Centre
|список1 = [[Cyberjaya]]

|заголовок2 = Area
|список2 = [[Klang Valley]]

|заголовок3 = Major landmarks
|список3 =<div style="margin-top:-1ex;margin-bottom:-1ex;padding:0">
{{nobr|[[Petronas Twin Towers]] •}}
{{nobr|[[Kuala Lumpur Tower]] •}}
{{nobr|[[Kuala Lumpur Central]] •}}
{{nobr|[[Technology Park Malaysia]] •}}
{{nobr|[[Putrajaya]] •}}
{{nobr|[[Cyberjaya]] •}}
{{nobr|[[Kuala Lumpur International Airport]]}}
</div>

|заголовок4 = Infrastructure
|список4 = [[Express Rail Link]]{{*}}[[KL-KLIA Dedicated Expressway]]

|заголовок5 = Prime applications
|список5 = [[EGovernment]]{{*}}[[MyKad]]

|стиль_внизу = background:#ddddff
|внизу = Website: [http://www.msc.com.my/ www.msc.com.my]
}}
{{oq||<source lang="text">
{{Навигационная таблица
|имя              = Навигационная таблица/Документация
|state            = uncollapsed
|заголовок        = MSC ([[Multimedia Super Corridor]]) Malaysia{{-}}''с изображением, списки без переноса слов в ссылках, белый фон списков и чётные списки со светло-серым фоном, нижняя строка светло-голубого цвета и выровнена по центру''
|изображение = [[Файл:Flag of Malaysia.svg|120px]]
|стиль_тела = background-color:white
|стиль_четных = background:#f0f0f0

|заголовок1 = Centre
|список1 = [[Cyberjaya]]

|заголовок2 = Area
|список2 = [[Klang Valley]]

|заголовок3 = Major landmarks
|список3 =<div style="margin-top:-1ex;margin-bottom:-1ex;padding:0">
{{nobr|[[Petronas Twin Towers]] •}}
{{nobr|[[Kuala Lumpur Tower]] •}}
{{nobr|[[Kuala Lumpur Central]] •}}
{{nobr|[[Technology Park Malaysia]] •}}
{{nobr|[[Putrajaya]] •}}
{{nobr|[[Cyberjaya]] •}}
{{nobr|[[Kuala Lumpur International Airport]]}}
</div>

|заголовок4 = Infrastructure
|список4 = [[Express Rail Link]]{{*}}[[KL-KLIA Dedicated Expressway]]

|заголовок5 = Prime applications
|список5 = [[EGovernment]]{{*}}[[MyKad]]

|стиль_внизу = background:#ddddff
|внизу = Website: [http://www.msc.com.my/ www.msc.com.my]
}}
</source>}}
{{конец цитаты}}

== См. также ==
* {{tl|Навигационная таблица2}}
* {{tl|навигационная полоса}}
* {{tl|боковая навигационная таблица}}
* {{tl|hider}}
* {{tl|навигационная подтаблица}}
* {{tl|навигационный блок}} и версия для него: {{tl|навигационная таблица2}}
* {{tl|навигационная таблица со сворачиваемыми группами}}
* {{tl|Navbox subgroups}}
* {{tl|Навигационная карточка музыканта}}
*{{tl|Сворачивающийся список}}
* [[Википедия:Сворачивающиеся блоки]]

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

</includeonly>