A Text is a key-value pair, where the key is a unique id called a Text Reference, and the value is a map of a language to translated string. Every Text can be translated into any number of languages.
All Texts share some common characteristics, they:
- Are multi-lingual.
- Can be used anywhere in a Form, for example, in Controls.
- Can contain HTML markup, for example
<b>HTML</b>
.
- Can contain && Field substitutions, where the current value of a Field is substituted in when displayed to an end-user, for example,
&&myField
.
There are three types of texts:
- Local Texts created within a Form, for example, by adding a Text or Button Control.
- Linked Texts Text
entities can be created containing any number of translated text entries and shared across Forms.
- System Texts default texts, used for things like standard error and information messages.
Texts can be dynamically changed at runtime in a server-side event script, for example:
controls.myText.text.setText("Some text");