Карточка

Править документацию

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

Применение

Принцип его применения очень похож на использование шаблона {{НавигацияКарточка}}, но с некоторыми отличиями. Каждая строка таблицы может быть как заголовком, так и содержать пару метка/данные или только ячейку с данными, но не одновременно. То есть, если вы определили строку в качестве заголовка и пары метка/данные, то метка/данные будет перезаписана.

Обратите внимание на то, что если вы хотите вставить изображение или другой тип данных не в верхней части карточки, то используйте лишь один параметр – "данные".

Параметры

Ссылки просмотр/обсуждение/редактировать

имя

Имя шаблона, необходимое для корректной работы ссылок "просмотр · обсуждение · редактировать" на всех страницах, где используется шаблон. Для простоты можно использовать {{subst:PAGENAME}}. Ссылки не будут сформированы без заполнения этого параметра.

Название

Текст заголовка над карточкой

(здесь остальная часть карточки)

Текст в самой первой ячейке карточки
(здесь остальная часть карточки)

Существует два различных способа размещения названия для карточки. Первый способ – это поместить название внутри рамки карточки, а второй – над нею. Вы можете использовать либо один из этих способов, либо оба сразу или вообще без названия, хотя этого делать и не рекомендуется.

название

Текст, отображаемый над карточкой. Обычно это тема шаблона, краткое описание его содержания.

вверху

Текст, отображаемый вверху таблицы. Альтернативный вариант размещения названия шаблона.

Основные

изображение

Изображение, которое будет отображено в верхней части шаблона. Этот параметр допускает стандартный викикод для отображения, например, [[Файл:Пример.jpg|200px]]. По-умолчанию изображение выравнивает по середине.

подпись

Подпись под изображением.

заголовок_n

Используется для создания заголовка в ряду n. Этот и следующие 2 параметра работают при 1≤n≤80.

метка_n

Используется для подписи текста в ряду n.

данные_n

Используется для принятия параметров в ряду n для специализированных шаблонов-карточек.

внизу

Ячейка во всю ширину таблицы, располагающаяся внизу тела шаблона (то есть под заголовками и метками/данными).

Стили CSS

стиль карточки

Применяется ко всей карточке, обычно используется для указания её ширины, например, width:300px;.

стиль названия

Применяется только к названию карточки. Изменение цвета фона не целесообразно, если название размещается вне карточки.

стиль вверху

Применяется к альтернативному заголовку, например, для указания цвета фона или изменения размера шрифта. По-умолчанию: font-size:large;, так как эта ячейка, как правило, используется для заголовков, но если вы хотите использовать её для обычного текста, тогда используйте значение: font-size:medium;.

стиль изображения

Применяется к ячейке, в которой располагается изображение вместе с его подписью. Если подпись планируется вынести за ячейку изображения, то необходимо отдельно указать значения в параметре |стиль подписи.

стиль подписи

Применяется к подписи изображения.

стиль заголовка

Применяется для всех ячеек с заголовком.

стиль метки

Применяется для всех ячеек с меткой.

стиль данных

Применяется для всех ячеек с данными.

стиль внизу

Применяется только к нижней ячейке.

Микроформаты

класс карточки

Этот параметр передаётся атрибуту "class" всей карточки.

класс изображения

Этот параметр передаётся атрибуту "class" изображения.

класс_n

Этот параметр применяется к определённому ряду, если текст в этом ряду определён.

класс названия

Этот параметр передаётся атрибуту "class" названия.

класс вверху

Этот параметр передаётся атрибуту "class" верхней ячейки.

Этот шаблон поддерживает микроформаты благодаря добавлению атрибутов "class" для различных ячеек, определяющих тип представленной в них информации. Например, для реализации микроформата hCard добавьте следующие параметры:

|класс карточки = vcard
|класс1 = fn
|класс2 = org
|класс3 = tel

...и т. д. "вверху" и "название" также могут быть переопределены, так как они часто используются для отображения названия темы карточки.

Для дополнительной информации смотрите статью Википедия – Микроформаты, а также сайт microformats.org (англ.).

Создание необязательных ячеек

Ряд с меткой, но без текста не будет отображён. Это позволяет легко создавать необязательные параметры в специализированных шаблонах-карточках. Для создания опциональной ячейки используйте параметр следующим образом:

