Label Formatting: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
>Jmarshall
No edit summary
(Add tabs keyword)
 
(18 intermediate revisions by 13 users not shown)
Line 1: Line 1:
XBMC has a sophisticated label formatting engine, allowing the skinner to format up a particular label using bold, italics, full caps, lower case, and coloured text.
Kodi has a sophisticated label formatting engine, allowing the skinner to format up a particular label using bold, italics, full caps, lower case, and coloured text.


This works on all labels throughout the interface. The syntax is similar to the "phpBB" syntax seen on some bulletin board software.
This works on all labels throughout the interface. The syntax is similar to the "phpBB" syntax seen on some bulletin board software.
Line 5: Line 5:
[[Label Parsing|The $INFO and $LOCALIZE syntaxes are explained in more detail here.]]
[[Label Parsing|The $INFO and $LOCALIZE syntaxes are explained in more detail here.]]


===Examples===
=== Examples ===


This is a long label that features different [COLOR red]colours[/COLOR] and [I]styles[/I].
This is a long label that features different [COLOR red]colours[/COLOR] and [I]styles[/I].
Line 11: Line 11:
[LOWERCASE]$LOCALIZE[12345][/LOWERCASE] can be used to force a localize string to lowercase.
[LOWERCASE]$LOCALIZE[12345][/LOWERCASE] can be used to force a localize string to lowercase.


===Keywords===
=== Keywords ===


The following keywords are used.
The following keywords are used.


* $INFO[ListItem.Title,prefix,postfix] - for specifying an [[InfoLabels|info label]].
* $INFO[ListItem.Title,prefix,postfix] - for specifying an [[InfoLabels|info label]].
* $VAR[MyVariable,prefix,postfix] - for specifying a variable.
* $LOCALIZE[12345] - for specifying a localized string.
* $LOCALIZE[12345] - for specifying a localized string.
* $ADDON[script.music.foobar 12345] - for specifying a string provided by an addon.
* $NUMBER[] - for specifying a numerical value.
* [B]bold[/B] - bold text.
* [B]bold[/B] - bold text.
* [I]italics[/I] - italic text.
* [I]italics[/I] - italic text.
* [LIGHT]lighten[/LIGHT] - light weight text. {{note|Available from Kodi v16}}
* [COLOR red]red text[/COLOR] - colored text.
* [COLOR red]red text[/COLOR] - colored text.
* [UPPERCASE]force text uppercase[/UPPERCASE] - force text to uppercase
* [UPPERCASE]uppercase text[/UPPERCASE] - all text is made uppercase e.g. UPPERCASE TEXT
* [LOWERCASE]Force Text Lowercase[/LOWERCASE] - force text to lowercase
* [LOWERCASE]lowercase text[/LOWERCASE] - all text is made lowercase e.g. lowercase text
* [CAPITALIZE]capitalized text[/CAPITALIZE] - first letter of every word is capitalized (Isengard onward) e.g. Capitalized Text
* [CR] - carriage return (line break).
* [CR] - carriage return (line break).
* [TABS]n[/TABS] - add tabulator spaces, replace "n" with the appropriate amount of tabs to add. {{note|Available from Kodi v20}}


[[category:Skin Development]]
== See also ==
'''Development:'''
* [[Add-on development]]
* [[Skinning]]
 
[[Category:Skin development]]

Latest revision as of 11:12, 11 October 2022

Kodi has a sophisticated label formatting engine, allowing the skinner to format up a particular label using bold, italics, full caps, lower case, and coloured text.

This works on all labels throughout the interface. The syntax is similar to the "phpBB" syntax seen on some bulletin board software.

The $INFO and $LOCALIZE syntaxes are explained in more detail here.

Examples

This is a long label that features different [COLOR red]colours[/COLOR] and [I]styles[/I].

[LOWERCASE]$LOCALIZE[12345][/LOWERCASE] can be used to force a localize string to lowercase.

Keywords

The following keywords are used.

  • $INFO[ListItem.Title,prefix,postfix] - for specifying an info label.
  • $VAR[MyVariable,prefix,postfix] - for specifying a variable.
  • $LOCALIZE[12345] - for specifying a localized string.
  • $ADDON[script.music.foobar 12345] - for specifying a string provided by an addon.
  • $NUMBER[] - for specifying a numerical value.
  • [B]bold[/B] - bold text.
  • [I]italics[/I] - italic text.
  • [LIGHT]lighten[/LIGHT] - light weight text. Note: Available from Kodi v16
  • [COLOR red]red text[/COLOR] - colored text.
  • [UPPERCASE]uppercase text[/UPPERCASE] - all text is made uppercase e.g. UPPERCASE TEXT
  • [LOWERCASE]lowercase text[/LOWERCASE] - all text is made lowercase e.g. lowercase text
  • [CAPITALIZE]capitalized text[/CAPITALIZE] - first letter of every word is capitalized (Isengard onward) e.g. Capitalized Text
  • [CR] - carriage return (line break).
  • [TABS]n[/TABS] - add tabulator spaces, replace "n" with the appropriate amount of tabs to add. Note: Available from Kodi v20

See also

Development: