Template:Flagicon

File:Test Template Info-Icon - Version (2).svg 模板文档[查看][编辑][历史][清除缓存]

此Template被引用於約128,000個頁面，佔全部頁面的12787%。
為了避免造成大規模的影響，所有對此Template的編輯應先於沙盒、測試樣例或您的沙盒上測試。实施修改前，建议先在討論頁發起討論。

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

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

<templatedata> { "description": "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.", "params": { "1": { "label": "Name", "description": "Name of the country, region, city, etc.; full name is recommended for countries", "type": "string", "required": true }, "variant": { "label": "Variant", "description": "Identifies a flag variant to be used instead of the standard flag, e.g. 1815", "type": "string", "required": false, "aliases": [ "2" ] }, "size": { "label": "Maximum dimension", "description": "The maximum width or height, specified via standard 'extended image syntax' (e.g. x30px)", "type": "string", "required": false }, "noredlink": { "label": "No redlink", "description": "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)", "type": "string", "required": false } } } </templatedata>

举例

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子页面中添加分类。本模板的子页面。