Difference between revisions of "Template:I-slot"

From Mine Blocks Wiki
Jump to navigation Jump to search
If you find a typo, inconsistency, or error, please sign up and help out the wiki! We can't do it without your help! :D Thank you!

Line 1: Line 1:
<span class="invslot-item" {{#if: {{{minetip-title|}}}|data-minetip-title="{{{minetip-title|{{{name}}}}}}" }} {{#if: {{{minetip-text|}}}|data-minetip-text="{{{minetip-text|}}}"}}>[[File:{{{name|Invisible-sprite}}}.png|{{{size|16}}}x{{{size|16}}}px|class=item-icon pixel {{{class|}}}|link={{{item-link|{{{name}}}}}}|{{{tooltip|{{{name}}}}}}]]</span><noinclude>
+
<span class="invslot-item" {{#if: {{{minetip-title|}}}|data-minetip-title="{{{minetip-title|{{{name}}}}}}"}} {{#if: {{{minetip-text|}}}|data-minetip-text="{{{minetip-text|}}}"}}>[[File:{{{name|Invisible-sprite}}}.png|{{{size|16}}}x{{{size|16}}}px|class=item-icon pixel {{{class|}}}|link={{{item-link|{{{name}}}}}}|{{{tooltip|{{{name}}}}}}]]</span><noinclude>
 
== About ==
 
== About ==
 
This templated (named '''I-slot''' as a shortcut for '''item-slot''') serves as an easy method to add icon sprites that are inside of a in-game slot, with tooltip included with the item's name and/or with extra info.
 
This templated (named '''I-slot''' as a shortcut for '''item-slot''') serves as an easy method to add icon sprites that are inside of a in-game slot, with tooltip included with the item's name and/or with extra info.
Line 64: Line 64:
 
| String
 
| String
 
| None
 
| None
| Optional.<br>Mandatory if <code>minetip-title</code> is being used
+
| Optional
 
|}
 
|}
  
 
== Examples ==
 
== Examples ==
* Name: <code><nowiki>{{I-slot|name=Wooden Planks}}</nowiki></code> {{I-slot|name=Wooden Planks}}
+
{| class="wikitable"
* Name and link: <code><nowiki>{{I-slot|name=Wooden Planks|link=Cow}}</nowiki></code> {{I-slot|name=Wooden Planks|link=Cow}}
+
! width="200"| Values used
* Name, link, and size: <code><nowiki>{{I-slot|name=Wooden Planks|link=Cow|size=24}}</nowiki></code> {{I-slot|name=Wooden Planks|link=Cow|size=24}}
+
! Code
* Name, link, size, and icon class: <code><nowiki>{{I-slot|name=Wooden Planks|link=Cow|size=24|class=thumb-class}}</nowiki></code> {{I-slot|name=Wooden Planks|link=Cow|size=24|class=thumb-class}}
+
! Result
* Name, link, size, icon class, and default tooltip text: <code><nowiki>{{I-slot|name=Wooden Planks|link=Cow|size=24|class=thumb-class|tooltip=Default tooltip text.}}</nowiki></code> {{I-slot|name=Wooden Planks|link=Cow|size=24|class=thumb-class|tooltip=Default tooltip text.}}
+
|-
* Name, link, size, icon class, default tooltip text, and empty mb tooltip title: <code><nowiki>{{I-slot|name=Wooden Planks|link=Cow|size=24|class=thumb-class|tooltip=Default tooltip text.|minetip-title=}}</nowiki></code> {{I-slot|name=Wooden Planks|link=Cow|size=24|class=thumb-class|tooltip=Default tooltip text.|minetip-title=}}
+
| Name
* Name, link, size, icon class, default tooltip text, and mb tooltip title with custom text: <code><nowiki>{{I-slot|name=Wooden Planks|link=Cow|size=24|class=thumb-class|tooltip=Default tooltip text.|minetip-title=Lorem ipsum}}</nowiki></code> {{I-slot|name=Wooden Planks|link=Cow|size=24|class=thumb-class|tooltip=Default tooltip text.|minetip-title=Lorem ipsum}}
+
|
* Name, link, size, icon class, default tooltip text, and empty mb tooltip text: <code><nowiki>{{I-slot|name=Wooden Planks|link=Cow|size=24|class=thumb-class|tooltip=Default tooltip text.|minetip-text=}}</nowiki></code> {{I-slot|name=Wooden Planks|link=Cow|size=24|class=thumb-class|tooltip=Default tooltip text.|minetip-text=}}
+
<pre><nowiki>
* Name, link, size, icon class, default tooltip text, and mb tooltip with custom text: <code><nowiki>{{I-slot|name=Wooden Planks|link=Cow|size=24|class=thumb-class|tooltip=Default tooltip text.|minetip-text=Dolor sit amet.}}</nowiki></code> {{I-slot|name=Wooden Planks|link=Cow|size=24|class=thumb-class|tooltip=Default tooltip text.|minetip-text=Dolor sit amet.}}
+
{{I-slot
* Name, link, size, icon class, default tooltip text, mb tooltip title with custom text, and mb tooltip with custom text: <code><nowiki>{{I-slot|name=Wooden Planks|link=Cow|size=24|class=thumb-class|tooltip=Default tooltip text.|minetip-title=Lorem ipsum|minetip-text=Dolor sit amet.}}</nowiki></code> {{I-slot|name=Wooden Planks|link=Cow|size=24|class=thumb-class|tooltip=Default tooltip text.|minetip-title=Lorem ipsum|minetip-text=Dolor sit amet.}}
+
  | name = Wooden Planks
 +
}}
 +
</nowiki></pre>
 +
|
 +
{{I-slot
 +
  | name = Wooden Planks}}
 +
|-
 +
| Name and link
 +
|
 +
<pre><nowiki>
 +
{{I-slot
 +
  | name = Wooden Planks
 +
  | link = Cow
 +
}}
 +
</nowiki></pre>
 +
|
 +
{{I-slot
 +
  | name = Wooden Planks
 +
  | link = Cow
 +
}}
 +
|-
 +
| Name, link, and size
 +
|
 +
<pre><nowiki>
 +
{{I-slot
 +
  | name = Wooden Planks
 +
  | link = Cow
 +
  | size = 24
 +
}}
 +
</nowiki></pre>
 +
|
 +
{{I-slot
 +
  | name = Wooden Planks
 +
  | link = Cow
 +
  | size = 24
 +
}}
 +
|-
 +
| Name, link, size, and icon class
 +
|
 +
<pre><nowiki>
 +
{{I-slot
 +
  | name = Wooden Planks
 +
  | link = Cow
 +
  | size = 24
 +
  | class = thumb-class
 +
}}
 +
</nowiki></pre>
 +
|
 +
{{I-slot
 +
  | name = Wooden Planks
 +
  | link = Cow
 +
  | size = 24
 +
  | class = thumb-class
 +
}}
 +
|-
 +
| Name, link, size, icon class, and default tooltip text
 +
|
 +
<pre><nowiki>
 +
{{I-slot
 +
  | name = Wooden Planks
 +
  | link = Cow
 +
  | size = 24
 +
  | class = thumb-class
 +
  | tooltip = Default tooltip text.
 +
}}</nowiki></pre>
 +
|
 +
{{I-slot
 +
  | name = Wooden Planks
 +
  | link = Cow
 +
  | size = 24
 +
  | class = thumb-class
 +
  | tooltip = Default tooltip text.
 +
}}
 +
|-
 +
| Name, link, size, icon class, default tooltip text, and empty mb tooltip title
 +
|
 +
<pre><nowiki>
 +
{{I-slot
 +
  | name = Wooden Planks
 +
  | link = Cow
 +
  | size = 24
 +
  | class = thumb-class
 +
  | tooltip = Default tooltip text.
 +
  | minetip-title =
 +
}}</nowiki></pre>
 +
|
 +
{{I-slot
 +
  | name = Wooden Planks
 +
  | link = Cow
 +
  | size = 24
 +
  | class = thumb-class
 +
  | tooltip = Default tooltip text.
 +
  | minetip-title =
 +
}}
 +
|-
 +
| Name, link, size, icon class, default tooltip text, and mb tooltip title with custom text
 +
|
 +
<pre><nowiki>
 +
{{I-slot
 +
  | name = Wooden Planks
 +
  | link = Cow
 +
  | size = 24
 +
  | class = thumb-class
 +
  | tooltip = Default tooltip text.
 +
  | minetip-title = Lorem Ipsum
 +
}}
 +
</nowiki></pre>
 +
|
 +
{{I-slot
 +
  | name = Wooden Planks
 +
  | link = Cow
 +
  | size = 24
 +
  | class = thumb-class
 +
  | tooltip = Default tooltip text.
 +
  | minetip-title = Lorem Ipsum
 +
}}
 +
|-
 +
| Name, link, size, icon class, default tooltip text, and empty mb tooltip text
 +
|
 +
<pre><nowiki>
 +
{{I-slot
 +
  | name = Wooden Planks
 +
  | link = Cow
 +
  | size = 24
 +
  | class = thumb-class
 +
  | tooltip = Default tooltip text.
 +
  | minetip-text =
 +
}}
 +
</nowiki></pre>
 +
|
 +
{{I-slot
 +
  | name = Wooden Planks
 +
  | link = Cow
 +
  | size = 24
 +
  | class = thumb-class
 +
  | tooltip = Default tooltip text.
 +
  | minetip-text =
 +
}}
 +
|-
 +
| Name, link, size, icon class, default tooltip text, and mb tooltip with custom text
 +
|
 +
<pre><nowiki>
 +
{{I-slot
 +
  | name = Wooden Planks
 +
  | link = Cow
 +
  | size = 24
 +
  | class = thumb-class
 +
  | tooltip = Default tooltip text.
 +
  | minetip-text = Dolor sit amet.
 +
}}</nowiki></pre>
 +
|
 +
{{I-slot
 +
  | name = Wooden Planks
 +
  | link = Cow
 +
  | size = 24
 +
  | class = thumb-class
 +
  | tooltip = Default tooltip text.
 +
  | minetip-text = Dolor sit amet.
 +
}}
 +
|-
 +
| Name, link, size, icon class, default tooltip text, mb tooltip title with custom text, and mb tooltip with custom text
 +
|
 +
<pre><nowiki>
 +
{{I-slot
 +
  | name = Wooden Planks
 +
  | link = Cow
 +
  | size = 24
 +
  | class = thumb-class
 +
  | tooltip = Default tooltip text.
 +
  | minetip-title = Lorem Ipsum
 +
  | minetip-text = Dolor sit amet.
 +
}}</nowiki></pre>
 +
|
 +
{{I-slot
 +
  | name = Wooden Planks
 +
  | link = Cow
 +
  | size = 24
 +
  | class = thumb-class
 +
  | tooltip = Default tooltip text.
 +
  | minetip-title = Lorem Ipsum
 +
  | minetip-text = Dolor sit amet.
 +
}}
 +
|}
  
== Note ==
+
== Notes ==
Despite the default tooltip being removed if the custom mb tooltip is being used, it's recommended to not remove it (using the parameter but leaving its value empty) since it will display as a fallback in case the user has disabled their JavaScript.
+
* If a custom value for the icons' size is going to be used, it should be any of these: <code>16</code>, <code>18</code>, <code>20</code>, <code>22</code>, or <code>24</code>.
 +
** Using any other value will make the icon to not be centered.
 +
** Using a value higher than the ones mentioned above will make the icon overflow from its container box.
 +
* Despite the default tooltip being removed if the custom mb tooltip is being used, it's recommended to not remove it (using the parameter but leaving its value empty) since it will display as a fallback in case the user has disabled their JavaScript.
 
</noinclude>
 
</noinclude>

Revision as of 12:15, 18 December 2021

{{{name}}}

About

This templated (named I-slot as a shortcut for item-slot) serves as an easy method to add icon sprites that are inside of a in-game slot, with tooltip included with the item's name and/or with extra info.

Usage

The syntax of the template is:

{{I-slot
|name = <file-name>
|link = <item-link>
|size = <file-size> (width and height at the same time)
|class = <file-class>
|tooltip = <default-tooltip-text>
|minetip-title = <mb-minetip-title>
|minetip-text = <mb-minetip-text>
}}

. Note tht minetip-title and minetip-text are mandatory for the tooltip to work. In case you don't need minetip-text, you can mention the parameter and leave it empty. minetip-title defaults to the first parameter (file-name)'s text if it's not used.

Parameter Function Value type Default value Status
name It's the item's name. It's mainly used for the image name. No format is needed to specify. String Invisible-sprite Recommended
link Icon's link. Wikitext name's value Optional
size Icon's size (both width and height share the same value to keep the image fully squared). Integer 16 Optional
class Icon's extra classes. String None Optional
tooltip Icon's default tooltip text. It's automatically removed if the Mine Blocks-themed tooltip isbeing used (see below). String name's value Optional
minetip-title Icon's Mine Block tooltip title. String name's value Optional
minetip-text Icon's Mine Block tooltip text. Use the forward slash (/) as line breaks. String None Optional

Examples

Values used Code Result
Name
{{I-slot
  | name = Wooden Planks
}}

Wooden Planks

Name and link
{{I-slot
  | name = Wooden Planks
  | link = Cow
}}

Wooden Planks

Name, link, and size
{{I-slot
  | name = Wooden Planks
  | link = Cow
  | size = 24
}}

Wooden Planks

Name, link, size, and icon class
{{I-slot
  | name = Wooden Planks
  | link = Cow
  | size = 24
  | class = thumb-class
}}

Wooden Planks

Name, link, size, icon class, and default tooltip text
{{I-slot
  | name = Wooden Planks
  | link = Cow
  | size = 24
  | class = thumb-class
  | tooltip = Default tooltip text.
}}

Default tooltip text.

Name, link, size, icon class, default tooltip text, and empty mb tooltip title
{{I-slot
  | name = Wooden Planks
  | link = Cow
  | size = 24
  | class = thumb-class
  | tooltip = Default tooltip text.
  | minetip-title =
}}

Default tooltip text.

Name, link, size, icon class, default tooltip text, and mb tooltip title with custom text
{{I-slot
  | name = Wooden Planks
  | link = Cow
  | size = 24
  | class = thumb-class
  | tooltip = Default tooltip text.
  | minetip-title = Lorem Ipsum
}}

Default tooltip text.

Name, link, size, icon class, default tooltip text, and empty mb tooltip text
{{I-slot
  | name = Wooden Planks
  | link = Cow
  | size = 24
  | class = thumb-class
  | tooltip = Default tooltip text.
  | minetip-text =
}}

Default tooltip text.

Name, link, size, icon class, default tooltip text, and mb tooltip with custom text
{{I-slot
  | name = Wooden Planks
  | link = Cow
  | size = 24
  | class = thumb-class
  | tooltip = Default tooltip text.
  | minetip-text = Dolor sit amet.
}}

Default tooltip text.

Name, link, size, icon class, default tooltip text, mb tooltip title with custom text, and mb tooltip with custom text
{{I-slot
  | name = Wooden Planks
  | link = Cow
  | size = 24
  | class = thumb-class
  | tooltip = Default tooltip text.
  | minetip-title = Lorem Ipsum
  | minetip-text = Dolor sit amet.
}}

Default tooltip text.

Notes

  • If a custom value for the icons' size is going to be used, it should be any of these: 16, 18, 20, 22, or 24.
    • Using any other value will make the icon to not be centered.
    • Using a value higher than the ones mentioned above will make the icon overflow from its container box.
  • Despite the default tooltip being removed if the custom mb tooltip is being used, it's recommended to not remove it (using the parameter but leaving its value empty) since it will display as a fallback in case the user has disabled their JavaScript.