Шаблон:Навигационная таблица/doc: различия между версиями

нет описания правки
Нет описания правки
Нет описания правки
 
Строка 6: Строка 6:
Данный шаблон позволяет быстро создавать [[Тептар:Шаблоны/Навигационные|навигационные шаблоны]], указывая в качестве параметров списки ссылок.
Данный шаблон позволяет быстро создавать [[Тептар:Шаблоны/Навигационные|навигационные шаблоны]], указывая в качестве параметров списки ссылок.


В правом верхнем углу находится кнопка [показать]{{sp/}}[скрыть]. Это реализовано с помощью [MediaWiki:Common.js]. Подробнее см. [[ТП:СБ]].
В правом верхнем углу находится кнопка [показать]{{sp/}}[скрыть]. Это реализовано с помощью [[MediaWiki:Common.js]]. Подробнее см. [[ТП:СБ]].


== Заготовка для копирования ==
== Заготовка для копирования ==
Строка 86: Строка 86:
| {{para|state}}
| {{para|state}}
|—
|—
|-
| {{para|navigation}}
| {{para|навигация}}
|-
|-
| {{para|above}}
| {{para|above}}
Строка 181: Строка 184:
:: <code>autocollapse</code> — значение по умолчанию, если {{para|state}} пустой или отсутствует;
:: <code>autocollapse</code> — значение по умолчанию, если {{para|state}} пустой или отсутствует;
:: <code>collapsed</code> — при данном значении таблица всегда будет свернута;
:: <code>collapsed</code> — при данном значении таблица всегда будет свернута;
:: <code>uncollapsed</code> — при данном значение таблица всегда будет развернута;
:: <code>uncollapsed</code> — при данном значении таблица всегда будет развернута;
:: <code>plain</code> — при данном значении таблица всегда будет развернута и будут убраны ссылки [показать]{{sp/}}[скрыть] справа. Заголовок будет отцентрирован относительно всей ячейки, игнорируя размеры «шестеренки»;
:: <code>plain</code> — при данном значении таблица всегда будет развернута и будут убраны ссылки [показать]{{sp/}}[скрыть] справа. Заголовок будет отцентрирован относительно всей ячейки, игнорируя размеры «шестеренки»;
:: <code>off</code> — при данном значении таблица всегда будет развернута и будут убраны ссылки [показать]{{sp/}}[скрыть] справа. Заголовок не будет отцентрирован относительно всей ячейки, игнорируя размеры «шестеренки». Предпочтительно использовать <code>plain</code> вместо <code>off</code>. Используйте данный параметр, только если знаете что делаете.
:: <code>off</code> — при данном значении таблица всегда будет развернута и будут убраны ссылки [показать]{{sp/}}[скрыть] справа. Заголовок не будет отцентрирован относительно всей ячейки, игнорируя размеры «шестеренки». Предпочтительно использовать <code>plain</code> вместо <code>off</code>. Используйте данный параметр, только если знаете что делаете.
Строка 189: Строка 192:
: (теги {{tago|includeonly}} нужны для того, чтобы при просмотре шаблона на его странице он всегда оставался в раскрытом состоянии). Соответственно, при использовании такого навигационного шаблона можно указывать его состояние, например:
: (теги {{tago|includeonly}} нужны для того, чтобы при просмотре шаблона на его странице он всегда оставался в раскрытом состоянии). Соответственно, при использовании такого навигационного шаблона можно указывать его состояние, например:
:: {{tc|''Наш навигационный шаблон''|state=collapsed}}
:: {{tc|''Наш навигационный шаблон''|state=collapsed}}
; навигация <span style="font-weight:normal;">[<code>да, нет</code>]</span>
; navigation
: Включает [[AJAX|динамическую]] навигацию для ссылок на другие шаблоны.
:: <code>да</code> — значение по умолчанию для [[ТП:ПРИ|основного пространства]];
:: <code>нет</code> — при данном значении полностью отключается навигация между ссылками, даже теми, что отмечены шаблоном {{tl|nn}};


