Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- de:create:functions:gettextelement [30.08.2020 13:45] – [getTextElement()] admin
+++ de:create:functions:gettextelement [27.03.2026 09:33] (aktuell) – [getTextElement()] admin
@@ Zeile 1: / Zeile 1: @@
 ====== getTextElement() ======
+Die Funktion ''getTextElement()'' liefert den Inhalt eines Textes (Textbaustein oder Text im Fragenkatalog) als String.
+Der optionale zweite Parameter kann entweder (nur) das Ausgabeformat festlegen oder zusätzliche Einstellungen und Platzhalter vorgeben.
 ''string **getTextElement**(string //TextKennung//, [string //Ausgabeformat//])''
-Gibt den HTML-Code für den Textbaustein mit der Kennung //TextKennung// als String zurück.
+''string **getTextElement**(string //TextKennung//, array //Einstellungen//)''
   * //TextKennung//\\ Kennung des Textbausteins, dessen Inhalt zurückgegeben werden soll.
-  * //Ausgabeformat//\\ Optional können Sie ausgeben, in welchem Format der Inhalt zurückgegeben wird.
+  * //Ausgabeformat//
-    * ''%%'block'%%'' -> (Standard) HTML-Code im Blockelement (mit Abständen und Ausrichtung)
+    * Optional können Sie ausgeben, in welchem Format der Inhalt zurückgegeben wird.
-    * ''%%'html'%%'' -> Nur der eigentliche Inhalt als HTML-Code
+      * ''%%'block'%%'' -> (Standard) HTML-Code im Blockelement (mit Abständen und Ausrichtung)
-    * ''%%'plain'%%'' -> Unformatierter Text mit Zeilenumbrüchen
+      * ''%%'html'%%'' -> Nur der eigentliche Inhalt als HTML-Code
+      * ''%%'plain'%%'' -> Unformatierter Text mit Zeilenumbrüchen
+    * Oder Sie können einen spezifischen Inhalt des Textelements (als unformatierten Plain-Text) abrufen
+      * ''%%'header'%%'' -- Überschrift
+      * ''%%'content'%%'' -- Inhalt ohne Überschrift
+      * ''%%'title'%%'' -- Titel bzw. Fragetext in der Darstellung "wie eine Frage"
+      * ''%%'explanation'%%'' -- Erklärungen/Anweisungen
+  * //Einstellungen//\\ Optional können Einstellungen und Platzhalter definiert werden
+    * ''%%'format'%%'' -> Ausgabeformat wie oben
+    * ''%%'%key%'%%'' -> Platzhalter, welche im Textbaustein vor der Ausgabe ersetzt werden
 **Hinweis:** Falls der Textbaustein mit Titel und/oder Formatierung im Fragebogen ausgegeben wird, so ist auch dies im HTML-Code enthalten. Nicht enthalten sind allerdings eine eventuelle Ausrichtung (links/mittig/rechts/Blocksatz) sowie Abstand unter dem Textbaustein.
@@ Zeile 37: / Zeile 50: @@
 $out = str_replace(array('a','A'), '_', $content);
 html($out);
+</code>
+===== Beispiel 3 =====
+Hier wurde ein Text ''TX01'' mit der Dartellung "HTML-Code" definiert, welcher mehrere Platzhalte beinhaltet:
+<code html>
+<div id="teaser%num%" style="border: 1px solid #AAAAAA; border-radius: 0.5em; padding: 1em; display: flex; flex-direction: row-reverse; gap: 2em; background-color: white; flex-wrap: wrap;">
+    <div style="flex: 1 1 30%; text-align: center;">
+        <img src="%image%" alt="" style="width: 100%; max-width: 200px;">
+    </div>
+    <div style="flex: 1 1 250px;">
+        <div style="display: flex; gap: 0.6em; margin-bottom: 0.6em; align-items: center;">
+            <img src="%source.logo%" style="width: 22px">
+            <span>%source.name%</span>
+        </div>
+        <div style="font-weight: bold; font-size: 125%;">
+            %headline%
+        </div>
+    </div>
+</div>
+</code>
+Dieser Textbaustein wird im Fragebogen mehrfach verwendet, und die Platzhalter werden jeweils unterschiedlich gefüllt, z.B.
+<code php>
+$html = '<div style="max-width: 600px; margin: 0 auto; display: flex; flex-direction: column; gap: 0.7em; padding: 1em;">';
+$html.= getTextElement('TX01', [
+    '%num%' => 1,
+    '%image%' => 'image01.jpg',
+    '%source.logo%' => 'source07.png',
+    '%source.name%' => '24/4 News',
+    '%headline%' => 'Vertreter der ABC zu Gast in Helsinki, schwierige Gespräche erwartet.'
+    'format' => 'html'
+]);
+$html.= '</div>';
+html($html);
 </code>