Редактирование: Шаблон:Подгруппы навигационной таблицы/doc

{{Docpage}}
{{OnLua|Navbox|navbox}}
{{Навигационные шаблоны}}

Шаблон предназначен для создания подзаголовков в навигационных шаблонах на основе {{Tl|Навигационная таблица}}.

{{Другие названия шаблона|Navbox subgroups|Navbox subgroup}}

== Сокращённая заготовка для копирования ==
<pre>{{Подгруппы навигационной таблицы
 |стиль_групп   = 
 |класс_списков = hlist 

 |группа1  = 
 |список1  = 

 |группа2  = 
 |список2  = 

<!-- ... -->

 |группа23 = 
 |список23 = 
}}</pre>

== Параметры ==
Шаблон {{Tl|Подгруппы навигационной таблицы}} содержит все параметры из шаблона {{Tl|Навигационная таблица}}, но имеются некоторые отличия:
*Параметр {{Para|border}} по умолчанию установлен как <code>child</code>

Все остальные параметры целиком взяты из шаблона {{Tl|Навигационная таблица}} и здесь приведены лишь некоторые из них.

=== Ячейки ===
; группа<sub>n</sub> =
; group<sub>n</sub> =
: ''(групп1, группа2, ...)'' Если этот параметр указан, слева от соответствующего {{Para|список<sub>n</sub>}} будет отображён заданный текст. Если параметр не указан, {{Para|список<sub>n</sub>}} займёт всю ширину таблицы.

