====== 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//])''

''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 =====

Im folgenden Beispiel wird einer von 2 Textbausteinen ("desc1" oder "desc2") per Platzhalter in einen dritten Platzhalter ("description") eingebunden. Der dritte Textbaustein muss dabei den Platzhalter ''%desc%'' enthalten.

<code php>
if (value('AB01_01') == 1) {
  $desc = getTextElement('desc1', 'html');
} else {
  $desc = getTextElement('desc2', 'html');
}
replace('%desc%', $desc);
text('description');
</code>


===== Beispiel 2 =====

Im folgenden Beispiel wird jedes "a" und jedes "A" durch einen Unterstrich ersetzt und der Textbaustein anschließend angezeigt.

<code php>
$content = getTextElement('priming');
$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>