Шаблон:Навигационная таблица с колонками/doc

Материал из Народные Сказки
Версия от 21:41, 30 апреля 2024; Импортёр (обсуждение | вклад) (1 версия импортирована)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)

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

Основной синтаксис

Только обязательные параметры и параметры 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]
Подробнее см. {{Навигационная таблица}}

Примеры

Простой пример

Пример с относительной шириной колонок

Пример с colnheader и colnfooter

Серый фон колонок служит лишь для иллюстрации.

Пример с colnheader используя colnheadercolspan

Серый фон колонок служит лишь для иллюстрации. Этот пример демонстрирует использование параметра colnheadercolspan, хотя возможно также использование и параметра colnfootercolspan для объединения нижних ячеек.

Пример для демонстрации большинства полей

Серый фон колонок служит лишь для иллюстрации. По умолчанию фон колонок светло-серый, а текст выравнивается влево. Этот пример демонстрирует использование до шести дополнительных блоков / списков, следующих за колонками.

Использование дочерних шаблонов

Все три типа навигационных полос: {{Навигационная таблица}}, {{Навигационная таблица с колонками}} и {{Навигационная таблица с блоками}} поддерживают встраивание один в другой, используя значение |border = (параметр, общий для всех этих шаблонов). В сложных шаблонах должна существовать подобная возможность для увеличения их функциональности.

Встроенный в самого себя навигационный шаблон с колонками

Следующий пример демонстрирует встраивание нескольких шаблонов {{Навигационная таблица с колонками}}. В примере есть один главный шаблон {{Навигационная таблица с колонками}} и два других, встроенных в него с параметром child.

Другие встроенные навигационные шаблоны

Следующий пример демонстрирует применение вместе шаблонов {{Навигационная таблица}}, {{Навигационная таблица с блоками}} и {{Навигационная таблица с колонками}}. Обратите внимание, что у дочерних шаблонов значение первого параметра child.

См. также