Template:ItemBox: Difference between revisionsGive feedback

Latest revision as of 19:14, 1 August 2026

Template documentation [view] [edit] [history] [purge]

This template uses CSS found at ItemBox/styles.css.

Usage

{{ItemBox}} renders a Deadlock shop item as a card: icon, tier art, and the item name auto-sized to fit. Pass an item name and everything else — tier, slot, tags, image — is pulled from Module:ItemData.

{{ItemBox|Extended Magazine}}

Imbue

Extended Magazine

Active

Parameters

Template parameters[Edit template data]
This template prefers inline formatting of parameters.
Parameter		Description	Type	Status
itemName	`itemName` `1`	Item name; keys into Module:ItemData. Positional. Example Extended Magazine	String	required
size	`size`	Scales the whole card. 1 = default (80px wide), 1.5 = 150%, 0.75 = 75%. Default 1 Example 1.5	Number	optional
showTierTag	`showTierTag`	Set to true to show the tier corner badge. Suggested values `true` `false`	Boolean	optional
lowGraphics	`lowGraphics`	Set to true for pages that place many cards at once (the card navboxes). Swaps the paper texture to a cacheable overlay so scrolling stays smooth; the look is nearly identical. Suggested values `true` `false`	Boolean	optional
overrideDisplayName	`overrideDisplayName`	Replaces the name shown on the card. Example Test Name	String	optional
overrideTier	`overrideTier`	Replaces the card's tier. Suggested values `1` `2` `3` `4` `5`	Number	optional
overrideSlot	`overrideSlot`	Replaces the card's background (type). Suggested values `Weapon` `Vitality` `Spirit`	String	optional
overrideIsActive	`overrideIsActive`	Forces the ACTIVE tag on or off. Suggested values `true` `false`	Boolean	optional
overrideIsImbue	`overrideIsImbue`	Forces the IMBUE tag on or off. Suggested values `true` `false`	Boolean	optional
overrideLinkTooltip	`overrideLinkTooltip`	Page the hover tooltip reads its info from. Example Extended Magazine	String	optional
overrideLinkImage	`overrideLinkImage`	Page/file the icon image comes from. Example Extended Magazine	String	optional
overrideLinkClick	`overrideLinkClick`	Page the card links to when clicked. Example Bullet Lifesteal (item)	String	optional

Examples

Basic

{{ItemBox|Close Quarters}}
{{ItemBox|Spirit Shredder Bullets}}
{{ItemBox|Silencer}}
{{ItemBox|Extra Health}}
{{ItemBox|Echo Shard}}
{{ItemBox|Celestial Blessing}}

Imbue

Close Quarters

Active

Imbue

Spirit Shredder Bullets

Active

Imbue

Silencer

Active

Imbue

Extra Health

Active

Imbue

Echo Shard

Active

Imbue

Celestial Blessing

Active

Tier tag

{{ItemBox|Extended Magazine|showTierTag = true}}
{{ItemBox|Berserker|showTierTag = true}}
{{ItemBox|Echo Shard|showTierTag = true}}
{{ItemBox|Celestial Blessing|showTierTag = true}}

Imbue

Extended Magazine

Active

Imbue

Berserker

Active

Imbue

Echo Shard

Active

Imbue

Celestial Blessing

Active

Size

{{ItemBox|Extended Magazine|size = 0.75}}
{{ItemBox|Extended Magazine}}
{{ItemBox|Extended Magazine|size = 1.5}}

Imbue

Extended Magazine

Active

Imbue

Extended Magazine

Active

Imbue

Extended Magazine

Active

Low graphics

For pages that place many cards at once. The paper texture becomes a single cacheable overlay so scrolling stays smooth; the look is nearly identical.

{{ItemBox|Extra Health}}
{{ItemBox|Kinetic Dash}}
{{ItemBox|Metal Skin}}
{{ItemBox|Echo Shard}}

{{ItemBox|Extra Health|lowGraphics = true}}
{{ItemBox|Kinetic Dash|lowGraphics = true}}
{{ItemBox|Metal Skin|lowGraphics = true}}
{{ItemBox|Echo Shard|lowGraphics = true}}

Normal

Imbue

Extra Health

Active

Imbue

Kinetic Dash

Active

Imbue

Metal Skin

Active

Imbue

Echo Shard

Active

Low graphics

Imbue

Extra Health

Active

Imbue

Kinetic Dash

Active

Imbue

Metal Skin

Active

Imbue

Echo Shard

Active

Overrides

{{ItemBox|High-Velocity Rounds|overrideDisplayName = Test Name}}
{{ItemBox|Intensifying Magazine|overrideTier = 4}}
{{ItemBox|Weakening Headshot|overrideSlot = Spirit}}
{{ItemBox|Recharging Rush|overrideIsActive = true}}
{{ItemBox|Alchemical Fire|overrideIsImbue = true}}
{{ItemBox|Bullet Lifesteal|overrideLinkClick = Heroes}}

Imbue

Test Name

Active

Imbue

Intensifying Magazine

Active

Imbue

Weakening Headshot

Active

Imbue

Recharging Rush

Active

Imbue

Alchemical Fire

Active

Imbue

Bullet Lifesteal

Active

References

Item data — Data:ItemData.json, read by Module:ItemData
Name sizing and texture variety — Module:ItemBox
Card styling — Template:ItemBox/styles.css