; ссылка_на_просмотр*
; ссылка_на_просмотр*
Строка 203: Строка 212:
; заголовок*
; заголовок*
; title*
; title*
: Текст, отображаемый в верхней строке таблицы. Обычно это тема шаблона, краткое описание его содержания.<!-- Это, как правило, одна строка, но если требуется отобразить текст в двух строках, используйте <code><nowiki>{{-}}</nowiki></code> для корректного центрирования. // сейчас вторая строка центруется нормально — AVB -->
: Текст, отображаемый в верхней строке таблицы. Обычно это тема шаблона, краткое описание его содержания.<!-- Это, как правило, одна строка, но если требуется отобразить текст в двух строках, используйте <code><nowiki>{{-}}</nowiki></code> для корректного центрирования. // сейчас вторая строка центрируется нормально — AVB -->


; вверху
; вверху
Строка 242: Строка 251:
; изображение
; изображение
; image
; image
: Изображение, которое будет показано под основным заголовком в правой части таблицы (правее заголовков/списков). Для того, чтобы изображение отображалось, должен быть хоть один {{para|список}} либо {{para|группа}}. Параметр {{para|изображение}} допускает стандартный викикод для отображения, то есть
: Изображение, которое будет показано под основным заголовком в правой части таблицы (правее заголовков/списков). Для того, чтобы изображение отображалось, должен быть хоть один {{para|список}} либо {{para|группа}}. Параметр {{para|изображение}} допускает стандартный тептар-код для отображения, то есть
:: <code><nowiki>| изображение = [[Файл:Пример.jpg|100px]]</nowiki></code>
:: <code><nowiki>| изображение = [[Файл:Пример.jpg|100px]]</nowiki></code>
: В шаблоне, не растянутом на всю ширину страницы, изображение будет показано со сдвигом от правого края шаблона. Для того, чтобы этого избежать, используйте параметр right в викикоде, то есть
: В шаблоне, не растянутом на всю ширину страницы, изображение будет показано со сдвигом от правого края шаблона. Для того, чтобы этого избежать, используйте параметр right в тептар-коде, то есть
:: <code><nowiki>| изображение = [[Файл:Пример.jpg|80px|right]]</nowiki></code>
:: <code><nowiki>| изображение = [[Файл:Пример.jpg|80px|right]]</nowiki></code>


Строка 258: Строка 267:
В следующих параметрах указываются [[Каскадная таблица стилей|CSS]]-стили.
В следующих параметрах указываются [[Каскадная таблица стилей|CSS]]-стили.


