Шаблон:Навигационная таблица с колонками/doc
Файл:Information icon4.svg |
Эта страница требует существенной переработки. |
Файл:OOjs UI icon info-progressive.svg | Этот шаблон использует некоторые чрезвычайно сложные и эзотерические свойства языка шаблонов. |
Данный шаблон позволяет быстро создавать Навигационную таблицу, содержимое которой разделено на колонки. Изначально предназначался для корректного отображения списка с национальными флагами стран.
Основной синтаксис[править код]
Только обязательные параметры и параметры colwidth и listclass.
{{Навигационная таблица с колонками |имя = {{Subst:PAGENAME}} |класс_списков = plainlist |заголовок = |ширина_колонок = <!--желательно задавать значение по умолчанию для каждого столбца, используя такие пропорциональные единицы, как 'em' (по умолчанию 10em)--> |колонка1 = |колонка2 = }}
Параметры[править код]
Обязательные параметры выделены жирным шрифтом. Параметры, отмеченные знаком * являются общими для других подобных навигационных шаблонов: {{Навигационная таблица}} и {{Навигационная таблица с блоками}}. Более подробное описание этих параметров содержится в документации к шаблону {{Навигационная таблица}}.
Установочные параметры[править код]
- имя* =
- name* =
- Имя шаблона, необходимое для ссылки Просмотр этого шаблона (переход к шаблону) на всех страницах, где используется шаблон. Для простоты можно использовать
{{подст:PAGENAME}}
. Если указан параметр|ссылка_на_просмотр = plain
, то этот параметр не используется.
- state*
- Возможные значения:
collapsed
,uncollapsed
,plain
,off
, значение по умолчаниюautocollapse
. Подробнее см. {{Навигационная таблица}}.
- navbar*
- Возможные значения
plain
,off
,white
, значение по умолчанию пусто. Подробнее см. {{Навигационная таблица}}.
- border*
- Возможные значения:
child
,none
,subgroup
, значение по умолчанию пусто. Используйте значениеchild
в том случае, если Вы хотите использовать этот шаблон внутри самого себя. В этом случае дочерний шаблон будет отображён без рамки и разместится внутри родительского шаблона. Родительским шаблоном может быть область списка {{Навигационная таблица}}, колонка другого шаблона {{Навигационная таблица с колонками}}, или секция {{Навигационная таблица с блоками}}. Подробнее см. {{Навигационная таблица}}.
Основные информационные параметры[править код]
- заголовок*
- Текст, отображаемый в верхней строке таблицы. Обычно это тема шаблона, краткое описание его содержания. Это как правило одна строка, но если требуется отобразить текст в двух строках, используйте
{{-}}
для корректного центрирования. - Цвета фона по умолчанию —
#cfe3ff
, он может быть изменен через параметр стиль_основного_заголовка (см. ниже).
- вверху*
- Ячейка во всю ширину таблицы, располагающаяся непосредственно под основным заголовком (т.е. над колонками тела шаблона).
- изображение*
- Изображение, которое будет отображено в правой части таблицы (правее всех колонок). Параметр изображение допускает стандартный викикод для отображения, т.е.
[[Файл:Пример.jpg|100px]]
- В шаблоне, не растянутом на всю ширину страницы, изображение будет отображено со сдвигом от правого края шаблона. Для того, чтобы этого избежать, используйте параметр right в викикоде, т.е.
[[Файл:Пример.jpg|80px|right]]
- изображение_слева*
- Изображение, которое будет отображено в левой части таблицы
- внизу*
- Ячейка во всю ширину таблицы, располагающаяся внизу тела шаблона (т.е. под колонками и изображением).
Параметры стиля[править код]
- titlestyle*
- стиль_основного_заголовка*
- Задает стиль для основного заголовка навигационной таблицы.
- bodystyle*
- стиль_тела*
- CSS стили, которые должны быть применены для оформления тела шаблона (включая пространство между колонками). Если никакие другие стилевые параметры не указываются, может быть использована сокращенная форма стиль. Эта опция должна применяться в редких случаях, т.к. может вести к визуальным расхождениям. Примеры:
background:#nnnnnn;
text-align:[right/center/left/justified];
width:N [em/%/px];
float:[left/right/none];
clear:[right/left/both/none];
- groupstyle
- стиль_групп
- CSS стили, которые должны быть применены для оформления заголовка списка; как правило цвет фона
background:цвет
(фон по умолчанию см. РуСказки:Сворачиваемые блоки). Примеры:стиль_групп = background:#nnnnnn;
стиль_групп = background:name;
- стиль_вверху*
- стиль_внизу*
- CSS стили, которые должны быть применены для оформления параметров вверху и внизу соответственно
- basestyle*
- стиль*
- CSS стили, которые должны быть применены для оформления параметров заголовок, вверху, и внизу одновременно
- imagestyle*
- стиль_изображения*
- CSS стили, которые должны быть применены для оформления параметра изображение
- imageleftstyle*
- стиль_изображения_слева*
- CSS стили, которые должны быть применены для оформления параметра изображение_слева
- colstyle
- стиль_колонок
- CSS стили, которые должны быть применены для оформления всех колонок; например,
background:цвет
см. выше стиль_заголовков
- oddcolstyle
- evencolstyle
- стиль_нечетных_колонок
- стиль_четных_колонок
- CSS стили, которые должны быть применены для оформления всех чётных / нечётных колонок соответственно
- colnstyle
- стиль_колонкиn
- CSS стили, которые должны быть применены для оформления только n-й колонки
- colheaderstyle
- стиль_заголовков_колонок
- CSS стили, которые должны быть применены для оформления заголовков всех колонок
- colnheaderstyle
- стиль_заголовка_колонкиn
- CSS стили, которые должны быть применены для оформления ячеек заголовокn колонки. Этот параметр имеет более высокий приоритет по сравнению со стилями, примененными к таблице целиком. Примеры:
background:#nnnnnn;
text-align:[left/center/right];
vertical-align:[top/middle/bottom];
white-space:nowrap;
- colfooterstyle
- стиль_низа_колонок
- CSS стили для оформления нижних ячеек колонок
- colnfooterstyle
- стиль_низа_колонкиn
- CSS стили для оформления нижней ячейки n-й колонки
Параметры колонок[править код]
- colwidth
- Ширина колонок, для которых не установлено значение colNwidth (см. ниже). Желательно использовать такие пропорциональные единицы, как 'em' или относительную величину в процентах. Значение по умолчанию 10em. Примеры:
colwidth = 15em
colwidth = 25%
- полная_ширина
- Если значение указано, тогда общая ширина всех колонок рассчитывается относительно этого значения. Обычно этот параметр не указывается. Если используется параметр colheader или colfooter, тогда полная_ширина используется автоматически. Примеры:
полная_ширина = true
- отступ
- Отступ перед первой колонкой, желательно в пропорциональных единицах. Значение по умолчанию 5em. Если отступ не нужен, установите значение 0 (или 0em, 0%).
- colnwidth
- Ширина n-й колонки (используется вместо значения colwidth).
- coln
- Содержимое n-й колонки (т.е. колонка1, col2 и т.д.) Тело шаблона, как правило набор ссылок. Элементы списка должны быть указаны на одной строке, но заключив их в
<div> </div>
, можно использовать перенос строки. Должен быть указан крайней мере один параметр колонка1; каждый дополнительный список отображается в отдельной колонке таблицы. Максимальное число колонок — 20. Каждый coln может быть сопровожден параметром colnheader. - Цвета фона списка (и всей таблицы) по умолчанию —
#f9f9f9
, он может быть изменен через параметры стиль_тела, стиль_нечетных и/или стиль_четных (см. ниже).
- colnheader
- Внимание! Без этого параметра таблица может отображаться некорректно. Ячейка заголовка n-й колонки. Отображается над колонкой.
- colnfooter
- Ячейка, которая отображается внизу n-й колонки.
- colnheadercolspan
- Значение, определяющее число колонок, которые объединяет n-й заголовок колонки. Значение по умолчанию 1. В случае, если значение больше 1, не указывайте в этом промежутке другие заголовки колонок. Например, если
отступ_заголовка_1колонки = 3
, следует оставить незаполненнымиcol2header
иcol3header
.
- colnfootercolspan
- Значение, определяющее число колонок, которые объединяет n-й нижняя ячейка. Значение по умолчанию 1. В случае, если значение больше 1, не указывайте в этом промежутке другие заголовки колонок. Например, если
отступ_низа_1колонки = 3
, следует оставить незаполненнымиcol2footer
иcol3footer
.
Дополнительные блоки / списки[править код]
Может понадобиться добавить дополнительные блоки и/или списки внизу колонок. Следующие параметры призваны сделать это возможным. Подробнее см. {{Навигационная таблица}}.
- groupn*
- Позволяет создавать 6 дополнительных блоков для отображения вместе со списками внизу колонок
- listn*
- Позволяет создавать 6 дополнительных списков внизу колонок
- стиль_группы*
- CSS стили, которые должны быть применены для оформления всех блоков.
- groupnstyle*
- CSS стили, которые должны быть применены для оформления параметра n-го блока
- стиль_списков*
- CSS стили, которые должны быть применены для оформления всех списков.
- listnstyle*
- CSS стили, которые должны быть применены для оформления параметра n-го списка
- отступ_списка*
- Величина отступа для ячеек в списке
- стиль_нечетных
- стиль_четных
- Определяет стиль оформления чётных / нечётных строк в списках. Перекрывает стили, определённые в параметре стиль_списков. По умолчанию чередует белый и чёрный цвета для чётных / нечётных строк, повышая читабельность списков.
- четные_нечетные
[swap, even, odd, off]
- Подробнее см. {{Навигационная таблица}}
- четные_нечетные
Примеры[править код]
Простой пример[править код]
{{Навигационная таблица с колонками
|имя = East Asia Summit (EAS)
|state = uncollapsed
|класс_списков = plainlist
|заголовок = Member states of the [[East Asia Summit|East Asia Summit (EAS)]]
|вверху = ''Появляется при используемом параметре {{Para|вверху}}.''
|колонка1 =
* {{Флагификация|Австралия}}
* {{Флагификация|Бруней}}
* {{Флагификация|Камбоджа}}
* {{Флагификация|Индия}}
|колонка2 =
* {{Флагификация|Индонезия}}
* {{Флагификация|Япония}}
* {{Флагификация|Лаос}}
* {{Флагификация|Малайзия}}
|колонка3 =
* {{Флагификация|Мьянма}}
* {{Флагификация|Новая Зеландия}}
* {{Флагификация|Китай}}
* {{Флагификация|Филиппины}}
|ширина_колонки4 = 17em;
|колонка4 =
* {{Флагификация|Сингапур}}
* {{Флагификация|Корея}}
* {{Флагификация|Таиланд}}
* {{Флагификация|Вьетнам}}
|внизу = '''Potential future members'''{{Nbsp|6}}{{Восточный Тимор}}{{Nbsp|3}}{{RUS}}
}}
Пример с относительной шириной колонок[править код]
{{Навигационная таблица с колонками
|имя = Пластмассы
|state = uncollapsed
|класс_списков = plainlist
|заголовок = [[Пластмассы]]
|ширина_колонок = 33%
|стиль_колонок = text-align:center
|колонка1 =
* [[Полиэтилен]] (PE)
* [[Полиэтилентерефталат]] (PET or PETE)
* [[Поливинилхлорид]] (PVC)
* [[Поливинилиденхлорид]] (PVDC)
* [[Полилактид]] (PLA)
|колонка2 =
* [[Полипропилен]] (PP)
* [[Полиамиды]] (PA)
* [[Поликарбонаты]] (PC)
* [[Полиуретаны]] (PU)
|колонка3 =
* [[Полистирол]] (PS)
* [[Полиэфиры]]
* [[Акрилонитрилбутадиенстирол]] (ABS)
* [[Органическое стекло|Полиметилметакрилат]] (PMMA)
* [[Полиформальдегид]] (POM)
}}
[править код]
Серый фон колонок служит лишь для иллюстрации.
Пример с colnheader используя colnheadercolspan[править код]
Серый фон колонок служит лишь для иллюстрации. Этот пример демонстрирует использование параметра colnheadercolspan, хотя возможно также использование и параметра colnfootercolspan для объединения нижних ячеек.
Пример для демонстрации большинства полей[править код]
Серый фон колонок служит лишь для иллюстрации. По умолчанию фон колонок светло-серый, а текст выравнивается влево. Этот пример демонстрирует использование до шести дополнительных блоков / списков, следующих за колонками.
Использование дочерних шаблонов[править код]
Все три типа навигационных полос: {{Навигационная таблица}}, {{Навигационная таблица с колонками}} и {{Навигационная таблица с блоками}} поддерживают встраивание один в другой, используя значение |border =
(параметр, общий для всех этих шаблонов). В сложных шаблонах должна существовать подобная возможность для увеличения их функциональности.
Встроенный в самого себя навигационный шаблон с колонками[править код]
Следующий пример демонстрирует встраивание нескольких шаблонов {{Навигационная таблица с колонками}}. В примере есть один главный шаблон {{Навигационная таблица с колонками}} и два других, встроенных в него с параметром child
.
Другие встроенные навигационные шаблоны[править код]
Следующий пример демонстрирует применение вместе шаблонов {{Навигационная таблица}}, {{Навигационная таблица с блоками}} и {{Навигационная таблица с колонками}}. Обратите внимание, что у дочерних шаблонов значение первого параметра child
.
См. также[править код]
- {{Навигационная полоса}}
- {{Навигационная таблица}} — поддерживает блоки/списки вместо колонок
- {{Навигационная таблица с блоками}} — другой вариант навигационного шаблона