Module:Utilities/doc: Difference between revisions

From The Deadlock Wiki
Jump to navigation Jump to search
Sur (talk | contribs)
m get_slot_color trying an example with debug_mode
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
=Overview=
==Overview==
Utility functions that serve any miscellaneous purpose
Utility functions that serve any miscellaneous purpose


=Functions=
==Functions==


==get_slot_color==
==get_slot_color==
Retrieve's the hex color of a certain slot/category, formerly known in english as Weapon, Vitality, and Spirit, though their unlocalized names are Weapon, Armor, and Tech.
Retrieve's the color of a certain slot/category in any color format (default hex), formerly known in english as Weapon, Vitality, and Spirit, though their unlocalized names are Weapon, Armor, and Tech. Utilized by [[Template:Color]]


===Parameters===
===Parameters===
* '''slot''' - slot key, options are Weapon, Armor, and Tech
* '''slot''' - slot key, options are Weapon, Armor, and Tech
* '''color_format''' - color format, defaults to hex. Valid options are hex, rgb
* '''color_format''' - color format - Defaults to hex. Valid options are hex, rgb, hsl, cmyk
* '''no_wrap''' - (OPTIONAL) - Defaults to false. Set to true to remove prefixes and postfixes of '#' from hex, or 'rgb()', 'hsl()', and 'cmyk()' from the other formats. May be useful for altering the values dynamically
* '''debug_mode''' - (OPTIONAL) - Defaults to false. Used mostly for documentation purposes


===Examples===
===Examples===
To retrieve the color alone
See examples at [[Template:Color]]
<code><nowiki>{{#invoke:Utilities|get_slot_color|Tech}}</nowiki></code>


{{#invoke:Utilities|get_slot_color|Tech|debug_mode=true}}
==remove_trailing_colon==
Remove's the ":" character from the end of a string


===Examples===
<pre>{{#invoke:Utilities|remove_trailing_colon|A Fate's Tale:}}</pre>


To style text:
{{#invoke:Utilities|remove_trailing_colon|A Fate's Tale:}}
<code><nowiki><span style="color: {{#invoke:Utilities|get_slot_color|Tech}};">Tech colored text</span></nowiki></code>


<span style="color: {{#invoke:Utilities|get_slot_color|Tech}};">Tech colored text</span>
==process_variables==
Processes a localized string by replacing variable patterns with their corresponding values.


===Parameters===
* string_key - The localization key used to retrieve the base string (via Module:Lang)


To style divs:
* item_name - The name of the item used to look up variable values (via Module:ItemData)
<code><nowiki><div style="background-color: {{#invoke:Utilities|get_slot_color|Tech}}; padding: 10px; border-radius: 5px;">
Tech colored div
</div></nowiki></code>


===Examples===
Active Item descriptions in [[Template:Active Items]]
<pre>{{#invoke:Utilities|process_variables|upgrade_thermal_detonator_desc|Alchemical Fire}}</pre>


<div style="background-color: {{#invoke:Utilities|get_slot_color|Tech}}; padding: 10px; border-radius: 5px;">
{{#invoke:Utilities|process_variables|upgrade_thermal_detonator_desc|Alchemical Fire}}
Tech colored div
</div>

Latest revision as of 21:46, 11 April 2025

Overview

[edit source]

Utility functions that serve any miscellaneous purpose

Functions

[edit source]

get_slot_color

[edit source]

Retrieve's the color of a certain slot/category in any color format (default hex), formerly known in english as Weapon, Vitality, and Spirit, though their unlocalized names are Weapon, Armor, and Tech. Utilized by Template:Color

Parameters

[edit source]
  • slot - slot key, options are Weapon, Armor, and Tech
  • color_format - color format - Defaults to hex. Valid options are hex, rgb, hsl, cmyk
  • no_wrap - (OPTIONAL) - Defaults to false. Set to true to remove prefixes and postfixes of '#' from hex, or 'rgb()', 'hsl()', and 'cmyk()' from the other formats. May be useful for altering the values dynamically
  • debug_mode - (OPTIONAL) - Defaults to false. Used mostly for documentation purposes

Examples

[edit source]

See examples at Template:Color

remove_trailing_colon

[edit source]

Remove's the ":" character from the end of a string

Examples

[edit source]
{{#invoke:Utilities|remove_trailing_colon|A Fate's Tale:}}

A Fate's Tale

process_variables

[edit source]

Processes a localized string by replacing variable patterns with their corresponding values.

Parameters

[edit source]
  • string_key - The localization key used to retrieve the base string (via Module:Lang)
  • item_name - The name of the item used to look up variable values (via Module:ItemData)

Examples

[edit source]

Active Item descriptions in Template:Active Items

{{#invoke:Utilities|process_variables|upgrade_thermal_detonator_desc|Alchemical Fire}}

Throw a flask that explodes on contact, creating an area that does increasing spirit damage per second and reduces enemy Bullet Resist.

50% less effective vs non-heroes.