[[text()]]
 

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

de:create:functions:text [01.12.2014 11:49] (aktuell)
msd-media Aus functions-base ausgelagert und aktualisiert
Zeile 1: Zeile 1:
 +====== text() ======
  
 +''void **text**(string //TextKennung//, [string //Optionen//])''
 +
 +Zeigt einen Textbaustein im Fragebogen an. Textbausteine werden unter **Textbausteine u. Beschriftung** angelegt. In aller Regel ist die Verwendung von Textbausteinen sinnvoller, als Inhalte direkt via ''[[:de:create:functions:html|html()]]'' in den Fragebogen einzubinden. Die Funktion ''text()'' kommt vor allem bei [[:de:create:filters|Filtern und Filterfragen]] zum Einsatz.
 +
 +  * //TextKennung//\\ Kennung des Textbausteins
 +  * //Optionen//\\ Optional können Darstellungs-Optionen angegeben werden. Die Optionen müssen in Anführungszeichen (einfach oder doppelt) stehen (s. Beispiel). Mehrere Optionen werden als unterschiedliche Parameter durch Kommata getrennt.
 +    * ''spacing=<n>''\\ Fügt unter dem Textbaustein zusätzlichen Abstand (<n> Pixel) zur nachfolgenden Frage ein.
 +    * ''spacing=default''\\ Fügt unter dem Textbaustein genauso viel Abstand ein, wie unter einer Frage (der Standard-Abstand wird im Layout festgelegt).
 +    * ''align=<left|center|right|justify>''\\ Richtet den Inhalt linksbündig, mittig, rechtsbündig oder im Blocksatz aus. Beachten Sie, dass Blocksatz mangels Silbentrennung i.d.R. kein schönes Schriftbild erzeugt (in HTML-Inhalten kann die Verwendung von ''&shy;'' zum Setzen optionale Trennung an geeigneten Stellen für Abhilfe sorgen).
 +
 +
 +===== Hinweise =====
 +
 +**Wichtig:** Die Verwendung der Funktion ''text()'' ist äquivalent zum Hineinziehen (Drag & Drop) eines Textbausteins in den Fragebogen. Falls Sie einen Textbaustein via ''text()'' anzeigen, stellen Sie sicher, dass er nicht zusätzlich durch Hineinziehen auf der Seite platziert wurde -- sonst wird er doppelt angezeigt.
 +
 +**Hinweis:** Jeder andere Versuch (z.B. mit dem PHP-Befehl ''echo'') direkt Text auszugeben, würde nicht in den Fragebogen, sondern an den Anfang des Dokuments. Daher können die Befehle ''echo'' oder ''print'' im PHP-Code nicht verwendet werden.
 +
 +**Tipp:** In den Texten können Sie auch dynamische [[:de:create:placeholders|Platzhalter]] verwenden, z.B. um einzelne Wörter im Interview auszutauschen.
 +
 +**Tipp:** Verwenden Sie die Funktion ''[[:de:create:functions:textlink|textlink()]]'', um einen Textbaustein in einem neuen Fenster (als PopUp) anzuzeigen. Mit der Funktion ''[[:de:create:functions:gettextelement|getTextElement()]]'' können Sie den Inhalt eines Textbausteins für die weitere Verwendung im PHP-Code auslesen.
 +
 +**Tipp:** Formatieren Sie die Texte bei der Eingabe mit HTML- oder Wiki-Tags, um Überschriften, Absätze, fett-Schrift oder Umbrüche zu definieren ([[:de:create:texts|Texte im Fragebogen]]).
 +
 +
 +===== Beispiel: Zufällig einen Text auswählen =====
 +
 +Folgendes Beispiel zeigt zufällig ([[:de:create:random_urns|Randomisierung mit Urnen]]) den Textbaustein mit der Kennung "stimulusA" oder "stimulusB" an.
 +
 +<code php>
 +urnDraw('stimulus', 'IV01');
 +if (value('IV01_01') == 1) {
 +  text('stimulusA');
 +} else {
 +  text('stimulusB');
 +}
 +</code>
 +
 +===== Beispiel: Abstand und Ausrichtung =====
 +
 +Im folgenden Beispiel wird der Textbaustein mit der Kennung "explanation" im Blocksatz angezeigt und der nachfolgende Inhalt im Fragebogen (z.B. Frage ''AB01'') hat 60 Pixel Abstand.
 +
 +<code php>
 +text('explanation', 'spacing=60', 'align=justify');
 +question('AB01');
 +</code>
 +
 +**Tipp:** Abstand und Ausrichtung können Sie u.U. direkt im Textbaustein festlegen.
 +
 +**Tipp:** Wenn Sie den Textbaustein in die Fragebogen-Seite hineingezogen haben (Drag & Drop), dann klicken Sie auf das Zahnrad {{:button.settings.png?nolink|Anzeige-Einstellungen}}, um Ausrichtung und Abstand feszulegen.
de/create/functions/text.txt · Zuletzt geändert: 01.12.2014 11:49 von msd-media
 
Falls nicht anders bezeichnet, ist der Inhalt dieses Wikis unter der folgenden Lizenz veröffentlicht: CC Attribution-Share Alike 4.0 International
Driven by DokuWiki