Dzmuh: Новая страница: «{{docpage}} {{Шаблон из википедии|Легенда}} Этот шаблон предназначен для демон...»

2021-06-04T00:37:53Z

Новая страница: «{{docpage}} <includeonly> {{Шаблон из википедии|Легенда}} </includeonly> Этот шаблон предназначен для демон...»

Новая страница

{{docpage}}
<includeonly>
{{Шаблон из википедии|Легенда}}
</includeonly>
Этот шаблон предназначен для демонстрации [[Легенда (значения)|легенды]] условных обозначений, снабжённой цветными квадратиками. Одно употребление шаблона соответствует одному квадратику и его подписи.

== Использование ==
<nowiki>{{</nowiki>легенда|''цвет фона''|''подпись''|''inline''|''цвет и толщина границы квадратика''|''скругление границы квадратика''|''цвет текста в квадратике''|''текст в квадратике''|''масштаб''|''текст всплывающей подсказки''<nowiki>}}</nowiki>

=== Передача параметров ===
Шаблон представяет из себя два [[HTML]] [[Тег (языки_разметки)|тега]] <code><nowiki></nowiki></code>, один в другом. Внешний тег определяет масштаб и положение на странице квадратика и подписи. Внутренний — стиль квадратика. Параметры, указанные пользователем шаблона, определяют, что передаётся в атрибуты <code><nowiki>style</nowiki></code> обоих тегов. Некоторые параметры передаются без изменений, для некоторых лишь факт присутствия что-то определяет.

Ни один из параметров шаблона не является обязательным. При отсутствии всех параметров выводится четыре пробела без фона в виде отдельного блока, отделённого слева и справа переносами строки.

{| class="wikitable" border="1"
|-
! colspan="2" |Пример
|-
|<pre>
Текст{{легенда}}вплотную
</pre>
|
Текст{{легенда}}вплотную
|}

Описание смысла параметров и их возможных значений ниже.

