Provide the user with a familiar interface for adding and editing text. By using
standard word processing tools, such as fonts and formats, the Rich text editor control helps application users style their text, which
improves presentation and usability.
Before you begin: Add a
Rich text editor control to
the layout.
For more information, see Adding controls.
Note: Because the control relies on HTML for formatting, it interprets all text between the
less than (<) and greater than (>) symbols as an HTML tag, and excludes it at run time.
For example, if you configure the
Rich text editor to source
text from a property, and that text includes a string such as
<[email protected]>, the editor does not display the string. To
include all characters in the text, add a leading space after the less than symbol, or use
a
Text area control.
-
Open the view with the control that you want to
edit.
-
In the configuration pane on the right side of the
window, hover over the control, and then click the Edit
icon.
-
On the General tab, in the Property
field, define the property that you want to associate with the control:
- To select an existing property, in the Property field,
press the Down arrow key, and then click the property.
- To create a new property, click the Open icon next to the
Property field, and then configure a new property record. For
more information, see Properties.
-
In the Default value field, define the text that appears in the
control automatically:
- To use a fixed value, enter the text manually.
- To tie the default value to an expression, click Open expression
builder, and then define the expression that you want to use. For more
information, see Expressions — Examples.
-
In the Toolbar Options section, select the formatting tools that
you want to include in the toolbar.
You can configure the toolbar to include additional elements, such as tables, formats,
and indentation. The control also supports images. Depending on the format in which you
want to store images, you can drag an image into the control to convert it to a secure
base64 binary file, or use the Image uploader tool to save the file as a data-content
image.
-
On the Presentation tab, in the Specify
width field, define the size of the control:
- To use view settings to define the size of the control, in the Specify
width and Specify height fields, click
Auto.
- To define a specific width, in the Specify width field,
click Custom, and then define the size of the control in pixels
or as a percent ratio.
- To define a specific height, in the Specify height field,
click Custom, and then define the size of the control in
pixels.
- To make the control size dependent on the amount of text that the user enters, in
the Specify height field, click Size to
content.
-
In the RTE Type field, define whether you want to use the full
or limited version of the control.
The lightweight mode does not support all features, and works best with static
content.
-
Click Apply.