''Внимание! Значения стилей таблиц по умолчанию в Википедии в настоящее время заданы с помощью [https://ru.wikipedia.org/wiki/MediaWiki:Common.css MediaWiki:Common.css].''
''Внимание! Значения стилей таблиц по умолчанию в Тептар в настоящее время заданы с помощью [https://massarn.com/w/MediaWiki:Common.css MediaWiki:Common.css].''


Так как разделение строк происходит через CSS-свойство <code>border-top</code>, то возможны сложности с созданием границ ячеек. Проблему могут помочь решить CSS-тени или шаблоны {{tl|box-shadow}} и {{tl|Box-shadow border}}.
Так как разделение строк происходит через CSS-свойство <code>border-top</code>, то возможны сложности с созданием границ ячеек. Проблему могут помочь решить CSS-тени или шаблоны {{tl|box-shadow}} и {{tl|Box-shadow border}}.
Строка 272: Строка 281:


; style
; style
: Аналог {{para|bodystyle}}, используемый в английском разделе Википедии для совместимости со старыми шаблонами. ''Рекомендуется заменять его на {{para|bodystyle}} или {{para|стиль_тела}}.'' '''Обратите внимание:''' параметры {{para|style}} и {{para|стиль}} имеют разное назначение, {{para|стиль}} описан ниже.
: Аналог {{para|bodystyle}}, используемый в английском разделе Тептар для совместимости со старыми шаблонами. ''Рекомендуется заменять его на {{para|bodystyle}} или {{para|стиль_тела}}.'' '''Обратите внимание:''' параметры {{para|style}} и {{para|стиль}} имеют разное назначение, {{para|стиль}} описан ниже.


; стиль
; стиль
Строка 352: Строка 361:
; belowclass
; belowclass
: Задают CSS-класс для элементов шаблона. Обычно используется <code>hlist</code> в {{para|класс_списков}} для горизонтальных списков. Каждый из параметров может принимать значение <code>hlist</code>, но если в шаблоне вы используете более одного параметра с <code>hlist</code>, то лучше использовать {{para|bodyclass}} для всего шаблона. Также можно использовать класс <code>hlist-items-nowrap</code>, чтобы запретить перенос строки внутри элементов (ссылки не переносятся в любом случае), но это создаёт проблемы в IE9 и ниже <small>(ими можно будет пренебречь, когда [http://www.liveinternet.ru/stat/ru/browsers.html?period=month&slice=desktop&id=49&id=50&id=55&id=54&show=перестроить+график&per_page=50&report=browsers.html%3Fslice%3Ddesktop;period%3Dmonth доля их использования] станет очень малой)</small>.
: Задают CSS-класс для элементов шаблона. Обычно используется <code>hlist</code> в {{para|класс_списков}} для горизонтальных списков. Каждый из параметров может принимать значение <code>hlist</code>, но если в шаблоне вы используете более одного параметра с <code>hlist</code>, то лучше использовать {{para|bodyclass}} для всего шаблона. Также можно использовать класс <code>hlist-items-nowrap</code>, чтобы запретить перенос строки внутри элементов (ссылки не переносятся в любом случае), но это создаёт проблемы в IE9 и ниже <small>(ими можно будет пренебречь, когда [http://www.liveinternet.ru/stat/ru/browsers.html?period=month&slice=desktop&id=49&id=50&id=55&id=54&show=перестроить+график&per_page=50&report=browsers.html%3Fslice%3Ddesktop;period%3Dmonth доля их использования] станет очень малой)</small>.
: {{якорь|bookmarklet}}Раньше шаблоны использовали разделители вроде {{t|•}}, {{t|·}} вместо списков с астериском. Чтобы автоматически преобразовать код шаблона из старого формата в новый, вы можете воспользоваться следующим [[ТП:Букмарклеты|букмарклетом]] (запускается из панели закладок):<source lang="js">javascript:if ('toHlistWithHeaders' in window) { window.toHlistWithHeaders(); } else { importScript('User:Facenapalm/toHlistWithHeaders.js'); }</source>Этот букмарклет не преобразует элементы в скобках в [[#астериски|пункты списка второго уровня]] (<code>**</code>) — это нужно делать вручную.
: {{якорь|bookmarklet}}Раньше шаблоны использовали разделители вроде {{t|•}}, {{t|·}} вместо списков с астериском. Чтобы автоматически преобразовать код шаблона из старого формата в новый, вы можете воспользоваться следующим [[ТП:Букмарклеты|букмарклетом]] (запускается из панели закладок):<syntaxhighlight lang="js">javascript:if ('toHlist' in window) { window.toHlist(); } else { importScript('User:Jack_who_built_the_house/toHlist.js'); }</syntaxhighlight>Этот букмарклет не преобразует элементы в скобках в [[#астериски|пункты списка второго уровня]] (<code>**</code>) — это нужно делать вручную.


== Примеры ==
== Примеры ==
Строка 375: Строка 384:
: [[Windows 95|95]]
: [[Windows 95|95]]
: [[Windows 98|98]]
: [[Windows 98|98]]
: [[Windows ME|ME]]
: [[Windows Me|Me]]


; [[Windows NT]]
; [[Windows NT]]
Строка 448: Строка 457:
* [[Wine]]
* [[Wine]]
}}
}}
{{oq|| ''<source lang="text">
{{oq|ru|<syntaxhighlight lang="text" style="font-style:normal;">
{{Навигационная таблица  
{{Навигационная таблица  
| имя          = Навигационная таблица/doc
| имя          = Навигационная таблица/doc
Строка 466: Строка 475:
: [[Windows 95|95]]
: [[Windows 95|95]]
: [[Windows 98|98]]
: [[Windows 98|98]]
: [[Windows ME|ME]]
: [[Windows Me|Me]]


; [[Windows NT]]
; [[Windows NT]]
Строка 539: Строка 548:
* [[Wine]]
* [[Wine]]
}}
}}
</source>'' }}
</syntaxhighlight>}}
{{конец цитаты}}
{{конец цитаты}}


Строка 563: Строка 572:
: [[Windows 95|95]]
: [[Windows 95|95]]
: [[Windows 98|98]]
: [[Windows 98|98]]
: [[Windows ME|ME]]
: [[Windows Me|Me]]


; [[Windows NT]]
; [[Windows NT]]
Строка 636: Строка 645:
* [[Wine]]
* [[Wine]]
}}
}}
{{oq|| ''<source lang="text">
{{oq|ru|<syntaxhighlight lang="text" style="font-style:normal;">
{{Навигационная таблица
{{Навигационная таблица
  |имя        = Навигационная таблица/doc
  |имя        = Навигационная таблица/doc
Строка 656: Строка 665:
: [[Windows 95|95]]
: [[Windows 95|95]]
: [[Windows 98|98]]
: [[Windows 98|98]]
: [[Windows ME|ME]]
: [[Windows Me|Me]]


; [[Windows NT]]
; [[Windows NT]]
Строка 729: Строка 738:
* [[Wine]]
* [[Wine]]
}}
}}
</source>'' }}
</syntaxhighlight>}}
{{конец цитаты}}
{{конец цитаты}}


Строка 755: Строка 764:
: [[Windows 95|95]]
: [[Windows 95|95]]
: [[Windows 98|98]]
: [[Windows 98|98]]
: [[Windows ME|ME]]
: [[Windows Me|Me]]


; [[Windows NT]]
; [[Windows NT]]
Строка 828: Строка 837:
* [[Wine]]
* [[Wine]]
}}
}}
{{oq|| ''<source lang="text">
{{oq|ru|<syntaxhighlight lang="text" style="font-style:normal;">
{{Навигационная таблица
{{Навигационная таблица
  |имя        = Навигационная таблица/doc
  |имя        = Навигационная таблица/doc
Строка 850: Строка 859:
: [[Windows 95|95]]
: [[Windows 95|95]]
: [[Windows 98|98]]
: [[Windows 98|98]]
: [[Windows ME|ME]]
: [[Windows Me|Me]]


; [[Windows NT]]
; [[Windows NT]]
Строка 923: Строка 932:
* [[Wine]]
* [[Wine]]
}}
}}
</source>'' }}
</syntaxhighlight>}}
{{конец цитаты}}
{{конец цитаты}}


