Geckos Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Advanced String Variables ======

To get the value of a text field on the card, we can use the simple [[Text Variables|Text Variable]]. But sometimes, a more //complex// value is needed. For example, concatenating two strings.

Some fields also propose different types of values, such as the [[Choice_Input|Dropdown Menu]], who has a selected value, and a selected text. Which one to display ?

The **Advanced String Variables** exist for these situations.

===== Classic Use =====

An **Advanced String Variable** can be used by setting a canvas' field to a string that contains the token ''$myVariable$''. Unlike normal text variables, this variable can be set anywhere in the string : 

<code javascript>
"text": "My Name is $name$"
</code>

You can even have multiple variables in the same string : 

<code javascript>
"text" : "My Name is $name$ and I'm $age$ years old"
</code>

And that's it !

The following editable fields generate an **advanced string variable** : 

* [[Text Input|Input Text]] (get the text set in the field)
* [[Multiline Text Input|Multiline Text]] (get the text set in the field)
* [[Choice Input|Dropdown Menu]] (get the text displayed for the selected item)
* [[Rich Text Field|Rich Text Field]] (get the displayed text, without the formatting)

===== Special values =====

Some fields have special values accessible from the **advanced string variables**. If nothing is specified, then only the classic use will work.

A special value is used in the same way as a normal **advanced string variable**, but requires the use of an attribute : 

<code javascript>
"text" : "My Name is $name$ and I'm $age.value$ years old"
</code>

As you can see, we have added the ''value'' attribute to the ''age'' variable by using a dot between the variable & the attribute. The existing attributes are listed below.

==== Dropdown Menu ====

Dropdown Menus have 4 special values : 

  * ''text'' is the text displayed in the field, that the user selected
  * ''value'' is the value of the selected option, that can be more of a constant, with less information.
  * ''image'' is the url / data-url of the ''image'' property of the selected option, or of the ''miniature'' property if there is no ''image'', or an empty string if there is no ''image'' and no ''miniature''.
  * ''miniature'' is the url / data-url of the ''miniature'' property of the selected option, or of the ''image'' property if there is no ''miniature'', or an empty string if there is no ''miniature'' and no ''image''.

==== Rich Text Field ====

Rich Text Fields have two special values :

  * ''text'' is the text entered in the field, without the formatting (bold, italic). 
  * ''html'' is the html version of the text (with tags ''<strong>'' for bold, ''<em>'' for italic, ''<br/>'' for linebreaks, ...

==== Color Picker Field ====

Color Picker Fields have several special values. See the [[Color_Picker#special_values|main page]] of this type of field.
Geckos Documentation

User Tools

Site Tools

Page Tools
