If you would like to upgrade to a newer long-term support version of Studio Pro, see Moving from Mendix Studio Pro 8 to 9.
Text
Introduction
The text widget displays a text which can contain parameters if necessary. Every attribute is replaced with the value of this attribute. For example, you can show a greeting message to a user by placing a text widget in a data view and adding parameters to it.
If you start typing in any empty container, Studio Pro will automatically generate a text widget to display your text.
Properties
An example of text properties is represented in the image below:
Text properties consist of the following sections:
Common Section
Design Properties Section
General Section
Caption
Caption defines a text that will be shown. The caption can contain parameters that are written between braces, for example, {1}.
For more information on using parameters, see the Parameters section below.
Parameters
Parameters are attributes the value of which will be displayed. To view Parameters, do one of the following:
-
Double-click the Caption setting in properties
-
Double-click the text widget on the page and click Edit in the General section > Caption:
Parameters have the following settings:
-
Index – an identification number of a parameter
-
Attribute (path) – an attribute a value of which will be displayed
-
Format – a format in which an attribute value will be displayed
Adding New Parameters
To use parameters, do the following:
-
Place the Text widget in a context of an entity, as in, inside a data widget.
-
Double-click the Caption setting in the text widget properties.
-
In the Edit Caption dialog box > Parameters section click New:
-
In the Edit Template Parameter dialog box, click Select, choose an attribute and confirm your choice.
-
In the Caption setting, write the text you would like to display and type Index of the parameter you would like to include. In the example below, to include a full name of your customer and a number of unread messages, you need to use indexes {1} for the FullName attribute, and {2} for the NrOfUnread attribute:
Performing Other Actions on Parameters
In addition to adding new parameters, you can perform the following actions on parameters:
-
Delete – to delete a parameter click Delete or press Delete on your keyboard
-
Edit – double-click a parameter to edit it or click Edit
-
Move up – to move a parameter up in the list of parameters and also to change its index, click Move up
-
Move down – to move a parameter down in the list of parameters and also to change its index, click Move down
Render Mode
The render mode determines how the text will be displayed.
Value | Description |
---|---|
Text (default) | The text will be rendered inline with the previous/next texts on a page (<span> tag in HTML). |
Paragraph | The text will be rendered as a separate paragraph (<p> tag in HTML). |
Heading 1 - Heading 6 | The text will be rendered as a selected heading (for example, <h1> tag in HTML). Heading 1 is the largest type of heading, Heading 6 is the smallest one. |
Visibility Section
Visibility determines whether a widget is displayed to the end-user as part of the page.
For more information on properties of this section, see the Visibility Section section in Properties Common in the Page Editor.