; список<sub>n</sub> =
; list<sub>n</sub> =
: ''(список1, список2, ...)'' Тело шаблона; как правило, набор ссылок. Элементы списка должны быть указаны на одной строке, но, заключив их в {{Tag|div}}, можно использовать перенос строки (см. [[#Оформление списков|ниже]]). Каждый список отображается в отдельной строке таблицы. Каждый {{Para|список<sub>n</sub>}} может быть сопровождён параметром {{Para|заголовок<sub>n</sub>}} (см. ниже).
: Каждый элемент списка должен начинаться с новой строки и использовать [[астериск]] (<code>*</code>) (при этом параметр шаблона {{Para|класс_списков}} должен иметь значение <code>hlist</code>). Если в строка будет начинаться с двух и более астерисков (<code>**</code>), то элементы начнут оборачиваться в скобки, как дочерние для основного. Пример:
:: {{Pre|<nowiki>
| список1 =
* 1
* 2
** 3
* 4</nowiki>}}
: даст результат: 1{{•}}2 (3){{•}}4.
: Также можно использовать мини-группы, чтобы их заголовки выделялись жирным. С этой целью следует использовать <code>;</code> перед заголовком мини-группы и <code>:</code> перед каждым из элементов. Пример:
:: {{Pre|<nowiki>
| список1 =
; Заголовок
: 1
: 2
:* 3
: 4</nowiki>}}
<dl><dd>даст результат: <div class="hlist inline">
; Заголовок
: 1
: 2
:* 3
: 4
</div></dd></dl>

=== Стили ===
; bodystyle =
; стиль_тела =
: Стили для тела (фона) шаблона. Примеры аргументов этих параметров:
:: <code>background:#''nnnnnn''</code>
:: <code>text-align:[''right/center/left/justified'']</code>
:: <code>width:''N''[em/%/px]</code>
:: <code>float:[''left/right/none'']</code>
:: <code>clear:[''right/left/both/none'']</code>

; groupstyle = 
; стиль_групп =
: Стили для всех параметров {{Para|заголовок<sub>n</sub>}}. Этот параметр имеет более высокий приоритет, нежели {{Para|стиль}}. Примеры аргументов этого параметра:
:: <code>background:#''nnnnnn''</code>
:: <code>text-align:[''left/center/right'']</code>
:: <code>vertical-align:[''top/middle/bottom'']</code>
:: <code>white-space:nowrap</code>
: Цвет фона по умолчанию — <code><span style="background:#dcebff">#dcebff</span></code>.

; group<sub>n</sub>style =
; стиль_группы<sub>n</sub> =
: Стиль для одного из заголовков групп. Переписывает параметр {{Para|groupstyle}}. Пример:
::<code>| group2style = background: red; color: white;</code>

; groupwidth =
; ширина_групп =
: Параметр используется для упрощения работы с шириной заголовков групп, когда меньшие заголовки имеют меньшую ширину. Особенно полезно при использовании дочерних шаблонов. Пример:
::<code>| groupwidth = 10em</code>

; grouppadding =
; отступ_групп =
: Задает значение внутренних отступов для всех заголовков групп, по умолчанию этот параметр равен 0em — сверху и снизу, 0.75em — справа и слева. 
::<code>| listpadding = 0.5em 0</code> — задаст отступы 0.5em — сверху и снизу, 0em — справа и слева.
::<code>| listpadding = 0</code> — уберёт все отступы в ячейках списков.

; liststyle =
; стиль_списков =
: Стили для всех параметров {{Para|список<sub>n</sub>}}. Этот параметр имеет более высокий приоритет, нежели {{Para|стиль}}.
: Цвета фона списка (и всей таблицы) по умолчанию — <code><span style="background:#f9f9f9">#f9f9f9</span></code>.

; list<sub>n</sub>style = 
; стиль_списка<sub>n</sub> =
: Стиль для одного из списков. Переписывает параметр {{Para|liststyle}}. Пример:
::<code>| list2style = background: red; color: white;</code>

; listpadding =
; отступ_списков =
: Задает значение внутренних отступов для всех списков, по умолчанию этот параметр равен 0em — сверху и снизу, 0.25em — справа и слева. 
::<code>| listpadding = 0.5em 0</code> — задаст отступы 0.5em — сверху и снизу, 0em — справа и слева.
::<code>| listpadding = 0</code> — уберёт все отступы в ячейках списков.

; evenodd = <span style="font-weight: normal;"><code>[swap, even, odd, off]</code></span>
;; чётные_нечётные =
: Если задано значение <code>swap</code>, то автоматическое чередование чётных и нечётных строк станет обратным. Обычно, если чётным строкам задан светло-серый фон, то при использовании этого параметра нечётные строки получат серый фон вместо чётнчётных строк. Значения <code>even</code> и <code>odd</code> заставит все строки стать чётными или нечётными. <code>off</code> отключает автоматическое чередование строк. Этот дополнительный параметр следует использовать только для устранения проблем, когда навигационная таблица используется как дочерний элемент другой навигационной таблицы и строки не совпадают. Примеры и дальнейшее описание можно найти в разделе, посвященном дочерним шаблонам.

== Установка ширины заголовков групп ==
Так как шаблон {{Tl|Подгруппы навигационной таблицы}} работает с шаблоном {{Tl|Навигационная таблица}} он лучше выглядит, когда у всех заголовков групп используется одинаковая ширина. Для достижения этого эффекта нужно использовать параметр {{Para|ширина_групп}}, например, <code>|ширина_групп = 10em</code>. Альтернативный вариант — это использовать параметр {{Para|стиль_групп}}, например, <code>|groupstyle = width:10em;</code>, но если вы хотите чтобы он заработал, тогда ''обязательно'' параметр {{Para|стиль_списков}} должен включать в себя <code>width:auto;</code>, из-за некоторых CSS/HTML ограничений.

== Пример использования с шаблоном «[[Шаблон:Навигационная таблица|Навигационная таблица]]» ==
{{Начало цитаты}}
{{Навигационная таблица
 |имя                       = Подгруппы навигационной таблицы
 |state                     = uncollapsed
 |заголовок                 = Заголовок
 |класс_списков = hlist
 |группа1 = Название_заголовка_1
 |список1    = 

 {{Подгруппы навигационной таблицы
  |группа1 = Название_заголовка_1
  |список1 = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]

  |группа2 = Название_заголовка_2
  |список2 = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]
 }}

 |группа2 = Название_заголовка_2
 |список2    = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]
}}
{{Оригинальный текст|| ''<source lang="text">
{{Навигационная таблица
 |имя                       = Подгруппы навигационной таблицы/doc
 |state                     = <includeonly>{{{state|collapsed}}}</includeonly>
 |заголовок                 = Заголовок
 |класс_списков = hlist
 |группа1 = Название_заголовка_1
 |список1    = 

 {{Подгруппы навигационной таблицы
  |группа1 = Название_заголовка_1
  |список1 = 
* [[Ссылка_на_статью1]]
* [[Ссылка_на_статью2]]
* [[Ссылка_на_статью3]]

  |группа2 = Название_заголовка_2
  |список2 = 
* [[Ссылка_на_статью1]]
* [[Ссылка_на_статью2]]
* [[Ссылка_на_статью3]]
 }}

 |группа2 = Название_заголовка_2
 |список2    = 
* [[Ссылка_на_статью1]]
* [[Ссылка_на_статью2]]
* [[Ссылка_на_статью3]]
}}
</source>'' }}
{{Конец цитаты}}

