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

Материал из свободной русской энциклопедии «Традиция»
Перейти к навигации Перейти к поиску


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

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

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

{{Навигационная таблица
 |имя                       = {{подст:PAGENAME}}
 |navbar                    = 
 |state                     = <includeonly>{{{state|autocollapse}}}</includeonly>
 |стиль                     = 
 |стиль_основного_заголовка = 
 |заголовок                 = 
 |изображение               = 
 |стиль_заголовков          = 
 |стиль_списков             = 
 |стиль_нечетных            = 
 |стиль_четных              = background:#f0f0f0

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

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

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

...

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

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

[[Категория:Традиция:Навигационные шаблоны]]
</noinclude>
Альтернативный способ оформления
{{Навигационная таблица
 |имя                       = {{подст:PAGENAME}}
 |navbar                    = 
 |state                     = <includeonly>{{{state|collapsed}}}</includeonly>
 |стиль                     = 
 |стиль_основного_заголовка = 
 |заголовок                 = 
 |изображение               = 
 |стиль_заголовков          = 
 |стиль_списков             = 
 |стиль_нечетных            = 
 |стиль_четных              = background:#F0F0F0

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

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

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

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

[[Категория:Традиция:Навигационные шаблоны]]
</noinclude>

Параметры[править код]

Обязательные[править код]

имя =
Имя шаблона, необходимое для ссылки  Просмотр этого шаблона  (переход к шаблону) на всех страницах, где используется шаблон. Для простоты можно использовать {{subst:PAGENAME}}. Если указан параметр |navbar=plain, то этот параметр не используется.
заголовок =
Текст, отображаемый в верхней строке таблицы. Обычно это тема шаблона, краткое описание его содержания.
список1 =
список2 =
Тело шаблона; как правило, набор ссылок. Элементы списка должны быть указаны на одной строке, но, заключив их в <div></div>, можно использовать перенос строки (см. ниже). Каждый список отображается в отдельной строке таблицы. Каждый списокn= может быть сопровождён параметром заголовокn= (см. ниже).

Необязательные[править код]

Ячейки[править код]

заголовок1 =
заголовок2 =
Если этот параметр указан, слева от соответствующего списокn= будет отображён заданный текст. Если параметр не указан, списокn= займёт всю ширину таблицы. Если для заголовокn= не будет указан списокn=, заголовок займёт всю ширину таблицы и будет отцентрирован.
изображение =
Изображение, которое будет показано под основным заголовком в правой части таблицы (правее заголовков/списков). Для того, чтобы изображение показывалось правильно, должен быть задан параметр список1=. Параметр изображение= допускает стандартный викикод для отображения, то есть
|изображение = [[Файл:Пример.jpg|100px]]
В шаблоне, не растянутом на всю ширину страницы, изображение будет показано со сдвигом от правого края шаблона. Для того, чтобы этого избежать, используйте параметр right в викикоде, то есть
|изображение = [[Файл:Пример.jpg|80px|right]]
вверху =
Ячейка во всю ширину таблицы, располагающаяся непосредственно под основным заголовком (над заголовками/списками тела шаблона). В шаблоне без параметра изображение= задание параметра вверху= аналогично заданию параметра список1= без заголовок1=, но при этом список из параметра вверху= по умолчанию будет отцентрирован.
внизу =
Ячейка во всю ширину таблицы, располагающаяся внизу тела шаблона (под заголовками/списками и изображением). В шаблоне без параметра изображение= задание параметра внизу= аналогично заданию последнего параметра списокn= без заголовокn=, но при этом список из параметра внизу= по умолчанию будет отцентрирован.

Стили[править код]

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

стиль_основного_заголовка =
Стили для параметра заголовок=. Как правило, цвет фона:
|стиль_основного_заголовка = background:#nnnnnn
|стиль_основного_заголовка = background:name
Цвет фона по умолчанию — #ccf (сокращённая форма от #ccccff).
стиль =
стиль_тела =
Стили для всего тела шаблона. Эти два параметра полностью взаимозаменяемы. Примеры аргументов этих параметров:
background:#nnnnnn
text-align:[right/center/left/justified]
width:N[em/%/px]
float:[left/right/none]
clear:[right/left/both/none]
Для получения таблицы, похожей на вариант из английской Википедии (см. Template:Navbar), нужно задать стиль
|стиль = font-size:85%
стиль_заголовков =
Стили для всех параметров заголовокn=. Этот параметр имеет более высокий приоритет, нежели стиль=. Примеры аргументов этого параметра:
background:#nnnnnn
text-align:[left/center/right]
vertical-align:[top/middle/bottom]
white-space:nowrap
Цвет фона по умолчанию — #ddf (сокращённая форма от #ddddff).
стиль_списков =
Стили для всех параметров списокn=. Этот параметр имеет более высокий приоритет, нежели стиль=.
Цвета фона списка (и всей таблицы) по умолчанию — #f9f9f9.
стиль_нечетных =
стиль_четных =
Стили для всех нечётных (список1=, список3= и т. д.) и чётных (список2=, список4= и т. д.) параметров. Эти параметры имеют более высокий приоритет, нежели стиль= и стиль_списков=. Обычно используются для задания цвета фона (background:#nnnnnn), чтобы получить строки таблицы с фоновой чересполосицей.
стиль_вверху =
стиль_внизу =
Стили для параметров вверху= и внизу=, соответственно. Обычно используются для задания цвета фона и выравнивания текста:
background:#nnnnnn
text-align:[left/center/right]

Другое[править код]

state =
По умолчанию (если параметр отсутствует или с пустым аргументом) — autocollapse. Если указано значение collapsed, навигационная таблица всегда будет появляться в свёрнутом состоянии. Синонимами аргументов autocollapse и collapsed являются autocollapsed и collapse. Для любого другого аргумента навигационная таблица будет всегда появляться в раскрытом состоянии. Навигационная таблица с параметром autocollapse будет появляться в скрытом состоянии, если на странице есть две или более таблицы с атрибутом collapsible (технические детали см. в MediaWiki:Common.js).
Иногда требуется навигационный шаблон с состоянием по умолчанию, которое можно переопределить в статье. Для этого в навигационном шаблоне используйте параметр state, просто передающий значение базовому шаблону (вместо состояние по умолчанию нужно подставить необходимое значение — например, autocollapse):
|state = <includeonly>{{{state|состояние по умолчанию}}}</includeonly>
(скобки <includeonly> нужны для того, чтобы при просмотре шаблона на его странице он всегда оставался в раскрытом состоянии). Соответственно, при использовании такого навигационного шаблона можно указывать его состояние, например:
{{наш навигационный шаблон|state=collapsed}}
navbar =
Значение по умолчанию — показывать ссылку  Просмотр этого шаблона  для перехода к шаблону, указанному в параметре имя=. Если указано значение plain, либо параметр имя= пустой или не задан, ссылка в левой части заголовка показана не будет.

Оформление списков[править код]

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







Примеры[править код]

Без изображения[править код]


С изображением[править код]


С изображением и стилями[править код]


См. также[править код]