WoW:SpellLink - Revision history

Move page script: Move page script moved page SpellLink to WoW:SpellLink without leaving a redirect

2023-08-15T04:48:58Z

Move page script moved page SpellLink to SpellLink without leaving a redirect

← Older revision	Revision as of 04:48, 15 August 2023
(No difference)

WoWWiki>Starlightblunder: eat first header

2010-06-06T20:07:07Z

eat first header

← Older revision		Revision as of 20:07, 6 June 2010
Line 1:		Line 1:
	{{DISPLAYTITLE:spellLink}}		{{DISPLAYTITLE:spellLink}}
	{{wowapitype}}~~<br>~~		{{wowapitype}}

	~~== spellLink API Type (String) ==~~

	spellLinks are returned by several functions, e.g. [[API GetSpellLink\|GetSpellLink]](), etc.		spellLinks are returned by several functions, e.g. [[API GetSpellLink\|GetSpellLink]](), etc.

WoWWiki>WoWWiki-Stewart: the spelllink was in the format of an itemlink, trimmed the excess fields

2009-01-18T15:27:08Z

the spelllink was in the format of an itemlink, trimmed the excess fields

← Older revision		Revision as of 15:27, 18 January 2009
Line 16:		Line 16:
	** The next three sets of two characters represent the red, green, and blue levels, just like HTML.		** The next three sets of two characters represent the red, green, and blue levels, just like HTML.
	* <tt>"'''\|H'''"</tt> – "Hyperlink link data starts here"		* <tt>"'''\|H'''"</tt> – "Hyperlink link data starts here"
	* <tt>"'''spell:10060~~:0:0:0:0:0:0:0~~'''"</tt> – Read more at [[spellString]].		* <tt>"'''spell:10060'''"</tt> – Read more at [[spellString]].
	* <tt>"'''\|h'''"</tt> – "End of link, text follows"		* <tt>"'''\|h'''"</tt> – "End of link, text follows"
	* <tt>"'''[Power Infusion]'''"</tt> – The actual text displayed		* <tt>"'''[Power Infusion]'''"</tt> – The actual text displayed

WoWWiki>Farmbuyer: Changed example to use an actual spell instead of itemlinks

2008-12-19T03:20:19Z

Changed example to use an actual spell instead of itemlinks

WoWWiki>Ackis: Initial creation

2008-10-06T20:39:13Z

Initial creation

New page

{{DISPLAYTITLE:spellLink}}
{{wowapitype}}<br>

== spellLink API Type (String) ==

spellLinks are returned by several functions, e.g. [[API GetSpellInfo|GetSpellInfo]](), etc.

In essence, they are [[spellString]]s with additional formatting to make in-game text controls display them as clickable hyperlinks.

|cff9d9d9d|Hspell:7073:0:0:0:0:0:0:0|h[Broken Fang]|h|r

Broken up in its components:

* <tt>"'''|cff9d9d9d'''"</tt> – Colorizes the link with a medium grey color (Broken Fang is vendortrash)
** The first two characters after pipe-c may be the alpha level, where <code>ff</code> is fully opaque.
** The next three sets of two characters represent the red, green, and blue levels, just like HTML.
* <tt>"'''|H'''"</tt> – "Hyperlink link data starts here"
* <tt>"'''spell:7073:0:0:0:0:0:0:0'''"</tt> – Read more at [[spellString]].
* <tt>"'''|h'''"</tt> – "End of link, text follows"
* <tt>"'''[Broken Fang]'''"</tt> – The actual text displayed
* <tt>"'''|h'''"</tt> – "End of hyperlink"
* <tt>"'''|r'''"</tt> – Restores color to normal

You can extract the spellString from a given spellLink with the following pattern:

local found, _, spellString = string.find(spellLink, "^|c%x+|H(.+)|h%[.*%]")

Note: The format of the link is similar for enchant, spell and quest links, with merely the "spellstring" changing. See [[spellString]], [[itemString]], [[enchantString]] and [[questString]]

== Printing links for debug ==

Printing out the contents of an spell link is perhaps not so obvious; displaying it anywhere in-game will just show you a clickable link. Reformat it slightly to ruin the [[UI Escape Sequences|escape sequences]] and you'll see what it really looks like:

link = [[API GetSpellInfo|GetSpellInfo]]();
printable = [[API gsub|gsub]](link, "\124", "\124\124");
ChatFrame1:AddMessage("Here's what it really looks like: \"" .. printable .. "\"");

