Iconed text

<includeonly><span class="iconed-text" style="white-space:nowrap; {{{style|}}}">{{#switch: {{{3}}}
| external 
| link = {{{1}}}
| fa
| icon = {{fa|{{{1}}}|{{{faStyle|solid}}}|color={{{faColor|}}}|style={{{faCssStyle|}}}}}
| file
| image
| #default = [[File:{{{1}}}|{{{2|}}}|x20px|link=]] }}<nowiki></nowiki>&nbsp;{{{2}}}</span></includeonly><noinclude>[[Category:Annotation templates]]
==Iconed text template==
This template adds an icon image next to a short bit of text. Used as a parent template for several other templates, such as {{tt|NTN}}.

<div class="mw-collapsible mw-collapsed">
=== Syntax ===
<div class="mw-collapsible-content">{{Template journal|iconed text|icon source|text|icon style (optional)|style{{=}}additional css styles (optional)|faStyle{{=}}FontAwesome icon style (optional)|faColor{{=}}FontAwesome icon color (optional)|faCssStyle{{=}}additional css styles for an FA icon (optional)}}

The first 2 unnamed parameters must be specified, while a third one is optional.
* The first parameter serves as the icon's source, by default the name and extension of a file stored on the wiki
* The second parameter is the text to display next to the icon

The third unnamed parameter can be specified to set the icon's style. This is by default an image stored on the wiki, but the template can also use FontAwesome icons (using the {{tt|fa}} template) or an external image using [[mw:Manual:Linked_images#External_image_syntax|mw:inline linking]]. The external image method is widely used on the wiki by the {{tt|Player}} template.

There are several more optional parameters: 
* {{para|style}}, which can be used to set further inline css styles on this template
* {{para|faStyle}}, which can be used to set a FontAwesome icon's own style. This defaults to "solid", but also accepts "regular" or "brands". (See the [[Template:Fa]] page for more information.)
* {{para|faColor}}, which sets a FontAwesome icon's own color. This accepts any valid CSS color value (eg. html color names such as "red", hex values like "#000000", etc.)
* {{para|faCssStyle}}, which can set additional inline css styles on the {{t|fa}} template. (Not this one, use {{para|style}} for that!)
</div></div>

===Example===
==== Using a file hosted on the wiki ====
* <code><nowiki>{{Iconed text|Rail.png|An image of a rail item}}</nowiki></code> generates: {{Iconed text|Rail.png|An image of a rail item}}
* <code><nowiki>{{Iconed text|Rail.png|An image of a rail item|file}}</nowiki></code> generates: {{Iconed text|Rail.png|An image of a rail item|file}}
* <code><nowiki>{{Iconed text|Rail.png|An image of a rail item|image}}</nowiki></code> generates: {{Iconed text|Rail.png|An image of a rail item|image}}

==== Using a FontAwesome icon ====
* <code><nowiki>{{Iconed text|cat|An image of a cat|icon}}</nowiki></code> generates: {{Iconed text|cat|An image of a cat|icon}}
* <code><nowiki>{{Iconed text|cat|An image of a cat|fa}}</nowiki></code> generates: {{Iconed text|cat|An image of a cat|fa}}
* <code><nowiki>{{Iconed text|discord|The discord logo|fa|faStyle=brands}}</nowiki></code> generates: {{Iconed text|discord|The discord logo|fa|faStyle=brands}}
* <code><nowiki>{{Iconed text|sun|An orange sun|fa|faStyle=regular|faColor=orangered}}</nowiki></code> generates: {{Iconed text|sun|An orange sun|fa|faStyle=regular|faColor=orangered}}

==== Using an external link ====
External links must end in .png, .jpg or another file extension. (It must directly link to an image resource)
* <code><nowiki>{{Iconed text|https://minotar.net/helm/MHF_Steve/20.png|''Steve''|external}}</nowiki></code> generates: {{Iconed text|https://minotar.net/helm/MHF_Steve/20.png|''Steve''|external}}
===Template Data===
<noinclude>
<templatedata>
{
	"params": {
		"1": {
			"label": "Icon source",
			"description": "This is the text to display next to the icon",
			"example": "Rail.png",
			"type": "wiki-file-name",
			"required": true,
			"suggested": true
		},
		"2": {
			"label": "Text",
			"description": "This is the text to display next to the icon",
			"example": "The image of a rail item",
			"type": "string",
			"required": true,
			"suggested": true
		},
		"3": {
			"label": "Style",
			"description": "The icon's style. Optional and can be left blank, defaults to a file hosted on the wiki. Also accepts \"fa\" or \"icon\" for specifying a FontAwesome icon, or \"link\" or \"external\" for using an external link.",
			"example": "external",
			"type": "string",
			"default": "file",
			"suggested": true
		},
		"style": {
			"label": "Css style",
			"description": "Can be used to optionally set further inline styles on this template.",
			"example": "font-size: 25px;",
			"type": "string"
		},
		"faStyle": {
			"label": "FontAwesome icon style",
			"description": "Can be used to set a FontAwesome icon's own style. This defaults to \"solid\", but also accepts \"regular\" or \"brands\". (See the Template:Fa page for more information.)",
			"example": "brands",
			"type": "string",
			"default": "solid"
		},
		"faColor": {
			"label": "FontAwesome icon color",
			"description": "Sets a FontAwesome icon's own color. This accepts any valid CSS color value (eg. html color names such as \"red\", hex values like \"#000000\", etc.)",
			"example": "orangered or #ff0000",
			"type": "string"
		},
		"faCssStyle": {
			"label": "FontAwesome icon css style",
			"description": "Can set additional inline css styles on the {{fa}} template. (Not this one, use the base style parameter for that!)",
			"example": "font-size: small;",
			"type": "string"
		}
	},
	"description": "This template adds an icon image next to a short bit of text. Used as a parent template for several other templates, such as {{NTN}}, directly using it is uncommon.",
	"format": "inline"
}
</templatedata>__NOTOC__
</noinclude>