|метка5   = Население
|данные5  = {{{население|}}}

Таким образом, если параметр |население не будет определён, то строка "Население" не будет отображена.

Для оформления параметра можно использовать функцию парсера #if. Например, следующие строки добавят к параметру |данные6 подпись "кг", если этот параметр определён:

|метка6  = Вес
|данные6 = {{#if:{{{вес|}}}|{{{вес}}} кг}}

Дополнительную информацию по функции #if смотрите здесь.

Таким же образом можно организовать необязательные заголовки. Если вы хотите, чтобы заголовок появлялся только при условии наличия данных в параметрах, то необходимо сделать следующее:

{{Карточка
|имя         = {{subst:PAGENAME}}
|название    = Пример необязательного заголовка
|заголовок1  = {{#if:{{{предмет1|}}}{{{предмет2|}}}{{{предмет3|}}}|Необязательный заголовок}}
|метка2      = Первый предмет
|данные2     = {{{предмет1|}}}
|метка3      = Второй предмет
|данные3     = {{{предмет2|}}}
|метка4      = Третий предмет
|данные4     = {{{предмет3|}}}
}}

Отобразиться заголовок1 только в том случае, если будет определён любой из параметров предмет1, предмет2 или предмет3.

Смысл заключается в том, что #if возвращает false только в том случае, если в условном операторе нет определённых значений, т. е. при неопределённости всех трёх параметров условный оператор завершит работу без вывода данных.

Примеры

Тестовая карточка

Подпись для "Пример.jpg"
Одиночный заголовок с определённым значением
Одиночные данные с определённым значением
Все три параметра определены (заголовок)
Метка и данные определены (метка)	Метка и данные определены (данные)
Текст внизу

{{Карточка
|имя               = Карточка/Док
|название          = Тестовая карточка
|изображение       = [[Файл:Пример.jpg|200px]]
|подпись           = Подпись для "Пример.jpg"

|стиль заголовка   = background:#888;
|стиль метки       = background:#888;

|заголовок1   = Одиночный заголовок с определённым значением
|метка1       = 
|данные1      = 
|заголовок2   = 
|метка2       = Одиночная метка с определённым значением
|данные2      = 
|заголовок3   = 
|метка3       = 
|данные3      = Одиночные данные с определённым значением
|заголовок4   = Все три параметра определены (заголовок)
|метка4       = Все три параметра определены (метка)
|данные4      = Все три параметра определены (данные)
|заголовок5   = 
|метка5       = Метка и данные определены (метка)
|данные5      = Метка и данные определены (данные)

|стиль внизу  = background:#888;
|внизу        = Текст внизу
}}

Напоминаем, что если метка определена без соответствующих данных, то эта ячейка отображена не будет, а если заголовок определён на той же строке, что и данные из ячейки, то приоритет имеет заголовок.

Например, стиль карточки = width:20em; и стиль метки = width:33%;

Тестовая карточка

Метка 1	Данные 1
Метка 2	Данные 2
Метка 3	Данные 3
Заголовок 4
Метка 5	Данные 5: Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Текст внизу

Пустой шаблон

Внимание: Этот шаблон на текущий момент поддерживает до 30 строк! Так же пропущены параметры для микроформатов.

{{Карточка
|имя                  = {{subst:PAGENAME}}
|стиль карточки       = 
|название             = 
|стиль названия       = 
|вверху               = 
|стиль вверху         = 
|изображение          = 
|стиль изображения    = 
|подпись              = 
|стиль подписи        = 
|стиль заголовка      = 
|стиль метки          = 
|стиль данных         = 

|заголовок1  = 
|метка1      = 
|данные1     = 
|заголовок2  = 
|метка2      = 
|данные2     = 
|заголовок3  = 
|метка3      = 
|данные3     = 
|заголовок4  = 
|метка4      = 
|данные4     = 
|заголовок5  = 
|метка5      = 
|данные5     = 
|заголовок6  = 
|метка6      = 
|данные6     = 
|заголовок7  = 
|метка7      = 
|данные7     = 
|заголовок8  = 
|метка8      = 
|данные8     = 
|заголовок9  = 
|метка9      = 
|данные9     = 
|заголовок10 = 
|метка10     = 
|данные10    = 

...

|заголовок30 = 
|метка30     = 
|данные30    = 

|стиль внизу =
|внизу = 
}}