Template:Flagicon/sandbox

此Templatesandbox被引用於約94,000個頁面。
為了避免造成大規模的影響，所有對此Templatesandbox的編輯應先於沙盒、測試樣例或您的沙盒上測試。
測試後無誤的版本可以一次性地加入此Templatesandbox中，但是修改前請務必於討論頁發起討論。

模板引用數量會自動更新。

本模板用以展示“icon”大小的旗帜，目前预设为22*20像素（定义在Flagicon/core中），外加一个像素的边框。旗帜图片包含一个指向对应条目的、可点击的链接。如果需要不带链接的旗帜图标，请用Flagdeco。

使用本模板前请参阅Wikipedia:格式手册/旗帜。

使用方法

{{flagicon|name|variant=|size=|noredlink=}}

name: The first parameter is mandatory, and identifies the name of the country, region, city, etc. A full list of available values can be found in Category:Country data templates. For example, Template:Country data Bulgaria is used when the name parameter is specified as Bulgaria. Many flags are also available via shortened "aliases", such as standard three-letter country codes as specified by ISO 3166-1 alpha-3, IOC, or FIFA. The list of available "aliases" is found in Category:Country data redirects. Many of these country codes could be considered obscure, so it is recommended to use the full country name.
variant: The second parameter is optional, and identifies a flag variant to be used instead of the standard flag. This is most often used for historical flags but can also be used to specify naval flags, sport-use flags, etc. The list of available flag variants for each country is documented on the specific page for the country data template. For example, Template:Country data Bulgaria includes a description of each of the available flag variations for Bulgaria. This parameter can be a named parameter (e.g.. "variant=1815"), or a positional parameter, always after the country name.
size: This parameter is optional, and is used to specify the maximum width and/or height of the flag image. This parameter is specified using standard image syntax.

模板数据

以下是该模板的模板数据，适用于可视化编辑器等工具。

Flagicon模板数据

This template displays a wikilinked flag of the named parameter in 'icon' size, currently 23×15 pixels (defined in Template:Flagicon/core) plus a one-pixel border.

模板参数[编辑模板数据]
参数		描述	类型	状态
Name	`1`	Name of the country, region, city, etc.; full name is recommended for countries	字符串	必需
Variant	`variant` `2`	Identifies a flag variant to be used instead of the standard flag, e.g. 1815	字符串	可选
Maximum dimension	`size`	The maximum width or height, specified via standard 'extended image syntax' (e.g. x30px)	字符串	可选
No redlink	`noredlink`	If set to any value which evaluates as true (i.e. '1', 'true', 'yes', or 'y'), it displays nothing if the country data file doesn't exist. (The default is to display a redlink)	字符串	可选

举例

Wikicode	Results	Notes
`{{flagicon\|Bulgaria}}`
`{{flagicon\|BUL}}`		Uses the ISO/IOC/FIFA country code
`{{flagicon\|Bulgaria\|1946}}`		Specifies a historical flag
`{{flagicon\|Bulgaria\|variant=1946}}`		Specifies a historical flag
`{{flagicon\|BUL\|naval}}`		Specifies the naval ensign
`{{flagicon\|BUL\|air force}}`		Specifies the air force flag
`{{flagicon\|Bulgaria\|size=50px}}`		Sets width to 50 pixels
`{{flagicon\|Xanadu}}`	Template:Country data Xanadu	No flag for Xanadu, so displays redlink
`{{flagicon\|Xanadu\|noredlink=yes}}`	Template:Country data Xanadu	No flag, so displays nothing

Implementation notes

This template uses the data templates listed under Category:Country data templates, which contain the data specifying what to display and the formatter Template:Flagicon/core, which contains the logic of how to display the flag.

{{flagicon|Bulgaria}} → — uses Template:Country data Bulgaria
{{flagicon|BUL}} → — uses Template:Country data BUL, which is a redirect to Template:Country data Bulgaria

Inside each country data template, this template uses the following parameters:

flag alias — name of the image file to display
flag alias-xxxx — name of the image file of flag variant xxxx
alias — used to display the alt attribute of the image (defaults to "Flag of alias")

追踪分类

Category:Pages using flagicon template with unknown parameters（0）

Where {{Flagicon|Foo}} is used, but the Template:Country data Foo does not exist, then a redlink is displayed, unless the |noredlink=yes parameter has been set.

Where the redlink is displayed, the page is addded to a tracking category:

Category:Flagicons with missing country data templates (population: 0)

Alternatives to avoid Wikipedia's Post-expand include size limit

Pages with many flag icons may come close to or exceed Wikipedia's Post-expand include size limit. In these cases consider using modules or module-wrapper templates instead:

{{flagg}} is a simple wrapper for Module:Flagg: For basic use, {{flagicon|country}} can be replaced with {{flagg|cxxlo|country}}

参见

重定向

{{旗幟標誌}}

上述文档嵌入自Template:Flagicon/doc。
编者可以在本模板的沙盒和测试样例页面进行实验。
请在/doc子页面中添加分类。本模板的子页面。