Ашаблон:Аилыркаа/doc

Аматериал Авикипедиа аҟынтә - зхы иақәиҭу аенциклопедиа

Этот шаблон предназначен для демонстрации легенды условных обозначений, снабжённой цветными квадратиками. Одно употребление шаблона соответствует одному квадратику и его подписи.

Использование[акод аредакциазура]

{{Аилыркаа|цвет фона|подпись|inline|цвет и толщина границы квадратика|скругление границы квадратика|цвет текста в квадратике|текст в квадратике|масштаб|текст всплывающей подсказки}}

Передача параметров[акод аредакциазура]

Шаблон представяет из себя два HTML тега <span>, один в другом. Внешний тег определяет масштаб и положение на странице квадратика и подписи. Внутренний — стиль квадратика. Параметры, указанные пользователем шаблона, определяют, что передаётся в атрибуты style обоих тегов. Некоторые параметры передаются без изменений, для некоторых лишь факт присутствия что-то определяет.

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

Пример
Текст{{Аилыркаа}}вплотную

Текст    вплотную

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

Цвет фона[акод аредакциазура]

Определяет цвет фона квадратика. В случае присутствия передаётся напрямую, при отсутствии передаётся none, то есть „нет цвета“. Возможные значения определены стандартом CSS.[1] Например, красный цвет может быть задан следующими способами.