@@ Line 8: / Line 8: @@
 -->{{#vardefine:displayName|{{{overrideDisplayName|{{#var:displayName}}}}}}}<!--
-      Measured name size (em) and stable per-item texture variety.
+      Measured name size (cqw) and stable per-item texture variety.
 -->{{#vardefine:fontSize|{{#invoke:ItemBox|getFontSize|{{#var:displayName}}}}}}<!--
 -->{{#vardefine:variants|{{#invoke:ItemBox|variants|{{#var:itemName}}}}}}<!--
@@ Line 21: / Line 21: @@
 -->{{#vardefine:isImbue|{{#ifeq:{{#var:isImbue}}|true|itembox-imbue}}}}<!--
-      lowGraphics=true is the setting for callers that place dozens of cards on
+      lowGraphics=true is for callers that place dozens of cards on one page (the
-     one page. The wear tint becomes a gradient and the icon mask is dropped,
+      card navboxes). It swaps the paper texture from the normal-mode multiply,
-      and the paper texture is composited into the icon and name area with
+      which blends two images and so is re-rasterised every scrolled frame, to a
-     background-blend-mode instead of the separate mix-blend-mode overlay. That
+      transparent-paper overlay that is a single cacheable image. On the profiled
-      is the change that matters: mix-blend-mode reads the page backdrop so
+      navbox this took the render thread's OpenGL work from ~230 ms/s to ~10 and
-     WebRender re-rasterises those regions every scrolled frame, while a
+     roughly doubled the frame rate. The wear and icon masks are clips of a
-      same-element blend stays a static tile. Removing the overlay blend cut the
+      single image, not blends, so they cache once rasterised and stay at full
-      render thread's OpenGL work on the profiled navbox by around 90%.
+      detail. The overlay itself is defined in [[Template:ItemBox/styles.css]] and
--->{{#vardefine:lowGraphics|{{#ifeq:{{{lowGraphics|}}}|true|itembox-ramp-wear itembox-flat-icon itembox-split-texture itembox-blend-tex-3}}}}<!--
+      keyed off the same per-item texture-vN class, so a card keeps its paper
+      across both modes.
-      The same layers individually, for testing combinations or overriding the
+-->{{#vardefine:lowGraphics|{{#ifeq:{{{lowGraphics|}}}|true|itembox-lowgfx}}}}<!--
-      bundle above. wearMask drops the mask from the wear tint three ways:
-     no   - tint moves behind the artwork, so only the card stock is coloured
-     ramp - tint stays on top, fading in from the card's edges
-     soft - tint stays on top, uniform and lighter, with the name lifted clear
-      texture handles the paper grain:
-     no    - drop it entirely
-/2/3 - one shared paper via the mix-blend overlay (does not cache)
-      blend / blend1..3 - paper multiplied into the card art only, cacheable
-     split / split1..3 - paper multiplied onto the icon and name area, so it
-             reaches the whole card, cacheable, grain continuous across the seam
--->{{#vardefine:lite|{{#switch:{{{wearMask|}}}|no=itembox-flat-wear|ramp=itembox-ramp-wear|soft=itembox-soft-wear}} {{#ifeq:{{{iconMask|}}}|no|itembox-flat-icon}} {{#switch:{{{texture|}}}|no=itembox-no-texture|1=itembox-force-tex-1|2=itembox-force-tex-2|3=itembox-force-tex-3|blend=itembox-blend-texture|blend1=itembox-blend-texture itembox-blend-tex-1|blend2=itembox-blend-texture itembox-blend-tex-2|blend3=itembox-blend-texture itembox-blend-tex-3|split=itembox-split-texture|split1=itembox-split-texture itembox-blend-tex-1|split2=itembox-split-texture itembox-blend-tex-2|split3=itembox-split-texture itembox-blend-tex-3}}}}<!--
       Links.
@@ Line 49: / Line 38: @@
 -->{{#vardefine:linkClick|{{{overrideLinkClick|{{#var:itemName}}{{If lang}}}}}}}<!--
---><div class="itembox {{#var:showTierTag}} {{#var:tier}} {{#var:slot}} {{#var:isActive}} {{#var:isImbue}} {{#var:variants}} {{#var:lowGraphics}} {{#var:lite}}" style="font-size:{{#expr: 10 * {{#if:{{{size|}}}|{{{size}}}|1}} }}px;">
+--><div class="itembox {{#var:showTierTag}} {{#var:tier}} {{#var:slot}} {{#var:isActive}} {{#var:isImbue}} {{#var:variants}} {{#var:lowGraphics}}" style="font-size:{{#expr: 10 * {{#if:{{{size|}}}|{{{size}}}|1}} }}px;">
 	<div class="itembox-background">
 		<div class="itembox-card">
@@ Line 61: / Line 50: @@
 				<div class="itembox-imbue-tag">{{#invoke:Lang|get_string|item_info_imbue}}</div>
 			</div>
-			<div class="itembox-name-area">
+			<!-- container-type is inline because TemplateStyles strips it; the name's cqw size measures against this box. -->
-				<p class="itembox-name" style="font-size:{{#var:fontSize}}em;text-wrap:balance;">{{#var:displayName}}</p>
+			<div class="itembox-name-area" style="container-type: inline-size;">
+				<p class="itembox-name" style="font-size:{{#var:fontSize}};text-wrap:balance;">{{#var:displayName}}</p>
 			</div>
 			<div class="itembox-wear"></div>

Template:ItemBox: Difference between revisionsGive feedback

Vergir (talk | contribs)

Latest revision as of 19:14, 1 August 2026

Contents

Usage

Parameters

Examples

Basic

Tier tag

Size

Low graphics

Overrides

References

Navigation menu