VARIABLE

This element ca be used to define custom values to be reused later in the attributes of other elements, in order to avoid repeating several times the same value. It makes it easier to change the value once rather than everywhere in the code.

Note: to avoid conflicts with Predefined Variables, variables starting and ending with '_' are reserved to the KUIML engine.

Attributes brief detailed show all inherited

	Name	Description	Default
	id	id of the variableThis is the name you will use everywhere in the skin and it will be replaced by the value attribute	empty
	value	value of the variableThis is the value that will replace the '$id$' string everywhere in the skin	empty
	formula	The formula can reference other static variables that have been defined previously. The result of the formula is stored in the variable at the declaration of the variable and is not updated later, even if other variables it depends on are changedThis attributes overrides the "value" attribute when set	empty
	script	Script that returns a string that defines the new value of the variable. It can use functions that have been defined in the build_time_script_include file (but not other runtime function defined in runtime scripts). It can also refer to build time variables that have been defined beforeThis attributes overrides the "value" and "formula" attribute when set. It is currently experimental.	empty
	override	override previously defined valueSetting this to true removes the warning that is normally thrown when a variable is defined twice	false

	Name	Value type	Default	Description	Comment
	id	element id	empty	id of the variable	This is the name you will use everywhere in the skin and it will be replaced by the value attribute
	value	string	empty	value of the variable	This is the value that will replace the '$id$' string everywhere in the skin
	formula	Math Formula	empty	The formula can reference other static variables that have been defined previously. The result of the formula is stored in the variable at the declaration of the variable and is not updated later, even if other variables it depends on are changed	This attributes overrides the "value" attribute when set
	script	script returning a string	empty	Script that returns a string that defines the new value of the variable. It can use functions that have been defined in the build_time_script_include file (but not other runtime function defined in runtime scripts). It can also refer to build time variables that have been defined before	This attributes overrides the "value" and "formula" attribute when set. It is currently experimental.
	override	boolean	false	override previously defined value	Setting this to true removes the warning that is normally thrown when a variable is defined twice

Syntax

First declare a variable as shown here:

Once this variable has been declared, writing the following

is equivalent to writing:

The same example, with script syntax (note that all special characters in script have to be escaped):

Advanced usage

The possibility to "override" variables is useful in complicated layouts and templates. If you plan to use overriden variables often, then you can add defines like this to shorten the code (already defined in LM Skin):

Now you can write something like this:

The output should look like this:

You could use "LV" (LOCAL_VARIABLEs) instead, if you don't need these values later (for example a temporary variable inside a TEMPLATE).

Build-time scripts

If you need to do some complicated operations while build-time (usually related to strings) you can use scripts inside VARIABLES, like this:

Check if VARIABLE contains a substring:

However, if you use too many scripts, you may slow down skin loading time a bit. Also keep in mind, that scripts inside VARIABLEs are executed twice while build-time (for technical reasons), and that can be important if you're manipulating with something like file contents.