Строка 948: Строка 957:
{{main|Шаблон:Подгруппы навигационной таблицы}}
{{main|Шаблон:Подгруппы навигационной таблицы}}


Данный пример показывает как могут создаваться подгруппы. Рекомендуется использовать {{tl|Подгруппы навигационной таблицы}}, но похожего результата можно добиться и с помощью {{tl|Навигационная таблица}} с использованием праметра {{para|border}} или '''первого''' параметра со значением <code>child</code>. В данном примере использованы оба способа создания подгрупп. Параметр {{para|evenodd}} позволяет сменить чередование цвета строк, для создания правильной последовательности, а для того чтобы в подгруппах совсем убрать чередование и использовать цвет основного списка, необходимо добавить строку <code>liststyle = background: transparent;</code> в каждую подгруппу.  
Данный пример показывает как могут создаваться подгруппы. Рекомендуется использовать {{tl|Подгруппы навигационной таблицы}}, но похожего результата можно добиться и с помощью {{tl|Навигационная таблица}} с использованием параметра {{para|border}} или '''первого''' параметра со значением <code>child</code>. В данном примере использованы оба способа создания подгрупп. Параметр {{para|evenodd}} позволяет сменить чередование цвета строк, для создания правильной последовательности, а для того чтобы в подгруппах совсем убрать чередование и использовать цвет основного списка, необходимо добавить строку <code>liststyle = background: transparent;</code> в каждую подгруппу.  