Пример
{{Аилыркаа|#F00}}
{{Аилыркаа|#FF0000}}
{{Аилыркаа|rgb(255, 0, 0)}}
{{Аилыркаа|hsl(0, 100%, 50%)}}

                   

Подпись[акод аредакциазура]

Текст написанный справа от квадратика. Положение текста относительно квадратика в этой версии шаблона изменить нельзя. Но так как весь шаблон — это по сути текст, то можно, задав параметр inline, написать нужный текст слева с пробелом после. Нужно учесть также, что масштаб текста подписи по умолчанию 90%, и, возможно, придётся масштабировать текст слева. Масштаб текста подписи (и квадратика) меняется другим параметром. Цвет текста не устанавливается, значит, подчиняется внешним спецификаторам, то есть весь шаблон можно погрузить в другой цвет, и он адаптируется. Так же можно задать стиль внутри параметра шаблона (следует помнить об необходимости использования {{=}}[2]). Вики-форматирование работает, но цвет ссылок глобального стиля имеет приоритет над локальным цветом пользователя.

Пример
{{Аилыркаа|#180|Австралия}}
Австралия слева {{Аилыркаа|#180|и справа|inline}}
<span style="font-size:90%">Австралия слева </span>{{Аилыркаа|#180|и справа|inline}}
{{Аилыркаа|#F00|Китаи}}
{{color|red|{{Аилыркаа|#F00|Красный Китаи}}}}
{{Аилыркаа|#F00|<font color{{=}}"#FF0">Жёлтый [[Китаи]]</font>}}

     Австралия Австралия слева      и справа
Австралия слева      и справа      Китаи      Красный Китаи      Жёлтый Китаи

inline[акод аредакциазура]

Параметр определяет положение шаблона внутри окружающего текста: как текст или как блок (с переносами по краям). Наличие значения inline влечёт первый вариант, отсутствие или другое значение — второй.

Пример
Найдите {{Аилыркаа|#00F|Либерию}} на карте.
Найдите {{Аилыркаа|#1EB53A|Руанду|inline}} тоже!

Найдите      Либерию на карте.
Найдите      Руанду тоже!

Цвет и толщина границы квадратика[акод аредакциазура]

Определяет стиль границы квадратика. В случае присутствия передаётся напрямую, при отсутствии передаётся 1px solid {{{1}}}, то есть: толщина 1 пиксель, линия сплошная, цвет из первого параметра (цвет квадратика). Как, вероятно, уже понятно, строка значения состоит из трёх параметров: толщина линии, стиль линии и цвет линии.[3] При этом любой из параметров может отсутствовать, но надо иметь в виду, что стиль по умолчанию — none, то есть „никакой“, поэтому стиль надо задавать всегда. Толщина по умолчанию — medium („средняя“), цвет по умолчанию совпадает с цветом текста в квадратике.

Пример
{{Аилыркаа||||solid}}
{{Аилыркаа|red|||solid}}
{{Аилыркаа|red|— нет границы, не задан стиль||green}}
{{Аилыркаа|red|— задан стиль, есть граница||solid yellow}}

               — нет границы, не задан стиль      — задан стиль, есть граница

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

Пример
{{Аилыркаа||||thick solid red}}
{{Аилыркаа||||medium solid red}}
{{Аилыркаа||||thin solid red}}
{{Аилыркаа||||1px solid blue}}
{{Аилыркаа||||2px solid blue}}
{{Аилыркаа||||1mm solid purple}}

                             

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

Пример
{{Аилыркаа||||medium dotted magenta}}
{{Аилыркаа||||medium dashed magenta}}
{{Аилыркаа||||medium solid magenta}}
{{Аилыркаа||||medium double magenta}}
{{Аилыркаа||||medium groove magenta}}
{{Аилыркаа||||medium ridge magenta}}
{{Аилыркаа||||medium inset magenta}}
{{Аилыркаа||||medium outset magenta}}

                                       

Цвет задают обычным способом, см. параметр цвет фона.[1]

Скругление границы квадратика[акод аредакциазура]

Параметр определяет радиус(-ы) кривизны углов границы квадратика. В случае присутствия передаётся напрямую, при отсутствии передаётся 0%, то есть „нет скругления“. Задаётся в числовых единицах (пикселях, миллиметрах и т. п.). Может быть задан в процентах от максимального значения. Значения свыше максимально возможного приводятся к максимальному.[4]

Пример
{{Аилыркаа|gray|0%|||0%}}
{{Аилыркаа|gray|10%|||10%}}
{{Аилыркаа|gray|20%|||20%}}
{{Аилыркаа|gray|30%|||30%}}
{{Аилыркаа|gray|40%|||40%}}
...
{{Аилыркаа|gray|100%|||100%}}

     0%      10%      20%      30%      40% ...      100%

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

Пример
{{Аилыркаа||— номер трассы||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;}}

 346  — номер трассы  40  — другой номер  / / / /  — батон

Цвет текста в квадратике[акод аредакциазура]

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

Пример
{{Аилыркаа|yellow|— чёрный||||Black|&nbsp;'''R'''&nbsp;}} 
{{Аилыркаа|black|— белый||||White|&nbsp;'''S'''&nbsp;}}
{{Аилыркаа|red|— оранжевый||||Orange|&nbsp;'''B'''&nbsp;}}

 R  — чёрный  S  — белый  B  — оранжевый

Текст в квадратике[акод аредакциазура]

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

Пример
{{Аилыркаа|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||||||Тоже работает}}}}

Обычный Platform 9¾ — жирный Курсив И жирный, и курсив Секрет секрет ← выделите текст Попытка изменить цвет Удачная попытка Тоже работает

Масштаб[акод аредакциазура]

Определяет степень увеличения всего шаблона (и квадратика, и подписи). Задаётся в процентах. Значение по умолчанию — 90%.

Пример
{{Аилыркаа|#ff0|300%|8=300%}}
{{Аилыркаа|#ff0|200%|8=200%}}
{{Аилыркаа|#ff0|150%|8=150%}}
{{Аилыркаа|#ff0|100%|8=100%}}
{{Аилыркаа|#ff0|90% — по умолчанию|8=90%}}
{{Аилыркаа|#ff0|50%|8=50%}}

     300%      200%      150%      100%      90% — по умолчанию      50%

Текст всплывающей подсказки[акод аредакциазура]

Это тот текст, который видит пользователь, когда наводит курсор мыши на квадратик. По умолчанию — это цвет квадратика. Такое поведение было взято из шаблона Vorlage:Farbindex немецкой Википедии.

Пример
{{Аилыркаа||— наведите курсор на квадратик||2px solid blue|25%|blue|
    &nbsp;'''R'''&nbsp;||Этот город был взят Александром Македонским 
    всего за три дня, а вот Наполеону потребовалось больше недели}} 
{{Аилыркаа|black|||2px solid black||White|подсказка: „black“}}

 R  — наведите курсор на квадратик подсказка: „black“

Различные примеры[акод аредакциазура]

Исходный код

 1    2    3    400    5    6    7    8    9 

{{Аилыркаа|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;}}

Шәахә. иара убас[акод аредакциазура]

Азгәаҭақәа[акод аредакциазура]

  1. 1,0 1,1 "Положение стандарта о константах цветов" (англыз бызшәала). Ириашоу 08-04-2015 шықәсазы. {{cite web}}: Check date values in: |accessdate= (ацхыраара); Cite has empty unknown parameter: |datepublished= (ацхыраара)
    "Список констант цветов" (англыз бызшәала). Ириашоу 08-04-2015 шықәсазы. {{cite web}}: Check date values in: |accessdate= (ацхыраара); Cite has empty unknown parameter: |datepublished= (ацхыраара)
  2. См. Механизм шаблонов.
  3. См. "Описание из стандарта CSS" (англыз бызшәала). Ириашоу 08-04-2015 шықәсазы. {{cite web}}: Check date values in: |accessdate= (ацхыраара); Cite has empty unknown parameter: |datepublished= (ацхыраара)
  4. "Пояснения по радиусу границы" (англыз бызшәала). Ириашоу 08-04-2015 шықәсазы. {{cite web}}: Check date values in: |accessdate= (ацхыраара); Cite has empty unknown parameter: |datepublished= (ацхыраара)


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

Параметры шаблона

ПараметрОписаниеТипСтатус
Цвет квадратика1

без описания

По умолчанию
нет цвета
Пример
#FF0000, rgb(255, 0, 0)
Неизвестнонеобязательный
подпись2

Текст, написанный справа от квадратика.

Неизвестнонеобязательный
inline3

Параметр определяет положение шаблона внутри окружающего текста: как текст или как блок (с переносами по краям). Наличие значения inline влечёт первый вариант, отсутствие или другое значение — второй.

Пример
inline
Неизвестнонеобязательный
цвет и толщина границы квадратика4

стиль границы квадратика. строка значения состоит из трёх параметров: толщина линии, стиль линии и цвет линии.

По умолчанию
0px solid цвет_квадратика
Пример
medium dotted magenta Толщина: thick, medium, thin (толстая, средняя, тонкая), 12px, 1mm; Стиль линии: dotted, dashed, solid, double, groove, ridge, inset и outset;
Неизвестнонеобязательный
скругление границы квадратика5

радиус(-ы) кривизны углов границы квадратика Задаётся в числовых единицах (пикселях, миллиметрах и т. п.). Может быть задан в процентах от максимального значения. Значения свыше максимально возможного приводятся к максимальному. Может быть задан в виде нескольких чисел: от одного до четырёх. В этом случае значения применяются к углам последовательно по часовой стрелке начиная с левого верхнего.

По умолчанию
0%
Пример
40%
Неизвестнонеобязательный
цвет текста в квадратике6

без описания

По умолчанию
black
Пример
White
Неизвестнонеобязательный
текст в квадратике7

без описания

Неизвестнонеобязательный
масштаб8

тепень увеличения всего шаблона (и квадратика, и подписи). Задаётся в процентах

По умолчанию
90%
Пример
150%
Неизвестнонеобязательный
текст всплывающей подсказки9

текст, который видит пользователь, когда наводит курсор мыши на квадратик

По умолчанию
цвет квадратика, значение из первого параметра
Неизвестнонеобязательный