View source for Template:Flag list/doc

{{Documentation subpage}}
{{Lua|Module:flag list}}
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 [[Template:Flag/doc|documentation of Template:Flag]] for general documentation and available parameters.

== Examples ==

{| 
! style="text-align:left;" |  {{tl|flag list}} and table=yes parameter
! style="text-align:left;" |  {{tl|flag list}}
! style="text-align:left;" |  {{tl|flag}}
|-style="vertical-align:top;"
|
{| border=1
|-
|{{flag list|Paraguay}}
|-
|
{{flag list|San Marino|table=yes}}
|-
|{{flag list|Palau}}
|-
|{{flag list|Australia}}
|-
|{{flag list|Nepal}}
|-
|{{flag list|Brazil}}
|-
|{{flag list|Iran}}
|-
|{{flag list|Switzerland}}
|-
|{{flag list|Qatar}}
|-
|{{flag list|China}}
|-
|{{flag list|Niger}}
|-
|{{flag list|Bosnia-Herzegovina|table=yes}}
|-
|
{{flag list|Socialist Republic of Romania|1948|table=yes}}
|-
|
{{flag list|USSR|table=yes}}{{flag list|Hungarian People's Republic|table=yes}}{{UKR}}
|}
|
*{{flag list|Paraguay}}
*{{flag list|San Marino}}
*{{flag list|Palau}}
*{{flag list|Australia}}
*{{flag list|Nepal}}
*{{flag list|Brazil}}
*{{flag list|Iran}}
*{{flag list|Switzerland}}
*{{flag list|Qatar}}
*{{flag list|China}}
*{{flag list|Niger}}
*{{flag list|Bosnia-Herzegovina}}
*{{flag list|Socialist Republic of Romania|1948}}
|
*{{flag|Paraguay}}
*{{flag|San Marino}}
*{{flag|Palau}}
*{{flag|Australia}}
*{{flag|Nepal}}
*{{flag|Brazil}}
*{{flag|Iran}}
*{{flag|Switzerland}}
*{{flag|Qatar}}
*{{flag|China}}
*{{flag|Niger}}
*{{flag|Bosnia-Herzegovina}}
*{{flag|Socialist Republic of Romania|1948}}
|}

{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{flag list|Georgia (U.S. state)|name=Georgia}}</nowiki>}}
{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{flag list|Germany}}</nowiki>}}
{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{flag list|Germany|empire}}</nowiki>}}
{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{flag list|Romania}}</nowiki>}}
{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{flag list|Romania|1948}}</nowiki>}}
{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{flag list|Socialist Republic of Romania}}</nowiki>}}
{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{flag list|Socialist Republic of Romania|short=yes}}</nowiki>}}
{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{flag list|UN}}</nowiki>}}
{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{flag list|World}}</nowiki>}}
{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{flag list|ITA}}</nowiki>}}
{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{flag list|SUI}}</nowiki>}}
{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{flag list|Switzerland}}</nowiki>}}
{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{flag list|Union of Soviet Socialist Republics|table=yes}}</nowiki>}}
{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{flag list|ITA|size=46x30px}}</nowiki>}}
{{nowiki template demo|format=inline|output=nowiki+|code=<nowiki>{{flag list|SUI|size=46x30px}}</nowiki>}}

== How it works ==
{{Lua|Module:flag list}}

