Шаблон:Navbox (beta)/doc

Материал из Викиверситета


Комплект
навигационных шаблонов
{{Navbox (beta)}}
{{Navbox long (beta)}}
{{Navbox subgroup (beta)}}
{{Navbox subgroup long (beta)}}
{{Navbox with columns (beta)}}
{{Navbox with collapsible groups (beta)}}
{{Navboxes (beta)}}

Данный навигационный шаблон идентичен шаблону Navbox из англо-вики. Параметры — полностью аналогичны английскому варианту. Стили, заданные в английском Common.css и отсутствующие в нашем Common.css, перенесены из английского Common.css внутрь шаблона (за исключением ширины кнопки «скрыть/показать»). Для переноса шаблонов на основе Navbox из англо-вики к нам нужно скопировать весь кода шаблона и лишь добавить (beta) после Navbox (если есть вложенные шаблоны — добавить и у них).

Описание параметров[править]

{{Navbox (beta) |child    - ключ вложения шаблона внутрь самого себя
|name           = имя шаблона
|state          = сворачиваемость
|navbar         = вид ссылок п•о•р
|border         = параметр вложения шаблона внутрь самого себя

|titlegroup     = создаёт подзаголовок в верхнем заголовке
|titlegroupstyle= назначает стиль этого подзаголовка

|innerstyle     = назначает стиль для всего шаблона за исключением внешней рамки

|style          = назначает стиль из списка CSS телу шаблона.
|bodystyle      = то же самое
|basestyle      = CSS стиль, назначаемый сразу для всех заголовков
|groupstyle     = CSS стиль, назначаемый сразу всем заголовкамN (от заголовок1 до заголовок20)
|groupwidth     = задаёт ширину заголовкамN (от заголовок1 до заголовок20)
|liststyle      = CSS стиль, назначаемый сразу всем спискам
|listpadding    = задаёт отступы для всех списков
|oddstyle       = CSS стиль, назначаемый сразу для всех нечётных списков
|evenstyle      = CSS стиль, назначаемый сразу для всех чётных списков
|evenodd        = управление "зеброй"

|title          = заголовок
|titlestyle     = стиль заголовка
|above          = подзаголовок вверху
|abovestyle     = стиль подзаголовка вверху
|image          = изображение справа
|imagestyle     = стиль изображения справа
|imageleft      = изображение слева
|imageleftstyle = стиль изображения слева

|group1         = заголовок1
|group1style    = стиль заголовка1
|list1          = список1
|list1style     = стиль списка1

|group2         = заголовок2
|group2style    = стиль заголовка2
|list2          = список2
|list2style     = стиль списка2

 ...
|group20        = заголовок20
|group20style   = стиль заголовка20
|list20         = список20
|list20style    = стиль списка20

|below          = подзаголовок внизу
|belowstyle     = стиль подзаголовка внизу

|bodyclass      = вставляет микроформат в стиль шаблона в целом 
|titleclass     = вставляет микроформат в стиль заголовка
}}

Заготовка для копирования с основными параметрами


Технические параметры[править]

|name     - имя шаблона
|state    - сворачиваемость
|navbar   - вид ссылок п•о•р
|border   - параметр вложения шаблона внутрь самого себя
|child    - параметр вложения шаблона внутрь самого себя

name
Имя самого шаблона, обязательный параметр. Нужен для корректной работы ссылок п•о•р. Проще всего написать |name = {{subst:PAGENAME}} и имя подставится само.


state [autocollapse, uncollapsed, collapsed, plain, off]

  • Значение по умолчанию autocollapse: если на странице две или больше сворачиваемых таблиц, шаблон отобразится свёрнутым, иначе — развёрнутым.
  • collapsed — всегда изначательно свёрнут.
  • plain — всегда изначально развёрнут, кнопка «показать-скрыть» убрана. Центрирование заголовка сохранено.
  • off — всегда изначально развёрнут, кнопка «показать-скрыть» убрана. Центрирование заголовка не сохранено.
  • Любое другое значение поставленное в этот параметр, или отсутствие значения, приведёт к состоянию «раскрыт по умолчанию».

