Tɛmplet:Flaglist/doc

This template is identical to Template:Flag except that the names are aligned correctly with flag icons of different widths. It is for use in lists of countries, states, provinces, etc.. See the documentation of Template:Flag for general documentation and available parameters.

Examples

Example country table using {{flaglist}} and table=yes parameter	Example country list using {{flaglist}}	Example country list using {{flag}}
Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/coretable	Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core	Paraguay Tɛmplet:Country data San Marino Tɛmplet:Country data Palau Australia Tɛmplet:Country data Nepal Brazil Tɛmplet:Country data Iran Switzerland Tɛmplet:Country data Qatar China Tɛmplet:Country data Niger Tɛmplet:Country data Bosnia-Herzegovina Socialist Republic of Romania

{{Flaglist}}

{{Flaglist/sandbox}}

{{Flaglist}}

{{Flaglist/sandbox}}

{{Flaglist}}

{{Flaglist/sandbox}}

{{Flaglist}}

{{Flaglist/sandbox}}

{{Flaglist}}

{{Flaglist/sandbox}}

{{Flaglist}}

{{Flaglist/sandbox}}

{{Flaglist}}

{{Flaglist/sandbox}}

{{Flaglist}}

{{Flaglist/sandbox}}

{{Flaglist}}

{{Flaglist/sandbox}}

{{Flaglist}}

{{Flaglist/sandbox}}

{{Flaglist}}

{{Flaglist/sandbox}}

{{Flaglist}}

{{Flaglist/sandbox}}

{{Flaglist}}

{{Flaglist/sandbox}}

{{Flaglist}}

{{Flaglist/sandbox}}

How it works

{{Flag}} generates a flag icon, a non-breaking space and the country link, which means the alignment of the link depends on the width of the flag image. The default size for flag icons is 23x15px, so the icon width is 23px for long flags but smaller for more squarish flags such as those of San Marino and Niger (any flag with an aspect ratio less than 23/15 ≈ 1.53), misaligning the country links next to them. The {{Flag/core}} template, used internally by {{flag}}, compensates for this for Nepal, Vatican City and Switzerland by inserting some extra spaces, though for several other countries the link is still shifted too far to the left, as seen above.

{{Flaglist}} puts a flag icon inside an invisible <span> box with a fixed width calculated by Module:Flaglist. The width does not depend on the exact dimensions of the image, but does vary with the maximum width and height specified using extended image syntax. The default size for most countries' flags is 23x15px; the |size= parameter can be used if a different size is wanted. Some entities have different defaults specified within their data templates and may output misaligned links even if |size= is not used.

If a maximum width is specified (whether both width and height, e.g. 20x10px, or width only, e.g. 20px), either using the |size= parameter or the data template default, the box size is equal to this width plus seven pixels. If a height is specified but a width is not (x10px), a box width of 2.2 times the height plus seven pixels is used. In the latter case, flags with an aspect ratio greater than 2.2 (the only such current national flag being that of Qatar) may extend beyond the invisible box and overlap the country link at certain sizes, as seen in the table below. For this reason, if an icon size different from the default is wanted, it is best to always specify both a width and a height. This also ensures that neither squarish nor long flags are rendered much bigger than other flags.

Template parameters

Parameter		Description	Type	Status
Country	1	Display the small flag icon of this country. A flag will only be displayed if the related template {{country data ⟨1⟩}} exists with the ⟨flag alias⟩ parameter (otherwise a transparent placeholder is used to preserve text alignment inside lists). Example Germany	String	required
Custom name	name	Custom name to be displayed instead of ⟨1⟩.	String	optional
Short name	short	Display the ⟨shortname alias⟩ that is configured in the country data template, instead of the name given with ⟨1⟩ or ⟨name⟩. If there is no shortname alias, then ⟨alias⟩ from the country data template is used. Default no Example yes	Boolean	suggested
Flag variant	2 variant	Name of a variant that is configured in the country data template to display a flag variation, such as a historical flag. Example empire	String	optional
Custom flag size	size	Custom size of the flag icon. Default 23x15px Example x25px	String	optional
Table alignment	table	Align country names that wrap across multiple lines next to the flag icon (by creating a table). Currently only for use within tables. Default no Example yes	Boolean	optional

Usage with custom size

|size= value	{{flag}} output	{{flaglist}} output	{{flaglist}} with table=yes output
10px	Tɛmplet:Country data Qatar Tɛmplet:Country data Palau Switzerland Tɛmplet:Country data Union of Soviet Socialist Republics	Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core	Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/coretable Tɛmplet:Flaglist/coretable
x8px	Tɛmplet:Country data Qatar Tɛmplet:Country data Palau Switzerland Tɛmplet:Country data Union of Soviet Socialist Republics	Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core	Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/coretable Tɛmplet:Flaglist/coretable
10x8px	Tɛmplet:Country data Qatar Tɛmplet:Country data Palau Switzerland Tɛmplet:Country data Union of Soviet Socialist Republics	Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core	Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/coretable Tɛmplet:Flaglist/coretable
35px	Tɛmplet:Country data Qatar Tɛmplet:Country data Palau Switzerland Tɛmplet:Country data Union of Soviet Socialist Republics	Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core	Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/coretable Tɛmplet:Flaglist/coretable
x25px	Tɛmplet:Country data Qatar Tɛmplet:Country data Palau Switzerland Tɛmplet:Country data Union of Soviet Socialist Republics	Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core	Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/coretable Tɛmplet:Flaglist/coretable
35x25px	Tɛmplet:Country data Qatar Tɛmplet:Country data Palau Switzerland Tɛmplet:Country data Union of Soviet Socialist Republics	Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core	Tɛmplet:Flaglist/core Tɛmplet:Flaglist/core Tɛmplet:Flaglist/coretable Tɛmplet:Flaglist/coretable