{{tl|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 [[Flag of San Marino|San Marino]] and [[Flag of Niger|Niger]] (any flag with an [[List of national flags by aspect ratio|aspect ratio]] less than {{math|{{sfrac|23|15}} &asymp; 1.53}}), misaligning the country links next to them. The {{tl|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.

{{tl|flag list}} puts a flag icon inside an invisible &lt;[[Span tag|span]]&gt; box with a fixed width calculated by [[Module:flag list]]. The width does not depend on the exact dimensions of the image, but does vary with the maximum width and height specified using [[WP:EIS|extended image syntax]]. The default size for most countries' flags is 23x15px; the {{para|size}} parameter can be used if a different size is wanted. [[:Category:Country data templates with distinct default size|Some entities]] have different defaults specified within their data templates and may output misaligned links even if {{para|size}} is not used.

If a maximum width is specified (whether both width and height, e.g. <kbd>20x10px</kbd>, or width only, e.g. <kbd>20px</kbd>), either using the {{para|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 (<kbd>x10px</kbd>), 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 [[Flag of Qatar|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.

<templatedata>
{
	"params": {
		"1": {
			"label": "Country",
			"description": "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",
			"type": "string",
			"required": true
		},
		"2": {
			"aliases": [
				"variant"
			],
			"label": "Flag variant",
			"description": "Name of a variant that is configured in the country data template to display a flag variation, such as a historical flag.",
			"example": "empire",
			"type": "string"
		},
		"name": {
			"description": "Custom name to be displayed instead of ⟨1⟩.",
			"type": "string",
			"label": "Custom name"
		},
		"size": {
			"description": "Custom size of the flag icon.",
			"example": "x25px",
			"type": "string",
			"default": "23x15px",
			"label": "Custom flag size"
		},
		"short": {
			"label": "Short name",
			"description": "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.",
			"example": "yes",
			"type": "boolean",
			"default": "no",
			"suggested": true
		},
		"table": {
			"label": "Table alignment",
			"description": "Align country names that wrap across multiple lines next to the flag icon (by creating a table). Currently only for use within tables.",
			"example": "yes",
			"type": "boolean",
			"default": "no",
			"suggested": false
		}
	},
	"paramOrder": [
		"1",
		"name",
		"short",
		"2",
		"size",
        "table"
	],
	"description": " "
}
</templatedata>

== Usage with custom size ==
{| class="wikitable" style="width:65%"
|-
! width="10%" | {{para|size}} value
! width="20%" | {{tl|flag}} output
! width="20%" | {{tl|flag list}} output
! width="20%" | {{tl|flag list}} with table=yes output
|-
! 10px
|
*{{flag|Qatar|size=10px}}
*{{flag|Palau|size=10px}}
*{{flag|Switzerland|size=10px}}
*{{flag|Union of Soviet Socialist Republics|size=10px}}
|
*{{flag list|Qatar|size=10px}}
*{{flag list|Palau|size=10px}}
*{{flag list|Switzerland|size=10px}}
*{{flag list|Union of Soviet Socialist Republics|size=10px}}
|
{|
|-
|{{flag list|Qatar|size=10px}}
|-
|{{flag list|Palau|size=10px}}
|-
|{{flag list|Switzerland|size=10px|table=yes}}
|-
|{{flag list|Union of Soviet Socialist Republics|size=10px|table=yes}}
|}
|-
! x8px
|
*{{flag|Qatar|size=x8px}}
*{{flag|Palau|size=x8px}}
*{{flag|Switzerland|size=x8px}}
*{{flag|Union of Soviet Socialist Republics|size=x8px}}
|
*{{flag list|Qatar|size=x8px}}
*{{flag list|Palau|size=x8px}}
*{{flag list|Switzerland|size=x8px}}
*{{flag list|Union of Soviet Socialist Republics|size=x8px}}
|
{|
|-
|{{flag list|Qatar|size=x8px}}
|-
|{{flag list|Palau|size=x8px}}
|-
|{{flag list|Switzerland|size=x8px|table=yes}}
|-
|{{flag list|Union of Soviet Socialist Republics|size=x8px|table=yes}}
|}
|-
! 10x8px
|
*{{flag|Qatar|size=10x8px}}
*{{flag|Palau|size=10x8px}}
*{{flag|Switzerland|size=10x8px}}
*{{flag|Union of Soviet Socialist Republics|size=10x8px}}
|
*{{flag list|Qatar|size=10x8px}}
*{{flag list|Palau|size=10x8px}}
*{{flag list|Switzerland|size=10x8px}}
*{{flag list|Union of Soviet Socialist Republics|size=10x8px}}
|
{|
|-
|{{flag list|Qatar|size=10x8px}}
|-
|{{flag list|Palau|size=10x8px}}
|-
|{{flag list|Switzerland|size=10x8px|table=yes}}
|-
|{{flag list|Union of Soviet Socialist Republics|size=10x8px|table=yes}}
|}
|-
! 35px
|
*{{flag|Qatar|size=35px}}
*{{flag|Palau|size=35px}}
*{{flag|Switzerland|size=35px}}
*{{flag|Union of Soviet Socialist Republics|size=35px}}
|
*{{flag list|Qatar|size=35px}}
*{{flag list|Palau|size=35px}}
*{{flag list|Switzerland|size=35px}}
*{{flag list|Union of Soviet Socialist Republics|size=35px}}
|
{|
|-
|{{flag list|Qatar|size=35px}}
|-
|{{flag list|Palau|size=35px}}
|-
|{{flag list|Switzerland|size=35px|table=yes}}
|-
|{{flag list|Union of Soviet Socialist Republics|size=35px|table=yes}}
|}
|-
! x25px
|
*{{flag|Qatar|size=x25px}}
*{{flag|Palau|size=x25px}}
*{{flag|Switzerland|size=x25px}}
*{{flag|Union of Soviet Socialist Republics|size=x25px}}
|
*{{flag list|Qatar|size=x25px}}
*{{flag list|Palau|size=x25px}}
*{{flag list|Switzerland|size=x25px}}
*{{flag list|Union of Soviet Socialist Republics|size=x25px}}
|
{|
|-
|{{flag list|Qatar|size=x25px}}
|-
|{{flag list|Palau|size=x25px}}
|-
|{{flag list|Switzerland|size=x25px|table=yes}}
|-
|{{flag list|Union of Soviet Socialist Republics|size=x25px|table=yes}}
|}
|-
! 35x25px
|
*{{flag|Qatar|size=35x25px}}
*{{flag|Palau|size=35x25px}}
*{{flag|Switzerland|size=35x25px}}
*{{flag|Union of Soviet Socialist Republics|size=35x24px}}
|
*{{flag list|Qatar|size=35x24px}}
*{{flag list|Palau|size=35x24px}}
*{{flag list|Switzerland|size=35x24px}}
*{{flag list|Union of Soviet Socialist Republics|size=35x24px}}
|
{|
|-
|{{flag list|Qatar|size=35x24px}}
|-
|{{flag list|Palau|size=35x24px}}
|-
|{{flag list|Switzerland|size=35x24px|table=yes}}
|-
|{{flag list|Union of Soviet Socialist Republics|size=35x24px|table=yes}}
|}
|}

<includeonly>{{Sandbox other||
[[Category:Flag template system]]

}}</includeonly>

==Alternatives to avoid Wikipedia's [[WP:PEIS|Post-expand include size]] limit==
Pages with many flag icons may come close to or exceed Wikipedia's [[WP:PEIS|Post-expand include size]] limit.  In these cases consider using modules or module-wrapper templates instead:
* {{template link|flagg}} is a simple wrapper for [[Module:Flagg]]: For basic use, <code><nowiki>{{flag list|</nowiki>''country''<nowiki>}}</nowiki></code> can be replaced with <code><nowiki>{{flagg|usc|</nowiki>''country''<nowiki>}}</nowiki></code>
* {{module link|flag|list}} is a wrapper for [[Module:Flagg]] that can further reduce sizes when invoked directly. For basic use, <code><nowiki>{{flag list|</nowiki>''country''<nowiki>}}</nowiki></code> can be replaced with <code><nowiki>{{#invoke:flag|list|</nowiki>''country''<nowiki>}}</nowiki></code>.