Textimage (SP-Tag): Unterschied zwischen den Versionen

Version vom 8. Juni 2008, 21:22 Uhr

Dieser Artikel bedarf einer Überarbeitung. Näheres ist auf der Diskussionsseite angegeben. Hilf bitte mit ihn zu verbessern und entferne anschließend diese Markierung.

Name

<sp:textimage> - Wandelt einen Text in ein Bild um

Syntax

<sp:textimage
   name="variable"
   scope="page"
   text="ein text von ${name}"
   width="100"
   height="15"
   fontName="Arial"
   fontSize="12"
   fontStyle="bold"
   fontColor="AAAAAA"
   background="000000"
   grafity="c"
   offset="2,5"
   />

Beschreibung

Mit diesem Tag könne aus Texten Bilder generiert werden. Über das text-Attribut wird der Text angegeben, aus dem das Bild erzeugt werden soll. Die Angabe von Höhe und Breite ist optional. Werden Höhe und Breite nicht angegeben, ergibt sich die Abmessung des Bildes aus Textlänge, Schriftgröße etc.

Dieser Tag verhält sich in In- und Out-Modus unterschiedlich.

Out-Modus: Wird sp:textimage im Out-Modus betrieben, wird das verkleinerte Bild in einem Verzeichnis textimage unterhalb des Medien-Verzeichnises des Artikels abgelegt.
In-Modus: Wird sp:textimage im In-Modus betrieben, wird das verkleinerte Bild in der BinDB abgelegt.

Attribute

Name	Type	Required	Default	ab IES Version
`name`	Variable	Ja	None	2
`object`	Text	Ja	None	2
`width`	Expression	Nein	None	2
`height`	Expression	Nein	None	2
`fontName`	Text	Nein	Arial	2
`fontSize`	Expression	Nein	12	2
`fontStyle`	Text	Nein	plain	2
`fontColor`	Text	Nein	000000	2
`background`	Text	Nein	FFFFFF	2
`grafity`	Text	Nein	c	2
`offset`	Text	Nein	0,0	2
`locale`	Locale	Nein	None	2
`scope`	Scope	Nein	request	2

name: Name der Variable für den Zugriff auf das TextImage-Objekt.

text: Text der als Bild umgewandelt werden soll.

width: Breite des Bildes.

height: Höhe des Bildes.

fontName: Name des zu verwendenden Zeichensatzes - muss unter dem angegebenem Namen auf dem IES-Server verfügbar sein.

fontSize: Schriftgröße.

fontStyle: Schriftstil. Mögliche Werte sind plain, bold und italic.

fontColor: Schriftfarbe.

background: Hintergrundfabe.

grafity: Ausrichtung der Schrift auf dem Bild.

offset: Der Offset wird mit zwei Kommata getrennten Zahlen angegeben. Der erste Wert gibt den x-offset (vertikale Verschiebung), der zweite den y-offset (horizontale Verschiebung) an.

locale: Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachiger Variablen.

scope: Gültigketisbereich, in dem die Variable definiert ist. Möglich sind page und request.

Beispiele

Textbild erzeugen

Template Quelltext

<sp:textimage name="textImage" text="${myLink.systemlink.email}">
url: <sp:print name="textImage.url"/>

Ausgabe

url: /test/test.html.media/textimage/11400032033.png

@@ Zeile 115: / Zeile 115: @@
 |}
-;<code>xxx</code>
+;<code>name</code>
-:xxx.
+:Name der Variable für den Zugriff auf das [[TextImage]]-Objekt.
-;<code>xxx</code>
+;<code>text</code>
-:xxx.
+:Text der als Bild umgewandelt werden soll.
-==Beispiele==
+;<code>width</code>
+:Breite des Bildes.
+;<code>height</code>
+:Höhe des Bildes.
+;<code>fontName</code>
+:Name des zu verwendenden Zeichensatzes - muss unter dem angegebenem Namen auf dem IES-Server verfügbar sein.
+;<code>fontSize</code>
+:Schriftgröße.
+;<code>fontStyle</code>
+:Schriftstil. Mögliche Werte sind <code>plain</code>, <code>bold</code> und <code>italic</code>.
+;<code>fontColor</code>
+:Schriftfarbe.
+;<code>background</code>
+:Hintergrundfabe.
+;<code>grafity</code>
+:Ausrichtung der Schrift auf dem Bild.
+;<code>offset</code>
+:Der Offset wird mit zwei Kommata getrennten Zahlen angegeben. Der erste Wert gibt den x-offset (vertikale Verschiebung), der zweite den y-offset (horizontale Verschiebung) an.
-===Beispiel A===
+;<code>locale</code>
+:Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachiger Variablen.
-Template Quelltext
+;<code>scope</code>
-<source lang="xml">
+:[[Scope|Gültigketisbereich]], in dem die Variable definiert ist. Möglich sind <code>page</code> und <code>request</code>.
-xxx
-</source>
-Ausgabe
+==Beispiele==
-<source lang="text">
-xxx
-</source>
-===Beispiel B===
+===Textbild erzeugen===
 Template Quelltext
 <source lang="xml">
-xxx
+<sp:textimage name="textImage" text="${myLink.systemlink.email}">
+url: <sp:print name="textImage.url"/>
 </source>
 Ausgabe
 <source lang="text">
-xxx
+url: /test/test.html.media/textimage/11400032033.png
 </source>
-<!--
-bitte die passenden Kategorien auswählen und Kommentar entfernen
---------------------------------------------------------------
 <noinclude>
 [[Category:SP-Tags]]
-[[Category:SPT-Tags]]
 [[Category:Qualität_des_Inhalts_prüfen]]
 [[Category:Qualität_der_Sprache_prüfen]]
 [[Category:Qualität_des_Codes_prüfen]]
 </noinclude>
- -->