Zum Hauptinhalt springen
Version: 4.0 (2026 H1)

FormattedText

FormattedText ist ein Datencontainer, welcher Text mit Formatierungsoptionen (u.A. Fett, Kursiv, Unterstrichen, Umbrüche oder auch Word-spezifische Formatierungen) enthalten kann.

Dabei handelt es sich bei FormattedText, egal in welchem Kontext, technisch um HTML:

<p>Erstellt mit: <b>primedocs</b>!</p>

Erstellt mit: primedocs!

FormattedText bietet sich an, um einfache Formatierungsoptionen abzubilden, welche sowohl in Word-, PowerPoint- oder Outlook-Vorlagen genutzt werden können.

In FormattedText können auch produktspezifische Formatierungsoptionen hinterlegt werden, sodass z. B. ein Absatz in Word mit einem Style ausgestattet sein kann.

Syntax​

FormattedText tritt in primedocs auf als...

  • Field-Typ, also kann als Code generiert werden, wobei FormattedText als Snippet oder globale Übersetzung geholt werden kann.
  • Typ einer globalen Übersetzung
  • Snippet-Typ.

HTML-Elemente​

Die folgenden Listen zeigen alle möglichen HTML-Elemente und deren Attribute, die in den Vorlagen verwendet werden können.

Word-Vorlagentypen

Elemente:

<p>Paragraph</p>
<span>Span</span>
<sup>hochgestellt</sup>
<sub>tiefgestellt</sub>
<u>unterstrichen</u>
<i>kursiv</i>
<em>kursiv</em>
<b>fett</b>
<strong>fett</strong>
<br />
<custom-tab />

Attribute auf span und p:

"data-office-font"
"data-office-font-size"
"data-office-color-hex"
"data-office-color-theme-name"
"data-word-style-id"
"data-word-space-after"
"data-word-space-before"
"data-word-indentation"
"data-word-alignment" (Center, Right, Left)

Attribut auf br:

"data-word-break-type" (Page)

PowerPoint-Vorlagentypen

Elemente:

<p>Paragraph</p>
<span>Span</span>
<sup>hochgestellt</sup>
<sub>tiefgestellt</sub>
<ul><li>Liste</li></ul>
<ol><li>Liste</li></ol>
<u>unterstrichen</u>
<i>kursiv</i>
<em>kursiv</em>
<b>fett</b>
<strong>fett</strong>
<br />

Attribute auf span und p:

"data-office-font"
"data-office-font-size"
"data-office-color-hex"
"data-office-color-theme-name"
"data-powerpoint-alignment" (Center, Right, Left)

Dynamische Attribute​

Einige native HTML-Attribute können mit Werten aus Fields befüllt werden.

Beispiel:

<a href="{{url}}">Link</a>

Unterstützte Attribute:

alt
aria-label
class
href
id
name
src
title
value
hinweis

Alle hier nicht aufgeführten Attribute können nicht dynamisch gesetzt werden — dies betrifft insbesondere sämtliche data--Attribute. Diese Einschränkung dient der Sicherstellung der Validierbarkeit der Vorlagen.

Outlook (new) — Vorlagentypen​

Gemeint ist der webfähige Outlook-Client (Outlook (new)). Dieser nutzt HTML als «Beschreibung» für E-Mails und Signaturen, daher können FormattedText-Daten hier direkt genutzt werden. Zusätzlich können alle von Outlook erlaubten HTML-Elemente und -Attribute verwendet werden.

hinweis

Outlook (new) ignoriert gewisse CSS-Eigenschaften wie white-space: pre-wrap, wodurch Zeilenumbrüche und Leerzeichen nicht wie in Standard-Browsern dargestellt werden. Um das gewünschte Layout zu erreichen, ist das Einfügen von <br>-Elementen notwendig.

FormattedText als Field​

Soll ein FormattedText in eine (oder mehrere) Vorlage(n) eingebunden werden, kann dies in einem Field vom Typ FormattedText definiert werden.

Verhalten von Paragraphen — abhängig vom Vorkommen von Paragraphen (<p>):

  • Ist mindestens eines der Elemente ein Paragraph, werden alle nicht-Paragraph-Elemente jeweils in einen separaten Paragraphen gesetzt.
  • Ist keines der Elemente ein Paragraph, werden alle Elemente ohne zusätzliche Absatzumbrüche direkt aneinandergereiht.

Dieses Verhalten ist beabsichtigt und gilt für sämtlichen FormattedText, unabhängig von dessen Herkunft oder Verwendung.

Eine globale Übersetzung vom Typ FormattedText kann in Fields über die translations-API ausgegeben werden:

$.translations.getFormattedText("FormattedTexts.EnclosuresTitle")

Bestehende Snippets vom Typ FormattedText können auch über die snippets-API abgerufen werden:

$.snippets.getFormattedText("FormattedTexts.SimpleSnippet")

FormattedText als globale Übersetzung​

Ein FormattedText kann als globale Übersetzung in den Globalen Übersetzungen abgespeichert werden. Der Vorteil ist, dass kein Snippet erstellt werden muss, sondern der Text direkt in seinem technischen Format HTML erstellt werden kann.

FormattedText als Snippet​

Ein FormattedText kann auch als Snippet vom Typ FormattedText unter den Vorlagen-Snippets abgespeichert werden. Snippets dieses Typs werden jedoch nur für die Vorlagenkonstruktion bzw. das Templating verwendet und werden daher nicht von Endbenutzern genutzt.

FormattedText-Snippets können keine Tabellen, Bilder oder andere komplexe Inhalte speichern. Dafür eignen sich jedoch Snippets vom Typ WordContent.

tipp

FormattedText-Snippets sind weniger flexibel als globale Übersetzungen oder die Definition in den Fields, aber es gibt einen automatischen Konverter: Wenn Sie einen Text in Word erstellen, können Sie das Snippet über die Snippet-Seitenleiste als FormattedText speichern.

Platzhalter, Schleifen und Bedingungen​

Benannte Parameter können verwendet werden, um Platzhalter in globalen Übersetzungen zu erstellen, die später Absätze oder Schleifen mit dynamischen Daten über die Fields befüllen.

Dabei nutzt primedocs die HTML-Template-Engine "Handlebars.js". Die Dokumentation finden Sie hier: Expressions | Handlebars.