模板:Flagicon/doc

此页面是Template:Flagicon的模板文档。
此页面可能包含了模板的使用说明、分类和其他内容。

此模板文档被引用于约126,000个页面。
为了避免造成大规模的影响，所有对此模板文档的编辑应先于沙盒、测试样例或您的沙盒上测试。
测试后无误的版本可以一次性地加入此模板文档中，但是修改前请务必于讨论页发起讨论。

模板引用数量会自动更新。

本模板用以展示“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}}

参见

重定向

{{旗帜标志}}