Ҡалып:Навигационная таблица с колонками/doc
Ҡалып:Навигационная таблица с колонками · Документация · Фекер алышыу · Ҡайҙа ҡулланыла (Ҡалыпты ҡулланыу параметрҙары)
Данный шаблон позволяет быстро создавать Навигационную таблицу, содержимое которой разделено на колонки. Изначально предназначался для корректного отображения списка с национальными флагами стран.
Основной синтаксис
үҙгәртергәТолько обязательные параметры и параметр colwidth.
{{Навигационная таблица с колонками |name = {{subst:PAGENAME}} |заголовок = |colwidth = <!--желательно задавать значение по умолчанию для каждого столбца, используя такие пропорциональные единицы, как 'em' (по умолчанию 10em)--> |колонка1 = |col2 = }}
Параметры
үҙгәртергәОбязательные параметры выделены жирным шрифтом. Параметры, отмеченные знаком * являются общими для других подобных навигационных шаблонов: {{Навигационная таблица}} и {{Navbox with collapsible groups}}. Более подробное описание этих параметров содержится в документации к шаблону {{Навигационная таблица}}.
Установочные параметры
үҙгәртергә- name*
- Имя шаблона, необходимое для корректной работы ссылок "п · о · р" ("просмотр · обсуждение · редактирование") на всех страницах, где используется шаблон. Для простоты можно использовать
{{subst:PAGENAME}}
.
- state*
- Возможные значения:
collapsed
,uncollapsed
,plain
,off
, значение по умолчаниюautocollapse
. Подробнее см. {{Навигационная таблица}}.
- navbar*
- Возможные значения
plain
,off
, значение по умолчанию пусто. Подробнее см. {{Навигационная таблица}}.
- border*
- Возможные значения:
child
,none
, значение по умолчанию пусто. Используйте значениеchild
в том случае, если Вы хотите использовать этот шаблон внутри самого себя. В этом случае дочерний шаблон будет отображён без рамки и разместится внутри родительского шаблона. Родительским шаблоном может быть область списка {{Навигационная таблица}}, колонка другого шаблона {{Навигационная таблица с колонками}}, или секция {{Navbox with collapsible groups}}. Подробнее см. {{Навигационная таблица}}.
Основные информационные параметры
үҙгәртергә- заголовок*
- Текст, отображаемый в верхней строке таблицы. Обычно это тема шаблона, краткое описание его содержания. Это как правило одна строка, но если требуется отобразить текст в двух строках, используйте
{{-}}
для корректного центрирования. - Цвета фона по умолчанию —
#ccf
(сокращенная форма от#ccccff
), он может быть изменен через параметр стиль_основного_заголовка (см. ниже).
- вверху*
- Ячейка во всю ширину таблицы, располагающаяся непосредственно под основным заголовком (т.е. над колонками тела шаблона).
- изображение*
- Изображение, которое будет отображено в правой части таблицы (правее всех колонок). Параметр изображение допускает стандартный викикод для отображения, т.е.
[[Файл:Пример.jpg|100px]]
- В шаблоне, не растянутом на всю ширину страницы, изображение будет отображено со сдвигом от правого края шаблона. Для того, чтобы этого избежать, используйте параметр right в викикоде, т.е.
[[Файл:Пример.jpg|80px|right]]
- изображение_слева*
- Изображение, которое будет отображено в левой части таблицы
- внизу*
- Ячейка во всю ширину таблицы, располагающаяся внизу тела шаблона (т.е. под колонками и изображением).
Параметры стиля
үҙгәртергә- стиль_основного_заголовка*
- стиль_тела*
- CSS стили, которые должны быть применены для оформления тела шаблона (включая пространство между колонками). Если никакие другие стилевые параметры не указываются, может быть использована сокращенная форма стиль. Эта опция должна применяться в редких случаях, т.к. может вести к визуальным расхождениям. Примеры:
background:#nnnnnn;
text-align:[right/center/left/justified];
width:N [em/%/px];
float:[left/right/none];
clear:[right/left/both/none];
- стиль_заголовков*
- CSS стили, которые должны быть применены для оформления полосы заголовка; как правило цвет фона
background:цвет
(фон по умолчанию см. Википедия:Сворачивающиеся блоки). Примеры:стиль_заголовков = background:#nnnnnn;
стиль_заголовков = background:name;
- стиль_вверху*
- стиль_внизу*
- CSS стили, которые должны быть применены для оформления параметров вверху и внизу соответственно
- основной_стиль*
- CSS стили, которые должны быть применены для оформления параметров заголовок, вверху, и внизу одновременно
- стиль_изображения*
- CSS стили, которые должны быть применены для оформления параметра изображение
- стиль_изображения_слева*
- CSS стили, которые должны быть применены для оформления параметра изображение_слева
- стиль_колонки
- CSS стили, которые должны быть применены для оформления всех колонок; например,
background:цвет
см. выше стиль_заголовков
- стиль_нечетных_колонок
- стиль_четных_колонок
- CSS стили, которые должны быть применены для оформления всех чётных / нечётных колонок соответственно
- colnstyle
- CSS стили, которые должны быть применены для оформления только n-й колонки
- colheaderstyle
- CSS стили, которые должны быть применены для оформления заголовков всех колонок
- colnheaderstyle
- CSS стили, которые должны быть применены для оформления ячеек заголовокn колонки. Этот параметр имеет более высокий приоритет по сравнению со стилями, примененными к таблице целиком. Примеры:
background:#nnnnnn;
text-align:[left/center/right];
vertical-align:[top/middle/bottom];
white-space:nowrap;
- colnfooterstyle
- 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]
- Подробнее см. {{Навигационная таблица}}
- четные_нечетные
Примеры
үҙгәртергәПростой пример
үҙгәртергә{{Навигационная таблица с колонками |name = East Asia Summit (EAS) |заголовок = Member states of the [[East Asia Summit|East Asia Summit (EAS)]] |стиль_основного_заголовка = text-align:center |width = 18.25em |отступ = 10em |вверху = ''This is where the {{{вверху}}} would appear.'' |колонка1 = {{AUS}}<br /> {{BRU}}<br /> {{CAM}}<br /> {{IND}} |col2 = {{IDN}}<br /> {{JPN}}<br /> {{LAO}}<br /> {{MAS}} |col3 = {{MYA}}<br /> {{NZL}}<br /> {{CHN-PRC}}<br /> {{PHI}} |col4width=17em |col4 = {{SIN}}<br /> {{KOR}}<br /> {{THA}}<br /> {{VIE}} |внизу = '''Potential future members'''{{spaces|6}}{{TLS}}{{spaces|3}}{{RUS}} }}
Пример с относительной шириной колонок
үҙгәртергә{{Навигационная таблица с колонками | name = Plastics | заголовок = [[Plastic]]s | colwidth = 33% | стиль_колонки = text-align: center | колонка1 = [[Polyethylene]] (PE)<br />[[Polyethylene terephthalate]] (PET or PETE)<br />[[Polyvinyl chloride]] (PVC)<br />[[Polyvinylidene chloride]] (PVDC)<br />[[Polylactic acid]] (PLA) | col2 = [[Polypropylene]] (PP)<br />[[Polyamide]] (PA)<br />[[Polycarbonate]] (PC)<br />[[Polytetrafluoroethylene]] (PTFE)<br />[[Polyurethane]] (PU) | col3 = [[Polystyrene]] (PS)<br /> [[Polyester]]<br /> [[Acrylonitrile butadiene styrene]] (ABS)<br /> [[Acrylic glass|Polymethyl methacrylate]] (PMMA)<br /> [[Polyoxymethylene]] (POM) }}
Пример с colnheader и colnfooter
үҙгәртергәСерый фон колонок служит лишь для иллюстрации.
Пример с colnheader используя colnheadercolspan
үҙгәртергәСерый фон колонок служит лишь для иллюстрации. Этот пример демонстрирует использование параметра colnheadercolspan, хотя возможно также использование и параметра colnfootercolspan для объединения нижних ячеек.
Пример для демонстрации большинства полей
үҙгәртергәСерый фон колонок служит лишь для иллюстрации. По умолчанию фон колонок светло-серый, а текст выравнивается влево. Этот пример демонстрирует использование до шести дополнительных блоков / списков, следующих за колонками.
Использование дочерних шаблонов
үҙгәртергәВсе три типа навигационных полос: {{Навигационная таблица}}, {{Навигационная таблица с колонками}}, and {{Navbox with collapsible groups}}, поддерживают встраивание один в другого, используя значение border
(параметр, общий для всех этих шаблонов). В сложных шаблонах должна существовать подобная возможность для увеличения их функциональности.
Встроенный в самого себя навигационный шаблон с колонками
үҙгәртергәСледующий пример демонстрирует встраивание нескольких шаблонов {{Навигационная таблица с колонками}}. В примере есть один главный шаблон {{Навигационная таблица с колонками}} и два других, встроенных в него с параметром «child».
Другие встроенные навигационные шаблоны
үҙгәртергәСледующий пример демонстрирует применение вместе шаблонов {{Навигационная таблица}}, {{Навигационная таблица с блоками}} и {{Навигационная таблица с колонками}}. Обратите внимание, что у дочерних шаблонов значение первого параметра child
.
Шулай уҡ ҡарағыҙ
үҙгәртергә- {{Навигационная полоса}}
- {{Навигационная таблица}} — поддерживает блоки/списки вместо колонок
- {{Навигационная таблица с блоками}} — другой вариант навигационного шаблона