Rich Text

A Rich Text report item displays static or dynamic mixed-format text in a report. You can use it to create mail-merge reports, labels or display the pre-formatted content from a data source.

Adding a Rich Text

You can add a Rich Text into a report by either double-click the corresponding item in the toolbox or drag-and-drop it to a report page area or other container, such as a Banded List Section.

General Rich Text Configuration

The general configuration includes Base Report Item properties, Common Style Properties, subset of Text Properties and Visibility

Content

The Markup Type property sets the language of mixed-format content. Currently, the only supported language is HTML. You can use the following HTML tags in the Value property.

• <p> - a paragraph

• <span> - a generic inline container

• <h1> - <h6> - a section heading

• <ul> - an unordered list

• <ol> - an ordered list

• <li> - an item of the ordered or unordered list

• <a> - a hyperlink with the href attribute

• <strong> or <b> - a bold text

• <em> or <i> - an italic text

• <sup> - a superscript text

• <sub> - a subscript text

• <img> - an image

The following CSS styles are supported for those above tags.

• font-family - overrides the Font Family property of the rich text report item

• font-size - overrides the Font Size property of the rich text report item

• font-style - overrides the Font Style property of the rich text report item

• font-weight - overrides the Font Weight property of the rich text report item

• color - overrides the Color property of the rich text report item

• background-color - overrides the Background Color property of the rich text report item

• background-image - overrides the Background Image property of the rich text report item

• text-align - works for the supported block-level elements only

• text-indent - works for the supported block-level elements only

• text-decoration - the underline and line-through values are supported.

• list-style-type - works for <ul> and <ol> elements only

• width and height - works for <img> elements only

The img element supports the src attribute that you can set to the URL of an external image. If you want to display an embedded image or image data from a data set, then you can use the following data-* attributes for the img tag:

• data-source attribute accepts the Embedded and Database values.

• data-value attribute accepts the name of an embedded image or a data set field containing image data.

• data-mime-type attribute accepts the mime type of an image. Supported types are image/jpeg, image/png and image/svg+xml.

The Value expression sets the mixed-format content using those above tags and styles. Using the interpolation syntax you can set the dynamic content for a rich text, for example:

<p>Thank you for your purchase {name}!</p>
<p>Your order number is: #{orderID}</p>
<p>If you require any changes to your order or delivery address you must <a href="https://tradecompany/changeorder/{orderID}">contact us</a>
<span style="color:red;font-weight:bold">as soon as possible</span> and it might not be possible if your order has already gone through to fulfilment.</p>

At runtime, a rich text with this Value property generates the following output.

If the Value property is the bound field reference and a field's value is the HTML content, then the supported tags and styles will be recognized and rendered accordingly.

Layout

• The Keep together flag ensures that a rich text always appears on a single page if it fits.

• The Can Grow flag indicates whether a rich text can increase its height to accommodate growing content.