Для того, чтобы шаблон отображался скрытым только по месту применения в статье, значение параметра state можно заключить в тэг «includeonly». Тогда на самой странице шаблона шаблон будет развёрнут, а при вставке его в статью — свёрнут:

|state =<includeonly>collapsed</includeonly>

Если хотите иметь возможность задавать свёрнутость-развёрнутость вашего шаблона, сделанного на основе Navbox (beta), непосредственно при вставке в статью, нужно написать в вашем шаблоне так:

|state ={{{state<includeonly>|значение по умолчанию</includeonly>}}}


navbar [plain, off]

  • plain — ссылки п•о•р справа на заголовке отображаться не будут. Центрирование заголовка сохранено.
  • off — ссылки п•о•р справа на заголовке отображаться не будут. Центрирование заголовка не сохранено.

Примеры:


border [child, subgroup, none]

  • child или subgroup — Navbox может быть использован как включение в родительский Navbox без отделяющей границы.
  • none — рамка Navbox’а скрывается, отступы по краям убираются, и он может быть использован как включение в другой контейнер (не Navbox).
  • Любое другое значение — внутренний Navbox будет отображаться с границей в 1px.

Примеры:


child
С помощью этого ключа Navbox может быть использован как включение в родительский Navbox без отделяющей границы. Действие аналогично действию параметра border. Без этого ключа внутренний Navbox будет отображаться с границей в 1px. Применение: {{Navbox (beta) |child

Примеры:


Параметры содержимого[править]

|title      - заголовок
|above      - подзаголовок вверху
|image      - изображение
|imageleft  - изображение слева
|group1     - заголовок1
|list1      - список1
|group2     - заголовок2
|list2      - список2
...
|group20    - заголовок20
|list20     - список20
|below      - подзаголовок внизу

Примеры:


Параметры оформления[править]

Локальные параметры[править]

|titlestyle     - стиль заголовка
|abovestyle     - стиль подзаголовка вверху
|imageleftstyle - стиль изображения слева
|imagestyle     - стиль изображения справа
|group1style    - стиль заголовка1
|list1style     - стиль списка1
|group2style    - стиль заголовка2
|list2style     - стиль списка2
...
|group20style   - стиль заголовка20
|list20style    - стиль списка20
|belowstyle     - стиль подзаголовка внизу

Примеры:

Глобальные параметры[править]

|style          - назначает стиль из списка CSS телу шаблона.
|bodystyle      - то же самое
|basestyle      - CSS стиль, назначаемый сразу для всех заголовков
|groupstyle     - CSS стиль, назначаемый сразу всем заголовкамN (от заголовок1 до заголовок20)
|groupwidth     - задаёт ширину заголовкамN (от заголовок1 до заголовок20)
|liststyle      - CSS стиль, назначаемый сразу всем спискам
|listpadding    - задаёт отступы для всех списков
|oddstyle       - CSS стиль, назначаемый сразу для всех нечётных списков
|evenstyle      - CSS стиль, назначаемый сразу для всех чётных списков
|evenodd        - управление "зеброй"

evenodd [swap, even, odd, off]

  • swap — поменяет раскраску чётных-нечётных строк наоборот.
  • even — задаст всем строкам цвет чётных строк.
  • odd — задаст всем строкам цвет нечётных строк.
  • off — отключает «зебру».

Примеры:


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

|titlegroup      = создаёт подзаголовок в верхнем заголовке
|titlegroupstyle = назначает стиль этого подзаголовка
|innerstyle      = назначает стиль для всего шаблона за исключением внешней рамки*

* Принцип работы Navbox следующий: он использует отдельную таблицу для создания внешней границы, а всё остальное помещается во внутреннюю таблицу. При задании параметра style задаётся стиль для внешней таблицы, который затем наследуется внутренней таблицей. Параметр же innerstyle позволяет указать стиль непосредственно для внутренней таблицы (т.е. всего содержимого шаблона за исключением внешней рамки).

Примеры:


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

|bodyclass   = вставляет микроформат в стиль шаблона в целом 
|titleclass  = вставляет микроформат в стиль заголовка

Шаблон позволяет использовать микроформаты. Допустим, для пометки, что шаблон содержит данные hCard, можно задать параметры микроформатов таким образом:

|bodyclass = vcard
|titleclass = fn


Прочие примеры использования[править]