Template:Icon

From Terraria Wiki
Jump to navigation Jump to search
This template is i18n-ready, which means it is easy to localize for different languages. Please see I18n & l10n for templates to learn more.
See Template:Icon-version/l10n for the localization of this template.
Template-info.svg Documentation The documentation below is transcluded from Template:Icon/doc. (edit | history)

This template can be used to display one or more platform icons.

Note: If you only want to display a single platform icon, say, desktop, you can use {{icon|desktop}}, of course; but if in a performance-sensitive context (such as used in other templates), you should use {{icon/desktop}} (see here for all individual icon templates) directly. In addition, this also allows you to have full control over the icon size.

If the purpose of the icon is to show exclusivity of a certain entity or mechanic, {{eicons}} may be better to use instead.

Usage

{{ icon | <platform 1> | <platform 2> | ... | <platform n> | nl = y (optional) | small = y (optional) }}

Unnamed parameters

See below for the list of possible values. The possible number of unnamed parameters is nearly infinite; their order is irrelevant.

nl or nolink

Removes the link from the icons. They are linked by default.

small

Reduces the icons' size to 75%.

ParameterDescriptionTypeStatus
Platform1
Name of the platform
Line
required
Platform 22
Name of an additional platform.
Line
optional
Platform 33
Name of an additional platform.
Line
optional
Platform 44
Name of an additional platform.
Line
optional
Platform 55
Name of an additional platform. Repeat this as many times as necessary.
Line
optional
Unlink iconsnl
nolink
Remove the link from the icons.
Auto value:
True (1/y/yes)
Boolean
optional
Reduce icon sizesmall
Reduces the icons' size to 75%.
Auto value:
True (1/y/yes)
Boolean
optional

This template prefers inline formatting of parameters.

All valid icons

Values are listed in lowercase here, but are functionally case-insensitive.

Value Icon
Nintendo 3DS version
Amazon Appstore
Android
Console version
Desktop version
Google Play
iOS & iPadOS
Japanese Console version
Linux
macOS
Mobile version
Old-gen console version
PlayStation
PlayStation 3
PlayStation 4
PlayStation 5
PlayStation Vita
Stadia
Nintendo Switch
tModLoader version
Wii U
Windows
Windows Phone
Xbox
Xbox 360
Xbox One
Xbox Series X|S

Example

Code Result Expected result
{{icon| desktop }} Desktop version Desktop version
{{icon| desktop | console }} Desktop versionConsole version Desktop versionConsole version
{{icon| console | desktop }} Console versionDesktop version Console versionDesktop version
{{icon| desktop ||   | | console }}
(Blank parameters are irrelevant.)
Desktop versionConsole version Desktop versionConsole version
{{icon| dsk | 3ds | mbl | cns }} Desktop versionNintendo 3DS versionMobile versionConsole version Desktop versionNintendo 3DS versionMobile versionConsole version
{{icon| dsk | dsk | mbl }} Desktop versionDesktop versionMobile version Desktop versionDesktop versionMobile version
{{icon| oldgen | mobile | nl=y | small=y }} Old-gen console versionMobile version Old-gen console versionMobile version
{{icon| small=y | oldgen | nl=y | mobile }}
(Valid, but poor code readability, so not recommended.)
Old-gen console versionMobile version Old-gen console versionMobile version
All icons:
{{icon| desktop | console | japan | oldgen | mobile | 3ds }} Desktop versionConsole versionJapanese Console versionOld-gen console versionMobile versionNintendo 3DS version Desktop versionConsole versionJapanese Console versionOld-gen console versionMobile versionNintendo 3DS version
{{icon| desktop | console | japan | oldgen | mobile | 3ds | small=y }} Desktop versionConsole versionJapanese Console versionOld-gen console versionMobile versionNintendo 3DS version Desktop versionConsole versionJapanese Console versionOld-gen console versionMobile versionNintendo 3DS version

How to add new icon types

Only need to create a corresponding Template:Icon/<icon name> (its content can refer to {{icon/desktop}}). If you need to allow multiple valid parameters for it, use redirection.

For example, say, want to add a new iOS icon type:

  1. Create Template:Icon/ios (similar to {{icon/desktop}}). Note: The template name must use lowercase (i.e. not Template:icon/iOS, Template:Icon/IOS or Template:Icon/Ios). That's all. Now we can use {{icon|ios}} to display an iOS icon.
  2. If you want to add a new alias parameter for it, for example, you want to allow display a iOS icon by using {{icon|iphone}}, just create a redirect page Template:Icon/iphone, and set its redirect target to Template:Icon/ios.