=== Цвет фона ===
Определяет цвет фона квадратика. В случае присутствия передаётся напрямую, при отсутствии передаётся <code>none</code>, то есть „нет цвета“. Возможные значения определены стандартом [[CSS]].<ref name="css-colors">{{cite web |author= |datepublished= |url=http://www.w3schools.com/cssref/css_colors_legal.asp
|title=Положение стандарта о константах цветов|lang=en |accessdate=08-04-2015}} {{cite web |author= |datepublished= |url=http://www.w3schools.com/cssref/css_colornames.asp
|title=Список констант цветов|lang=en |accessdate=08-04-2015}}</ref> Например, красный цвет может быть задан следующими способами.
{| class="wikitable" border="1"
|-
! colspan="2" |Пример
|-
|<pre>
{{легенда|#F00}}
{{легенда|#FF0000}}
{{легенда|rgb(255, 0, 0)}}
{{легенда|hsl(0, 100%, 50%)}}
</pre>
|
{{легенда|#F00}}
{{легенда|#FF0000}}
{{легенда|rgb(255, 0, 0)}}
{{легенда|hsl(0, 100%, 50%)}}
|}

=== Подпись ===
Текст написанный справа от квадратика. Положение текста относительно квадратика в этой версии шаблона изменить нельзя. Но так как весь шаблон — это по сути текст, то можно, задав параметр <code>inline</code>, написать нужный текст слева с пробелом после. Нужно учесть также, что масштаб текста подписи по умолчанию 90%, и, возможно, придётся масштабировать текст слева. Масштаб текста подписи (и квадратика) меняется другим параметром. Цвет текста не устанавливается, значит, подчиняется внешним спецификаторам, то есть весь шаблон можно погрузить в другой цвет, и он адаптируется. Так же можно задать стиль внутри параметра шаблона (следует помнить об необходимости использования <code><nowiki>{{</nowiki>[[Шаблон:=|=]]<nowiki>}}</nowiki></code><ref>См. [[Википедия:Механизм_шаблонов#Неопределённые и пустые значения параметров|Механизм шаблонов]].</ref>). Вики-форматирование работает, но цвет ссылок глобального стиля имеет приоритет над локальным цветом пользователя.

{| class="wikitable" border="1"
|-
! colspan="2" |Пример
|-
|<pre>
{{легенда|#180|Австралия}}
Австралия слева {{легенда|#180|и справа|inline}}
Австралия слева {{легенда|#180|и справа|inline}}
{{легенда|#F00|Китай}}
{{color|red|{{легенда|#F00|Красный Китай}}}}
{{легенда|#F00|Жёлтый [[Китай]]}}
</pre>
|
{{легенда|#180|Австралия}}
Австралия слева {{легенда|#180|и справа|inline}} 
Австралия слева {{легенда|#180|и справа|inline}}
{{легенда|#F00|Китай}}
{{color|red|{{легенда|#F00|Красный Китай}}}}
{{легенда|#F00|{{color|#FF0|Жёлтый [[Китай]]}}}}
|}
=== ''inline'' ===
Параметр определяет положение шаблона внутри окружающего текста: как текст или как блок (с переносами по краям). Наличие значения ''inline'' влечёт первый вариант, отсутствие или другое значение — второй.
{| class="wikitable" border="1"
|-
! colspan="2" |Пример
|-
|<pre>
Найдите {{легенда|#00F|Либерию}} на карте.
Найдите {{легенда|#1EB53A|Руанду|inline}} тоже!
</pre>
|
Найдите {{легенда|#00F|Либерию}} на карте. 
Найдите {{легенда|#1EB53A|Руанду|inline}} тоже!
|}

=== Цвет и толщина границы квадратика ===
Определяет стиль границы квадратика. В случае присутствия передаётся напрямую, при отсутствии передаётся <code>1px solid <nowiki>{{{1}}}</nowiki></code>, то есть: толщина 1 [[пиксель]], линия сплошная, цвет из первого параметра (цвет квадратика). Как, вероятно, уже понятно, строка значения состоит из трёх параметров: толщина линии, стиль линии и цвет линии.<ref>См. {{cite web |author= |datepublished= |url=http://www.w3schools.com/cssref/pr_border.asp
|title=Описание из стандарта CSS|lang=en |accessdate=08-04-2015}}</ref> При этом любой из параметров может отсутствовать, но надо иметь в виду, что стиль по умолчанию — <code>none</code>, то есть „никакой“, поэтому стиль надо задавать всегда. Толщина по умолчанию — <code>medium</code> („средняя“), цвет по умолчанию совпадает с цветом текста в квадратике.

{| class="wikitable" border="1"
|-
! colspan="2" |Пример
|-
|<pre>
{{легенда||||solid}}
{{легенда|red|||solid}}
{{легенда|red|— нет границы, не задан стиль||green}}
{{легенда|red|— задан стиль, есть граница||solid yellow}}
</pre>
|
{{легенда||||solid}}
{{легенда|red|||solid}}
{{легенда|red|— нет границы, не задан стиль||green}}
{{легенда|red|— задан стиль, есть граница||solid yellow}}
|}

Толщина может быть задана в числовых единицах измерения (пикселях, миллиметрах и т.п.) : <code>12px</code>, <code>1mm</code>, … или в виде одной из трёх констант: <code>thick</code>, <code>medium</code>, <code>thin</code> (толстая, средняя, тонкая). Константы от чисел отличаются тем, что на разных браузерах поведение при изменении масшаба отображения разное для разных видов значений.

{| class="wikitable" border="1"
|-
! colspan="2" |Пример
|-
|<pre>
{{легенда||||thick solid red}}
{{легенда||||medium solid red}}
{{легенда||||thin solid red}}
{{легенда||||1px solid blue}}
{{легенда||||2px solid blue}}
{{легенда||||1mm solid purple}}
</pre>
|
{{легенда||||thick solid red}}
{{легенда||||medium solid red}}
{{легенда||||thin solid red}}
{{легенда||||1px solid blue}}
{{легенда||||2px solid blue}}
{{легенда||||1mm solid purple}}
|}

Стиль линии задают строковой константой из фиксированного набора заданных констант, из которых наибольший интерес представляют следующие: <code>dotted</code>, <code>dashed</code>, <code>solid</code>, <code>double</code>, <code>groove</code>, <code>ridge</code>, <code>inset</code> и <code>outset</code>.

{| class="wikitable" border="1"
|-
! colspan="2" |Пример
|-
|<pre>
{{легенда||||medium dotted magenta}}
{{легенда||||medium dashed magenta}}
{{легенда||||medium solid magenta}}
{{легенда||||medium double magenta}}
{{легенда||||medium groove magenta}}
{{легенда||||medium ridge magenta}}
{{легенда||||medium inset magenta}}
{{легенда||||medium outset magenta}}
</pre>
|
{{легенда||||medium dotted magenta}}
{{легенда||||medium dashed magenta}}
{{легенда||||medium solid magenta}}
{{легенда||||medium double magenta}}
{{легенда||||medium groove magenta}}
{{легенда||||medium ridge magenta}}
{{легенда||||medium inset magenta}}
{{легенда||||medium outset magenta}}
|}

Цвет задают обычным способом, см. параметр [[#Использование#Цвет фона|цвет фона]].<ref name="css-colors" />

=== Скругление границы квадратика ===
Параметр определяет радиус(-ы) кривизны углов границы квадратика. В случае присутствия передаётся напрямую, при отсутствии передаётся <code>0%</code>, то есть „нет скругления“. Задаётся в числовых единицах (пикселях, миллиметрах и т. п.). Может быть задан в процентах от максимального значения. Значения свыше максимально возможного приводятся к максимальному.<ref>{{cite web |author= |datepublished= |url=http://www.w3schools.com/css/css3_borders.asp
|title=Пояснения по радиусу границы|lang=en |accessdate=08-04-2015}}</ref>
{| class="wikitable" border="1"
|-
! colspan="2" |Пример
|-
|<pre>
{{легенда|gray|0%|||0%}}
{{легенда|gray|10%|||10%}}
{{легенда|gray|20%|||20%}}
{{легенда|gray|30%|||30%}}
{{легенда|gray|40%|||40%}}
...
{{легенда|gray|100%|||100%}}
</pre>
|
{{легенда|gray|0%|||0%}}
{{легенда|gray|10%|||10%}}
{{легенда|gray|20%|||20%}}
{{легенда|gray|30%|||30%}}
{{легенда|gray|40%|||40%}}
...
{{легенда|gray|100%|||100%}}
|}
Может быть задан в виде нескольких чисел: от одного до четырёх. В этом случае значения применяются к углам последовательно по часовой стрелке начиная с левого верхнего. Когда числа заканчиваются, начинаются сначала, с первого.

{| class="wikitable" border="1"
|-
! colspan="2" |Пример
|-
|<pre>
{{легенда||— номер трассы||2px solid RoyalBlue|25px 25px|RoyalBlue|&nbsp;'''346'''&nbsp;}}
{{легенда|#8AC007|— другой номер||1px solid #8AC007|7px 0px 7px 0px|white|&nbsp;'''40'''&nbsp;}}
{{легенда|#E2A046|— батон||1px solid #AC6015|20px 15px|#FDD576|&nbsp;/&nbsp;/&nbsp;/&nbsp;/&nbsp;}}
</pre>
|
{{легенда||— номер трассы||2px solid RoyalBlue|25px 25px|RoyalBlue| '''346''' }}
{{легенда|#8AC007|— другой номер||1px solid #8AC007|7px 0px 7px 0px|white| '''40''' }}
{{легенда|#E2A046|— батон||1px solid #AC6015|20px 15px|#FDD576| / / / / }}
|}

=== Цвет текста в квадратике ===
Задаёт цвет текста, отображаемого в квадратике. Текст по умолчанию — четыре пробела <code>&nbsp;</code>, и для них цвет безразличен, хотя и может быть формально установлен. При отсутствии параметра передаётся <code>black</code> („чёрный“).

{| class="wikitable" border="1"
|-
! colspan="2" |Пример
|-
|<pre>
{{легенда|yellow|— чёрный||||Black|&nbsp;'''R'''&nbsp;}}
{{легенда|black|— белый||||White|&nbsp;'''S'''&nbsp;}}
{{легенда|red|— оранжевый||||Orange|&nbsp;'''B'''&nbsp;}}
</pre>
|
{{легенда|yellow|— чёрный||||Black| '''R''' }}
{{легенда|black|— белый||||White| '''S''' }}
{{легенда|red|— оранжевый||||Orange| '''B''' }}
|}

=== Текст в квадратике ===
Передаётся напрямую. Вики-форматирование работает. Можно менять цвет внутри, это отменяет соответствующий параметр шаблона. Снаружи получится, только если цвет текста в самом шаблоне не задаётся.

{| class="wikitable" border="1"
|-
! colspan="2" |Пример
|-
|<pre>
{{легенда|darkblue|||||White|'''Обычный'''}}
{{легенда|black|— жирный|inline|1px solid black||white|'''Platform 9¾'''}}
{{легенда|darkgreen|||||White|''Курсив''}}
{{легенда|darkred|||||White|'''''И жирный, и курсив'''''}}
{{легенда|purple|← выделите текст||1px solid purple||purple|'''Секрет секрет'''}}
{{color|red|{{легенда|black|||||White|Попытка изменить цвет}}}}
{{легенда|black|||||White|{{color|red|Удачная попытка}}}}
{{color|yellow}}{{легенда|black||||||Тоже работает}}}}
</pre>
|
{{легенда|darkblue|||||White|'''Обычный'''}}
{{легенда|black|— жирный|inline|1px solid black||white|'''Platform 9¾'''}}
{{легенда|darkgreen|||||White|''Курсив''}}
{{легенда|darkred|||||White|'''''И жирный, и курсив'''''}}
{{легенда|purple|← выделите текст||1px solid purple||purple|'''Секрет секрет'''}}
{{color|red|{{легенда|black|||||White|Попытка изменить цвет}}}}
{{легенда|black|||||White|{{color|red|Удачная попытка}}}}
{{color|yellow|{{легенда|black||||||Тоже работает}}}}
|}

=== Масштаб ===
Определяет степень увеличения всего шаблона (и квадратика, и подписи). Задаётся в процентах. Значение по умолчанию — <code>90%</code>.
{| class="wikitable" border="1"
|-
! colspan="2" |Пример
|-
|<pre>
{{легенда|#ff0|300%|8=300%}}
{{легенда|#ff0|200%|8=200%}}
{{легенда|#ff0|150%|8=150%}}
{{легенда|#ff0|100%|8=100%}}
{{легенда|#ff0|90% — по умолчанию|8=90%}}
{{легенда|#ff0|50%|8=50%}}
</pre>
|
{{легенда|#ff0|300%|8=300%}}
{{легенда|#ff0|200%|8=200%}}
{{легенда|#ff0|150%|8=150%}}
{{легенда|#ff0|100%|8=100%}}
{{легенда|#ff0|90% — по умолчанию|8=90%}}
{{легенда|#ff0|50%|8=50%}}
|}

=== Текст [[Подсказка|всплывающей подсказки]] ===
Это тот текст, который видит пользователь, когда наводит курсор мыши на квадратик. По умолчанию — это цвет квадратика. Такое поведение было взято из шаблона [https://de.wikipedia.org/wiki/Vorlage:Farbindex Vorlage:Farbindex] немецкой Википедии.

{| class="wikitable" border="1"
|-
! colspan="2" |Пример
|-
|<pre>
{{легенда||— наведите курсор на квадратик||2px solid blue|25%|blue|
&nbsp;'''R'''&nbsp;||Этот город был взят Александром Македонским
всего за три дня, а вот Наполеону потребовалось больше недели}}
{{легенда|black|||2px solid black||White|подсказка: „black“}}
</pre>
|
{{легенда||— наведите курсор на квадратик||2px solid blue|25%|blue| '''R''' ||Этот город был взят Александром Македонским всего за три дня, а вот Наполеону потребовалось больше недели}}
{{легенда|black|||2px solid black||White|подсказка: „black“}}
|}

== Различные примеры ==

{| class="wikitable" border="1"
|-
! colspan="2" |Исходный код
|-
|
{{легенда|red||inline|1px solid red|25%|white| '''1''' }} 
{{легенда|||inline|2px solid red|25%|black| '''2''' }} 
{{легенда|||inline|2px solid green|100%|green| '''3''' }} 
{{легенда|#8AC007||inline|2px solid #8AC007|15px 50px|white| '''400''' }} 
{{легенда|||inline|2px dotted orange|100%|orange| '''5''' }} 
{{легенда|||inline|3px double|100%|purple| '''6''' }} 
{{легенда|||inline|6px ridge|100%|gray| '''7''' }} 
{{легенда|||inline|2px groove|0%|gray| '''8''' }} 
{{легенда|aqua||inline|2px solid teal|0%|| '''9''' }}
|-
|<pre>
{{легенда|red|||1px solid red|25%|white|&nbsp;'''1'''&nbsp;}}
{{легенда||||2px solid red|25%|black|&nbsp;'''2'''&nbsp;}}
{{легенда||||2px solid green|100%|green|&nbsp;'''3'''&nbsp;}}
{{легенда|#8AC007||inline|2px solid #8AC007|15px 50px|white|&nbsp;'''400'''&nbsp;}}
{{легенда||||2px dotted orange|100%|orange|&nbsp;'''5'''&nbsp;}}
{{легенда||||3px double|100%|purple|&nbsp;'''6'''&nbsp;}}
{{легенда||||6px ridge|100%|gray|&nbsp;'''7'''&nbsp;}}
{{легенда||||2px groove|0%|gray|&nbsp;'''8'''&nbsp;}}
{{легенда|aqua|||2px solid teal|0%||&nbsp;'''9'''&nbsp;}}
</pre>
|}

== См. также ==
* [[Шаблон:Легенда-линия]]
* [[Шаблон:Легенда2]]

== Примечания ==
{{примечания}}

<includeonly>[[Категория:Шаблоны:Графические]]</includeonly>

<templatedata>
{
"params": {
"1": {
"label": "Цвет квадратика",
"example": "#FF0000, rgb(255, 0, 0)",
"default": "нет цвета"
},
"2": {
"label": "подпись",
"description": "Текст написанный справа от квадратика."
},
"3": {
"label": "inline",
"description": "Параметр определяет положение шаблона внутри окружающего текста: как текст или как блок (с переносами по краям). Наличие значения inline влечёт первый вариант, отсутствие или другое значение — второй.",
"example": "inline"
},
"4": {
"label": "цвет и толщина границы квадратика",
"description": "стиль границы квадратика. строка значения состоит из трёх параметров: толщина линии, стиль линии и цвет линии.",
"example": "medium dotted magenta Толщина: thick, medium, thin (толстая, средняя, тонкая), 12px, 1mm; Стиль линии: dotted, dashed, solid, double, groove, ridge, inset и outset;",
"default": "0px solid цвет_квадратика"
},
"5": {
"label": "скругление границы квадратика",
"description": "радиус(-ы) кривизны углов границы квадратика Задаётся в числовых единицах (пикселях, миллиметрах и т. п.). Может быть задан в процентах от максимального значения. Значения свыше максимально возможного приводятся к максимальному. Может быть задан в виде нескольких чисел: от одного до четырёх. В этом случае значения применяются к углам последовательно по часовой стрелке начиная с левого верхнего.",
"example": "40%",
"default": "0%"
},
"6": {
"label": "цвет текста в квадратике",
"example": "White",
"default": "black"
},
"7": {
"label": "текст в квадратике"
},
"8": {
"label": "масштаб",
"description": "тепень увеличения всего шаблона (и квадратика, и подписи). Задаётся в процентах",
"example": "150%",
"default": "90%"
},
"9": {
"label": "текст всплывающей подсказки",
"description": "текст, который видит пользователь, когда наводит курсор мыши на квадратик",
"default": "цвет квадратика, значение из первого параметра"
}
},
"description": "демонстрация легенды условных обозначений, снабжённая цветными квадратиками. Одно употребление шаблона соответствует одному квадратику и его подписи."
}
</templatedata>

Шаблон:Легенда/doc - История изменений

Dzmuh: Новая страница: «{{docpage}} {{Шаблон из википедии|Легенда}} Этот шаблон предназначен для демон...»