Template:Legend/doc: Difference between revisions

From IDU Wiki
Jump to navigation Jump to search
en>Iketsi
m (86 revisions imported)
 
(47 intermediate revisions by 29 users not shown)
Line 1: Line 1:
{{Documentation subpage}}
{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{High-use|17355.142857142857142857142857142857142857142857142857142857142857142857}}
{{Uses TemplateStyles|Template:Legend/styles.css}}
Shows a legend row with a colored box.
Shows a legend row with a colored box.
__TOC__
__TOC__


==Usage==
==Usage==
  <nowiki>{{</nowiki>legend|''color''|''label''|outline=''outline color''|border=''css border''<nowiki>}}</nowiki>
  <nowiki>{{</nowiki>legend|''background-color''|''caption''|outline=''outline color''|border=''css border''<nowiki>}}</nowiki>


''color'' is passed to the [[Cascading Style Sheets|css]] background-color property of the color box. The optional ''outline'' parameter is the color of the outline around the box. If you need to customize the border further, you can use the  ''border'' argument, which overrides the ''outline'' argument and sets the css description (e.g., <code>1px solid #aaa</code>) of the border that will be drawn around the box.
*''background-color'' is passed to the [[Cascading Style Sheets|css]] background-color property of the color box.
*The optional ''outline'' parameter is the color of the outline around the box.
*The optional ''border'' argument which overrides the ''outline'' argument and sets the css description (e.g., <code>1px solid #aaa</code>) of the border that will be drawn around the box.


==Examples==
==Examples==
Line 15: Line 19:
  <nowiki>{{legend|blue|Oceania}}</nowiki>
  <nowiki>{{legend|blue|Oceania}}</nowiki>
  <nowiki>{{legend|#ffa|Europe|outline=silver}}</nowiki>
  <nowiki>{{legend|#ffa|Europe|outline=silver}}</nowiki>
  <nowiki>{{legend|#ff2800|Asia}}</nowiki>
  <nowiki>{{legend|#ff2800|Asia|outline=#A2A9B1}}</nowiki>  <small><span style="color:gray">''(#A2A9B1 is the [[Help:Basic table markup|wikitables]] border color.)''</span></small>


{{legend|black|Africa}}
{{legend|black|Africa}}
Line 21: Line 25:
{{legend|blue|Oceania}}
{{legend|blue|Oceania}}
{{legend|#ffa|Europe|outline=silver}}
{{legend|#ffa|Europe|outline=silver}}
{{legend|#ff2800|Asia}}
{{legend|#ff2800|Asia|outline=#A2A9B1}}


===Use in a caption ===
===Use in captions===
<pre><nowiki>
{{markup|<nowiki>
  [[Image:Celts in Europe.png|200px|thumb|right|The Celts in Europe, past and present:
  [[File:Celts in Europe.png|upright=.9|thumb|right|The Celts in Europe, past and present:
  {{legend|#1a8000|present-day Celtic-speaking areas}}
  {{legend|#1a8000|Present-day Celtic-speaking areas}}
  {{legend|#27c600|other parts of the six most commonly recognized 'Celtic nations' and where a  
  {{legend|#27c600|Other parts of the six most commonly recognized "Celtic nations" and where a Celtic language is spoken but not the dominating language}}
Celtic language is spoken but not the dominating language}}
  {{legend|#97ffb6|Other parts of Europe once peopled by Celts; modern-day inhabitants of many of these areas often claim a Celtic heritage and/or culture}}
  {{legend|#97ffb6|other parts of Europe once peopled by Celts; modern-day inhabitants of many of  
{{legend|#D2FFD2|Lusitanian area of Iberia, "Celticity" uncertain}}
these areas often claim a Celtic heritage and/or culture}}
{{legend|yellow|The core Hallstatt territory, expansion before 500 BC}}
  ]]
  ]]
</nowiki></pre>
</nowiki>|
[[Image:Celts in Europe.png|200px|thumb|right|The Celts in Europe, past and present:  
[[File:Celts in Europe.png|upright=.9|thumb|right|The Celts in Europe, past and present:
{{legend|#1a8000|present-day Celtic-speaking areas}}
{{legend|#1a8000|Present-day Celtic-speaking areas}}
{{legend|#27c600|other parts of the six most commonly recognized 'Celtic nations' and where a Celtic language is spoken but not the dominating language}}
{{legend|#27c600|Other parts of the six most commonly recognized "Celtic nations" and where a Celtic language is spoken but not the dominating language}}
{{legend|#97ffb6|other parts of Europe once peopled by Celts; modern-day inhabitants of many of these areas often claim a Celtic heritage and/or culture}}]]
{{legend|#97ffb6|Other parts of Europe once peopled by Celts; modern-day inhabitants of many of these areas often claim a Celtic heritage and/or culture}}
{{-}}
{{legend|#D2FFD2|Lusitanian area of Iberia, "Celticity" uncertain}}
{{legend|yellow|The core Hallstatt territory, expansion before 500 BC}}]]
}}
 
==Full parameter list==
<pre>
{{legend
| [legend box's colo(u)r]
| [text following legend box]
| outline =  <!--colo(u)r of border around legend box-->
| border =  <!--use to specify custom CSS styling for border (overrides 'outline')-->
| color =    <!--colo(u)r of 'text'-->
| size =    <!--'text' font-size-->
| text =    <!--to place text inside the legend box-->
}}
</pre>
 
==Limitations==
Using certain special characters in {{para|text}} that have meaning in wikitext can cause unexpected results. To use {{asterisk}} in {{para|text}}, use {{para|text|{{tlf|asterisk}}}}. To use # in {{para|text}}, use {{para|text|{{tlf|number sign}}}}.


==See also==
==See also==
* For a version of this template using ''display:inline'' to avoid line breaks after each legend, see {{tl|Legend inline}}.
*Variant blocks
* For a version of this template without block formatting, see {{tl|Legend2}}.
**{{tl|legend striped}}, two colors, for striped color areas
* For legend rows representing lines, see {{tl|legend-line}}.
**{{tl|legend inline}}, uses ''display:inline'' to avoid line breaks after each legend
<includeonly>
**{{tl|legend0}}, without the line-feed
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
**{{tl|leftlegend}}, with text-align set to left
**{{tl|color box}} and {{tl|RouteBox}}, with text placed inside the colored legend and article linking
*{{tl|legend-line}}, legends for lines
*{{tl|image key}}, allows legend templates being used in image captions to use multiple columns
*[[Web colors]]
 
==TemplateData==
{{TemplateData header}}
<templatedata>
{
"params": {
"1": {
"label": "Color",
"description": "The color for the legend entry, in any CSS format",
"example": "\"#6D6E00\", \"#ffa\", \"yellow\"",
"type": "line",
"required": true
},
"2": {
"label": "Caption",
"description": "Label for the legend entry",
"example": "\"soda\" is most common",
"type": "string",
"suggested": true
},
"border": {
"label": "CSS border style",
"description": "CSS style for the legend entry's border",
"type": "string"
},
"outline": {
"label": "Entry outline",
"description": "CSS color for the outline of the legend entry",
"example": "silver",
"type": "line"
},
"text": {
"label": "Text in the entry",
"description": "Text to be displayed in the legend entry box, i.e. within the color specified",
"example": "Af",
"type": "line"
},
"textcolor": {
"label": "Text color",
"description": "CSS color of text inside the legend's colored box",
"type": "string"
},
"size": {
"description": "Font size of the legend entry, including colored box",
"type": "string"
}
},
"description": "Shows a legend row with a colored box and a caption."
}
</templatedata>
 
<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Legend templates]]
[[Category:Legend templates]]


[[ar:قالب:مفتاح خريطة]]
}}</includeonly>
[[af:Sjabloon:Legend]]
[[bg:Шаблон:Легенда]]
[[ca:Template:Llegenda]]
[[cs:Šablona:Legenda]]
[[cy:Nodyn:Legend]]
[[da:Skabelon:Legend]]
[[de:Vorlage:Farblegende]]
[[dsb:Pśedłoga:Legenda]]
[[eo:Ŝablono:Priskribo]]
[[es:Plantilla:Leyenda]]
[[et:Mall:Legend]]
[[fr:Modèle:Légende]]
[[he:תבנית:מקרא]]
[[hi:Template:Legend]]
[[hsb:Předłoha:Legenda]]
[[id:Templat:Legend]]
[[ia:Patrono:Legend]]
[[is:Snið:Skýringartexti]]
[[it:Template:Legenda]]
[[ja:Template:Legend]]
[[ka:თარგი:ლეგენდა]]
[[ko:Template:범례]]
[[ku:Şablon:Legend]]
[[hu:Sablon:Jelmagyarázat]]
[[mk:Шаблон:Легенда]]
[[nl:Sjabloon:Legenda]]
[[nn:Mal:Legend]]
[[no:Mal:Legend]]
[[os:Шаблон:Легендæ]]
[[pl:Szablon:Legenda]]
[[pt:Predefinição:Legenda]]
[[rmy:Sikavno:Xalyaripen]]
[[ro:Format:Legendă]]
[[ru:Шаблон:Легенда]]
[[sk:Šablóna:Legenda]]
[[sl:Predloga:Legenda]]
[[cu:Обраꙁь́ць:Legend]]
[[sr:Шаблон:Легенда]]
[[fi:Malline:Seloste]]
[[sv:Mall:Legend]]
[[szl:Szablon:Legynda]]
[[tpi:Template:Legend]]
[[tr:Şablon:Legend]]
[[vep:Šablon:Legend]]
[[vi:Tiêu bản:Legend]]
[[uk:Шаблон:Legend]]
[[zh:Template:Legend]]
[[zu:Template:Legend]]
</includeonly>

Latest revision as of 14:35, 22 December 2021

Shows a legend row with a colored box.

Usage[edit source]

{{legend|background-color|caption|outline=outline color|border=css border}}
  • background-color is passed to the css background-color property of the color box.
  • The optional outline parameter is the color of the outline around the box.
  • The optional border argument which overrides the outline argument and sets the css description (e.g., 1px solid #aaa) of the border that will be drawn around the box.

Examples[edit source]

Use in text[edit source]

{{legend|black|Africa}}
{{legend|green|Americas}}
{{legend|blue|Oceania}}
{{legend|#ffa|Europe|outline=silver}}
{{legend|#ff2800|Asia|outline=#A2A9B1}}  (#A2A9B1 is the wikitables border color.)
  Africa
  Americas
  Oceania
  Europe
  Asia

Use in captions[edit source]

Markup Renders as
 [[File:Celts in Europe.png|upright=.9|thumb|right|The Celts in Europe, past and present:
 {{legend|#1a8000|Present-day Celtic-speaking areas}}
 {{legend|#27c600|Other parts of the six most commonly recognized "Celtic nations" and where a Celtic language is spoken but not the dominating language}}
 {{legend|#97ffb6|Other parts of Europe once peopled by Celts; modern-day inhabitants of many of these areas often claim a Celtic heritage and/or culture}}
 {{legend|#D2FFD2|Lusitanian area of Iberia, "Celticity" uncertain}}
 {{legend|yellow|The core Hallstatt territory, expansion before 500 BC}}
 ]]
File:Celts in Europe.png
The Celts in Europe, past and present:
  Present-day Celtic-speaking areas
  Other parts of the six most commonly recognized "Celtic nations" and where a Celtic language is spoken but not the dominating language
  Other parts of Europe once peopled by Celts; modern-day inhabitants of many of these areas often claim a Celtic heritage and/or culture
  Lusitanian area of Iberia, "Celticity" uncertain
  The core Hallstatt territory, expansion before 500 BC

Full parameter list[edit source]

{{legend
| [legend box's colo(u)r]
| [text following legend box]
| outline =  <!--colo(u)r of border around legend box-->
| border =   <!--use to specify custom CSS styling for border (overrides 'outline')-->
| color =    <!--colo(u)r of 'text'-->
| size =     <!--'text' font-size-->
| text =     <!--to place text inside the legend box-->
}}

Limitations[edit source]

Using certain special characters in |text= that have meaning in wikitext can cause unexpected results. To use * in |text=, use |text={{asterisk}}. To use # in |text=, use |text={{number sign}}.

See also[edit source]

  • Variant blocks
    • {{legend striped}}, two colors, for striped color areas
    • {{legend inline}}, uses display:inline to avoid line breaks after each legend
    • {{legend0}}, without the line-feed
    • {{leftlegend}}, with text-align set to left
    • {{color box}} and {{RouteBox}}, with text placed inside the colored legend and article linking
  • {{legend-line}}, legends for lines
  • {{image key}}, allows legend templates being used in image captions to use multiple columns
  • Web colors

TemplateData[edit source]

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. Click here to see a monthly parameter usage report for this template based on this TemplateData.

TemplateData for Legend

Shows a legend row with a colored box and a caption.

Template parameters

ParameterDescriptionTypeStatus
Color1

The color for the legend entry, in any CSS format

Example
"#6D6E00", "#ffa", "yellow"
Linerequired
Caption2

Label for the legend entry

Example
"soda" is most common
Stringsuggested
CSS border styleborder

CSS style for the legend entry's border

Stringoptional
Entry outlineoutline

CSS color for the outline of the legend entry

Example
silver
Lineoptional
Text in the entrytext

Text to be displayed in the legend entry box, i.e. within the color specified

Example
Af
Lineoptional
Text colortextcolor

CSS color of text inside the legend's colored box

Stringoptional
sizesize

Font size of the legend entry, including colored box

Stringoptional