Ausgabe von formatierten Texten
Neben dem Register Eigenschaften werden weitere Register für jeden Vorlagensatz des Projektes angezeigt.
Die Eingabemaske besteht für jeden Vorlagensatz aus einer Klappliste für die Auswahl einer Konvertierungsregel und einem Eingabebereich für die Vorlagendefinition.
Damit die formatierten Inhalte der DOM-Eingabekomponente im jeweiligen Vorlagensatz sichtbar sind, muss der Vorlagenentwickler die Ausgabe für jeden Vorlagensatz einer Formatvorlage im Bereich „Vorlagen“ definieren.
Zu Informationen zu den Icons in der Toolbar siehe Seite Aufbau von Vorlagen, Abschnitt „Übergreifende Funktionen“.
Systemobjekt #content
Für die Ausgabe von Inhalten aus einer DOM-Eingabekomponente kann der Vorlagenentwickler auf das Systemobjekt #content zugreifen. Der Inhalt der Eingabekomponente wird über das Systemobjekt #content geholt und über die Anweisung $CMS_VALUE(...)$ im Vorlagenbereich der Formatvorlage im entsprechenden Vorlagensatz ausgegeben.
Abhängig davon, um welche Art von Formatvorlage es sich handelt, kann der Inhalt sehr unterschiedlich sein. Für den HTML-Vorlagensatz kann es sich beispielsweise um redaktionelle Inhalte in Form von reinem Text handeln, oder um Text und HTML-Tags oder nur um HTML-Tags (Sonderfall: „LineBreak“).
 |
Die selektierte Konvertierungsregel wird nur bei der Ausgabe der Eingabekomponenten CMS_INPUT_DOM bzw. CMS_INPUT_DOMTABLE über das Systemobjekt #content angewendet, z. B. über $CMS_VALUE(#content)$. Nicht aber beim Aufruf von $CMS_RENDER(...)$. |
Beispiel: Absatzformat "Standard" (HTML-Vorlagensatz)
DOM-Editor
Der Redakteur gibt innerhalb des DOM-Editors einen Absatz ein, der als „Standard“-Absatz formatiert wird (Kürzel: „p“) (siehe Abbildung „DOM-Editor“). Für die Absatzformatvorlage „Standard“ ist im Vorlagenbereich des HTML-Vorlagensatz folgendes definiert:
<p>$CMS_VALUE(#content)$</p>
Über das #content-Objekt wird nun der Inhalt der Eingabekomponente ausgelesen und für die Absatz-Formatvorlage „Standard“ über ein <p>-Tag formatiert (als Standardeinstellung für diese Formatvorlage). Die HTML-Ausgabe sieht dann folgendermaßen aus:
Beispiel: Formatvorlage "LineBreak" (HTML-Vorlagensatz)
Neben dem Standard-Absatzformat gibt es auch Formatvorlagen, die keine redaktionellen Texte, sondern lediglich HTML-Tags ausgeben. So ein Sonderfall ist beispielsweise die Formatvorlage für den Zeilenumbruch „LineBreak“ (Kürzel: „br“). Diese Formatvorlage wird vom Redakteur nicht explizit ausgewählt, sondern immer dann verwendet, wenn innerhalb der DOM-Eingabekomponente die Tastenkombination Umschalt+Enter verwendet wird:
Für die Formatvorlage „LineBreak“ ist im Vorlagenbereich des HTML-Vorlagensatzes folgendes definiert:
<br>
Die HTML-Ausgabe sieht dann (bezogen auf das oben angegebene Beispiel) folgendermaßen aus:
Beispiel: verschachtelte Formatvorlage (HTML-Vorlagensatz)
Natürlich sind auch verschachtelte Auswertungen möglich. Gibt der Redakteur beispielsweise den folgenden Text ein:
Werden zuerst die innen liegenden Formatvorlagen „LineBreak“:
<br>
und „Bold“ ausgewertet:
<b>$CMS_VALUE(#content)$</b>
Danach die umschließende Absatz-Formatvorlage „Standard“:
<p>$CMS_VALUE(#content)$</p>
Das heißt, das #content-Objekt von „Standard“ greift auf den Inhalt des gesamten Absatzes zu, also auch auf den Inhalt des #content-Objekts von „Bold“ („Das ist ein Text.“) und das Tag <br> der Formatvorlage „LineBreak“.
Die HTML-Ausgabe sieht dann (bezogen auf das oben angegebene Beispiel) folgendermaßen aus:
Beispiel: Listen und Tabellen (HTML-Vorlagensatz)
Listen und Tabellen, die mithilfe von CMS_INPUT_DOM erzeugt werden, können in der Ausgabe von Tags umschlossen werden, die aus einer Formatvorlage stammen.
Ist dies nicht erwünscht, kann die Methode .normalize verwendet werden, um die umgebenden Tags zu unterdrücken.