Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- de:create:functions:gettextelement [01.12.2014 11:34] – angelegt msd-media
+++ de:create:functions:gettextelement [27.02.2026 08:46] (aktuell) – admin
@@ Zeile 1: / Zeile 1: @@
 ====== getTextElement() ======
-''string **getTextElement**(string //TextKennung//)''
+Die Funktion ''getTextElement()'' liefert den Inhalt eines Textes (Textbaustein oder Text im Fragenkatalog) als String.
-Gibt den HTML-Code für den Textbausteins mit der Kennung //TextKennung// als String zurück.
+Der optionale zweite Parameter kann entweder (nur) das Ausgabeformat festlegen oder zusätzliche Einstellungen und Platzhalter vorgeben.
+''string **getTextElement**(string //TextKennung//, [string //Ausgabeformat//])''
+''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.
+    * ''%%'block'%%'' -> (Standard) HTML-Code im Blockelement (mit Abständen und Ausrichtung)
+    * ''%%'html'%%'' -> Nur der eigentliche Inhalt als HTML-Code
+    * ''%%'plain'%%'' -> Unformatierter Text mit Zeilenumbrüchen
+  * //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.
 ===== Beispiel 1 =====
@@ Zeile 15: / Zeile 27: @@
 <code php>
 if (value('AB01_01') == 1) {
-  $desc = getTextElement('desc1');
+  $desc = getTextElement('desc1', 'html');
 } else {
-  $desc = getTextElement('desc2');
+  $desc = getTextElement('desc2', 'html');
 }
 replace('%desc%', $desc);
 text('description');
 </code>
 ===== Beispiel 2 =====
@@ Zeile 31: / Zeile 44: @@
 $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>