本模板用以展示「icon」大小的旗幟，目前最大為23*15像素（定義在Flagicon/core中），外加一個像素的邊框。旗幟圖片包含一個指向對應條目的、可點擊的連結。如果需要不帶連結的旗幟圖標，請用Flagdeco。
使用本模板前請參閱QW:格式手冊/旗幟。
使用方法
{{flagicon|name|variant=|size=|noredlink=}}
- name
- 該參數必須填寫，它用來說明旗幟所屬國家、地區、城市等團體的名稱，可使用的旗幟的完整列表參見Category:地區資料模板內容。例如，填入參數名
Cuba時，該模板會自動調用Template:Country data Cuba以顯示古巴的旗幟。該項參數也可填入「別稱」，例如ISO 3166-1三位字母代碼、IOC或FIFA的國家代碼，可用的「別稱」參見Category:地區資料模板重定向。鑑於部分國家或地區的「別稱」可能晦澀難懂，因此鼓勵編者使用時輸入相關國家或地區完整的英語單詞或常見「別稱」。 - variant
- 該參數為選填，表示擬使用的是其他相關圖案，常見於展示某些國家歷史上曾使用的旗幟，或者海軍旗幟、體育代表團旗幟等。每個國家或地區在相關模板下可用的其他旗幟參見相關國家或地區旗幟模板的模板文檔中。 例如，Template:Country data Bulgaria 包含保加利亞可用旗幟的描述，相關旗幟可通過填入相關參數名稱(例如「
variant=1815」)或在第一個參數後直接填寫以調用相關內容。 - size
- 該參數為選填，用於指定使用圖像的最大寬度和/或高度。
模板數據
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}} |
| |
{{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 displayflag alias-xxxx— name of the image file of flag variantxxxxalias— used to display the alt attribute of the image (defaults to "Flag of alias")
追蹤分類
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)
相關模板
- Template:Flag is used to display a wikilinked name next to the flag. The displayed name will be the same as the parameter used with the template, but the link target will be the main article for the country (in these examples, Bulgaria).
- Template:Flagcountry is also used to display a wikilinked name next to the flag. The displayed name will always be the same, regardless of whether or not a country code alias is used as the template parameter.
- Template:Flagdeco displays an unlinked flag icon without country name.
{{flagdeco|Bulgaria}}→
For a full list of flag templates, see Category:Flag template system.
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}}
參見
重定向
- 模板連結：{{旗幟標誌}}