{{начало цитаты}}
{{начало цитаты}}
Строка 985: Строка 994:
  }}
  }}
}}
}}
{{oq|| ''<source lang="text">
{{oq|ru|<syntaxhighlight lang="text" style="font-style:normal;">
{{Навигационная таблица
{{Навигационная таблица
| name = Навигационная таблица/doc
| name = Навигационная таблица/doc
Строка 1020: Строка 1029:
  }}
  }}
}}
}}
</source>'' }}
</syntaxhighlight>}}
{{конец цитаты}}
{{конец цитаты}}


Строка 1096: Строка 1105:
}}
}}
}}
}}
{{oq|| ''<source lang="text">
{{oq|ru|<syntaxhighlight lang="text" style="font-style:normal;">
{{Навигационная таблица
{{Навигационная таблица
| name = Навигационная таблица/doc
| name = Навигационная таблица/doc
Строка 1164: Строка 1173:
}}
}}
}}
}}
</source>'' }}
</syntaxhighlight>}}
{{конец цитаты}}
{{конец цитаты}}


== Взаимодействие с другими шаблонами ==
== Взаимодействие с другими шаблонами ==
Данный шаблон разработан специально для работы в сочетании с двумя другими родственными шаблонами: {{tl|Навигационная таблица с колонками}} и {{tl|Навигационная таблица с блоками}}. Все три эти шаблона имеют одинаковые параметры для простоты использования (такие параметры отмеченны звездочкой (*) в списке описания параметров). Самое главное, что каждый шаблон может быть использован в качестве дочернего друг для друга (с помощью {{para|border|child}}, либо указав значение ''первого неименованного параметра'' равное <code>child</code>, например: <code><nowiki>{{Навигационная таблица|child ...}}</nowiki></code>, <code><nowiki>{{Навигационная таблица с колонками|child ...}}</nowiki></code> or <code><nowiki>{{Навигационная таблица с блоками|child ...}}</nowiki></code>).
Данный шаблон разработан специально для работы в сочетании с двумя другими родственными шаблонами: {{tl|Навигационная таблица с колонками}} и {{tl|Навигационная таблица с блоками}}. Все три эти шаблона имеют одинаковые параметры для простоты использования (такие параметры отмечены звездочкой (*) в списке описания параметров). Самое главное, что каждый шаблон может быть использован в качестве дочернего друг для друга (с помощью {{para|border|child}}, либо указав значение ''первого неименованного параметра'' равное <code>child</code>, например: <code><nowiki>{{Навигационная таблица|child ...}}</nowiki></code>, <code><nowiki>{{Навигационная таблица с колонками|child ...}}</nowiki></code> or <code><nowiki>{{Навигационная таблица с блоками|child ...}}</nowiki></code>).


== См. также ==
== См. также ==
Строка 1181: Строка 1190:
"params": {
"params": {
"state": {
"state": {
"description": "По умолчанию (если параметр отсутствует или с пустым значением) — autocollapse. Навигационная таблица с этим параметром будет появляться в скрытом состоянии, если на странице есть две или более навигационных таблицы с CSS-классом collapsible. Если указано значение collapsed, навигационная таблица всегда будет появляться в свёрнутом состоянии. Также возможны значения plain и off (см. документацию). Для значения uncollapsed и любого другого навигационная таблица всегда будет появляться в раскрытом состоянии."
"description": "По умолчанию (если параметр отсутствует или с пустым значением) — autocollapse. Навигационная таблица с этим параметром будет появляться в скрытом состоянии, если на странице есть две или более навигационных таблицы с CSS-классом collapsible. Если указано значение collapsed, навигационная таблица всегда будет появляться в свёрнутом состоянии. Также возможны значения plain и off (см. документацию). Для значения uncollapsed и любого другого навигационная таблица всегда будет появляться в раскрытом состоянии.",
"suggestedvalues": [
"autocollapse",
"collapsed",
"uncollapsed",
"plain",
"off"
],
"default": "autocollapse"
},
"навигация": {
"description": "По умолчанию (если параметр отсутствует или с пустым значением) — «да» для основного пространства имён. Если указано значение «нет», полностью отключается навигация между ссылками.",
"aliases": [
"navigation"
]
},
},
"стиль": {
"стиль": {
Строка 1858: Строка 1881:
"border",
"border",
"state",
"state",
"навигация",
"стиль_тела",
"стиль_тела",
"стиль",
"стиль",