Creating and attaching a Content artifact

Creating an artifact Content

New Content (TextContent) we create in the content editor (more in Content editor).

1

Creating an artifact

Go to module Library, and then to the tab Content. Click the button Add content. In the dialog that appears, set the name and location of the artifact. Clicking the Add content button will open the content editor.

2

Content editor - window structure

The editor window is divided into parts:

• In the main part of the window we add the content and any HTML styles.

• Below is a preview of the content being created (indicative).

• On the left you can add additional languages for the content.

Illustration 1. Content editor - creating content

Adding a new language

Each Content (TextContent) may consist of versions in different languages. At least one is required. To add another language version, click the Add translation button in the lower left corner of the editor. A new panel indicating the language version will appear on the left. In the TRANSLATION NAME field enter the language code (according to ISO 639), and on the right in the top panel enter the content.

Illustration 2. Adding a new language in content translations

HTML formatting and Wiki Markup

The artifact's content can be written using one of two languages:

• HTML (scripts in content are not supported by the platform),

• Wiki Markup (see: Confluence Wiki Markup and page with example formatting). Note: tables are supported only in the simplest form (a plain table with a header at the top).

The default formatting method is HTML. To set Wiki Markup, in the XML source (where the Content is attached) add for the TextContent a configuration in OutputFields: localName="markupType" serviceName="markupType".

Preview of the created Content

After entering text in the upper part of the window, the lower panel will show its indicative appearance (the preview is for guidance — it is not an accurate representation of the artifact on the application).

Auto-formatting:

• "Orphans" and single-letter words (e.g. "i", "w", "z") will be automatically moved to a new line.

• Large numbers will not be broken into a new line (e.g. "1 000 000 000").

This means there is no need to use non-breaking spaces — the text dynamically adjusts to the window size.

Using the artifact in components

The created Content (TextContent) is most often used in the following components on the application:

• Formatted content - TextContent

• Formatted (collapsible) content - RollableTextContent

• Statements - Statements and Declarations on a layer - StatementPopup

• Radio group - RadioGroup

Attaching the artifact in the Formatted Content component

The way the artifact is attached depends on the component in which you want to use the Content. An example of usage in the most commonly used component — Formatted content — is described in: Attaching and editing Content from the application level.

Additional resources:

• WCAG best practices for low-code dev — HTML-Contents (TextContents) and custom components (CustomComponents)