"124" is the ascii value of the "|" character. If you are writing this in a regular .lua file, feel free to go ahead and just use "|" and "||". However, if you're typing it in an in-game editor, it's better to use the ascii code escape to avoid problems.

← Older revision		Revision as of 03:20, 19 December 2008
Line 4:		Line 4:
	== spellLink API Type (String) ==		== spellLink API Type (String) ==

	spellLinks are returned by several functions, e.g. [[API ~~GetSpellInfo~~\|~~GetSpellInfo~~]](), etc.		spellLinks are returned by several functions, e.g. [[API GetSpellLink\|GetSpellLink]](), etc.

	In essence, they are [[spellString]]s with additional formatting to make in-game text controls display them as clickable hyperlinks.		In essence, they are [[spellString]]s with additional formatting to make in-game text controls display them as clickable hyperlinks.

	\|~~cff9d9d9d~~\|Hspell:~~7073:0:0:0:0:0:0:0~~\|h[~~Broken Fang~~]\|h\|r		\|cff71d5ff\|Hspell:10060\|h[Power Infusion]\|h\|r

	Broken up in its components:		Broken up in its components:

	* <tt>"'''\|~~cff9d9d9d~~'''"</tt> – Colorizes the link with a ~~medium grey~~ color (~~Broken Fang is vendortrash~~)		* <tt>"'''\|cff71d5ff'''"</tt> – Colorizes the link with a blue/cyan color (all spell links are blue)
	** The first two characters after pipe-c may be the alpha level, where <code>ff</code> is fully opaque.		** The first two characters after pipe-c may be the alpha level, where <code>ff</code> is fully opaque.
	** The next three sets of two characters represent the red, green, and blue levels, just like HTML.		** The next three sets of two characters represent the red, green, and blue levels, just like HTML.
	* <tt>"'''\|H'''"</tt> – "Hyperlink link data starts here"		* <tt>"'''\|H'''"</tt> – "Hyperlink link data starts here"
	* <tt>"'''spell:~~7073~~:0:0:0:0:0:0:0'''"</tt> – Read more at [[spellString]].		* <tt>"'''spell:10060:0:0:0:0:0:0:0'''"</tt> – Read more at [[spellString]].
	* <tt>"'''\|h'''"</tt> – "End of link, text follows"		* <tt>"'''\|h'''"</tt> – "End of link, text follows"
	* <tt>"'''[~~Broken Fang~~]'''"</tt> – The actual text displayed		* <tt>"'''[Power Infusion]'''"</tt> – The actual text displayed
	* <tt>"'''\|h'''"</tt> – "End of hyperlink"		* <tt>"'''\|h'''"</tt> – "End of hyperlink"
	* <tt>"'''\|r'''"</tt> – Restores color to normal		* <tt>"'''\|r'''"</tt> – Restores color to normal
Line 33:		Line 33:
	Printing out the contents of an spell link is perhaps not so obvious; displaying it anywhere in-game will just show you a clickable link. Reformat it slightly to ruin the [[UI Escape Sequences\|escape sequences]] and you'll see what it really looks like:		Printing out the contents of an spell link is perhaps not so obvious; displaying it anywhere in-game will just show you a clickable link. Reformat it slightly to ruin the [[UI Escape Sequences\|escape sequences]] and you'll see what it really looks like:

	link = [[API ~~GetSpellInfo~~\|~~GetSpellInfo~~]]();		link = [[API GetSpellLink\|GetSpellLink]](<i>spell</i>);
	printable = [[API gsub\|gsub]](link, "\124", "\124\124");		printable = [[API gsub\|gsub]](link, "\124", "\124\124");
	ChatFrame1:AddMessage("Here's what it really looks like: \"" .. printable .. "\"");		ChatFrame1:AddMessage("Here's what it really looks like: \"" .. printable .. "\"");

	"124" is the ascii value of the "\|" character. If you are writing this in a regular .lua file, feel free to go ahead and just use "\|" and "\|\|". However, if you're typing it in an in-game editor, it's better to use the ascii code escape to avoid problems.		"124" is the ascii value of the "\|" character. If you are writing this in a regular .lua file, feel free to go ahead and just use "\|" and "\|\|". However, if you're typing it in an in-game editor, it's better to use the ascii code escape to avoid problems.