Пример, с более сложным чередованием подгрупп и списков основных групп, более сложной структурой
{{Начало цитаты}}
{{Навигационная таблица
 |имя                       = Подгруппы навигационной таблицы
 |state                     = uncollapsed
 |заголовок                 = Заголовок
 |класс_списков = hlist

 |вверху =  Какой-то_текст [[Ссылка на статью2]]{{•}}[[Ссылка на статью3]]

 |группа1 = Название_заголовка_1
 |список1    = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]

 {{Подгруппы навигационной таблицы
  |группа1 = [[Ссылка_подзаголовка_1_1]]
  |список1 = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]

  |группа2 = Подзаголовок_1_2
  |список2 = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]
  
  |список3 = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]
  
  |список4 = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]

  |группа5 = Подзаголовок_1_3
  |список5 = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]

  |список6 = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]
  
  |список7 = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]
 }}

 |группа2 = [[Ссылка_заголовка_2]]
 |список2    =
 {{Подгруппы навигационной таблицы
  |группа1 = Подзаголовок_2_1
  |список1 = 

 {{Подгруппы навигационной таблицы
  |группа1 = Подзаголовок_2_1_1
  |список1 = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]
 
  |группа2 = [[Ссылка_2_1_2]]
  |список2 = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]
}}

  |список2 =
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]
}}
  |внизу =  [[Ссылка на статью1]]{{•}}[[Ссылка на статью2]]{{•}}[[Ссылка на статью3]]<br>[[Ссылка на статью4]]{{•}}[[Ссылка на статью5]]
}}
{{Оригинальный текст|| ''<source lang="text">
{{начало цитаты}}
{{Навигационная таблица
 |имя                       = Подгруппы навигационной таблицы/doc
 |state                     = <includeonly>{{{state|collapsed}}}</includeonly>
 |заголовок                 = Заголовок
 |класс_списков = hlist

 |вверху =  Какой-то_текст [[Ссылка на статью2]]{{•}}[[Ссылка на статью3]]

 |группа1 = Название_заголовка_1
 |список1    = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]

 {{Подгруппы навигационной таблицы
  |группа1 = [[Ссылка_подзаголовка_1_1]]
  |список1 = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]

  |группа2 = Подзаголовок_1_2
  |список2 = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]
  
  |список3 = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]
  
  |список4 = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]

  |группа5 = Подзаголовок_1_3
  |список5 = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]

  |список6 = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]
  
  |список7 = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]
 }}

 |группа2 = [[Ссылка_заголовка_2]]
 |список2    =

 {{Подгруппы навигационной таблицы
  |группа1 = Подзаголовок_2_1
  |список1 = 

 {{Подгруппы навигационной таблицы
  |группа1 = Подзаголовок_2_1_1
  |список1 = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]
 
  |группа2 = [[Ссылка_2_1_2]]
  |список2 = 
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]
}}

  |список2 =
* [[Ссылка на статью1]]
* [[Ссылка на статью2]]
* [[Ссылка на статью3]]
}}
  |внизу =  [[Ссылка на статью1]]{{•}}[[Ссылка на статью2]]{{•}}[[Ссылка на статью3]]<br>[[Ссылка на статью4]]{{•}}[[Ссылка на статью5]]
}}
</source>'' }}
{{Конец цитаты}}

== См. также ==
* {{Tl|Скрытый блок}}
* {{Tl|Навигационный блок}}
* {{Tl|Навигационная таблица}}

<includeonly>
[[Категория:Шаблоны:Для навигационных шаблонов]]
</includeonly>