模板:Flagicon/sandbox

此模板沙盒被引用於約94,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}}

參見

重定向

{{旗幟標誌}}

上述文件嵌入自Template:Flagicon/doc。
編者可以在本模板的沙盒和測試樣例頁面進行實驗。
請在/doc子頁面中添加分類。本模板的子頁面。