Textimage (SP-Tag): Unterschied zwischen den Versionen

Aus SiteparkWiki
Zur Navigation springen Zur Suche springen
(Die Seite wurde neu angelegt: ==Name== <sp:textimage> - Wandelt einen Text in ein Bild um ==Syntax== <source lang="xml"> <sp:textimage name="variable" scope="page" text="ein text von ${nam...)
 
K (Hob den Schutz von „Textimage (SP-Tag)“ auf)
 
(15 dazwischenliegende Versionen von 6 Benutzern werden nicht angezeigt)
Zeile 10: Zeile 10:
 
   width="100"
 
   width="100"
 
   height="15"
 
   height="15"
−
   fontName="Arial"
+
   fontname="Arial"
−
   fontSize="12"
+
   fontsize="12"
−
   fontStyle="bold"
+
   fontstyle="bold"
−
   fontColor="AAAAAA"
+
   fontcolor="AAAAAA"
 
   background="000000"
 
   background="000000"
−
   grafity="c"
+
   gravity="c"
 
   offset="2,5"
 
   offset="2,5"
 
   />
 
   />
Zeile 21: Zeile 21:
  
 
==Beschreibung==
 
==Beschreibung==
−
Mit diesem Tag könne aus Texten Bilder generiert werden. Über das <code>text</code>-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.
+
Mit diesem Tag können aus Texten Bilder generiert werden. Über das <code>text</code>-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 [[Template-Modus|In-]] und [[Template-Modus|Out-Modus]] unterschiedlich.
 
Dieser Tag verhält sich in [[Template-Modus|In-]] und [[Template-Modus|Out-Modus]] unterschiedlich.
  
 
;Out-Modus
 
;Out-Modus
−
:Wird <code>sp:textimage</code> im [[Template-Modus|Out-Modus]] betrieben, wird das verkleinerte Bild in einem Verzeichnis ''textimage'' unterhalb des Medien-Verzeichnises des Artikels abgelegt.
+
:Wird <code>sp:textimage</code> im [[Template-Modus|Out-Modus]] betrieben, wird das verkleinerte Bild in einem Verzeichnis ''textimage'' unterhalb des Medien-Verzeichnisses des Artikels abgelegt.
 
;In-Modus
 
;In-Modus
 
:Wird <code>sp:textimage</code> im [[Template-Modus|In-Modus]] betrieben, wird das verkleinerte Bild in der [[BinDB]] abgelegt.
 
:Wird <code>sp:textimage</code> im [[Template-Modus|In-Modus]] betrieben, wird das verkleinerte Bild in der [[BinDB]] abgelegt.
  
 
==Attribute==
 
==Attribute==
−
{| class="prettytable"
+
{| class="prettytable sortable"
 
|- class="hintergrundfarbe1"
 
|- class="hintergrundfarbe1"
 
! Name || Type || Required || Default || ab IES Version
 
! Name || Type || Required || Default || ab IES Version
Zeile 41: Zeile 41:
 
| 2
 
| 2
 
|-
 
|-
−
| <code>object</code>
+
| <code>text</code>
 
| [[Text]]
 
| [[Text]]
 
| Ja
 
| Ja
Zeile 59: Zeile 59:
 
| 2
 
| 2
 
|-
 
|-
−
| <code>fontName</code>
+
| <code>fontname</code>
 
| [[Text]]
 
| [[Text]]
 
| Nein
 
| Nein
Zeile 65: Zeile 65:
 
| 2
 
| 2
 
|-
 
|-
−
| <code>fontSize</code>
+
| <code>fontsize</code>
 
| [[Expression]]
 
| [[Expression]]
 
| Nein
 
| Nein
Zeile 71: Zeile 71:
 
| 2
 
| 2
 
|-
 
|-
−
| <code>fontStyle</code>
+
| <code>fontstyle</code>
 
| [[Text]]
 
| [[Text]]
 
| Nein
 
| Nein
Zeile 77: Zeile 77:
 
| 2
 
| 2
 
|-
 
|-
−
| <code>fontColor</code>
+
| <code>fontcolor</code>
 
| [[Text]]
 
| [[Text]]
 
| Nein
 
| Nein
Zeile 89: Zeile 89:
 
| 2
 
| 2
 
|-
 
|-
−
| <code>grafity</code>
+
| <code>gravity</code>
 
| [[Text]]
 
| [[Text]]
 
| Nein
 
| Nein
Zeile 114: Zeile 114:
 
|}
 
|}
  
−
;<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 in ein 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>
 +
:Hintergrundfarbe.
 +
 
 +
;<code>gravity</code>
 +
:Ausrichtung der Schrift auf dem Bild.
 +
:;c, center
 +
::Schrift zentrieren
 +
:;n, north
 +
::Am oberen Rand ausrichten
 +
:;ne, northeast
 +
::Am oberen-rechten Rand ausrichten
 +
:;e, east
 +
::Am rechten Rand ausrichten
 +
:;se, southeast
 +
::Am unteren-rechten Rand ausrichten
 +
:;s, south
 +
::Am unteren Rand ausrichten
 +
:;sw, southwest
 +
::Am unteren-linken Rand ausrichten
 +
:;w, west
 +
::Am linken Rand ausrichten
 +
:;nw, northwest
 +
::Am oberen-linken Rand aurichten
 +
 
 +
;<code>offset</code>
 +
:Der Offset wird mit zwei Kommata getrennten Zahlen angegeben. Der erste Wert gibt den x-offset (horizontale Verschiebung), der zweite den y-offset (vertikale Verschiebung) an.
  
−
===Beispiel A===
+
;<code>locale</code>
 +
:Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachigen Variablen.
  
−
Template Quelltext
+
;<code>scope</code>
−
<source lang="xml">
+
:[[Scope|Gültigkeitsbereich]], 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
 
Template Quelltext
 
<source lang="xml">
 
<source lang="xml">
−
xxx
+
<sp:textimage name="textImage" text="${myLink.systemlink.email}">
 +
url: <sp:print name="textImage.url"/>
 
</source>
 
</source>
  
 
Ausgabe
 
Ausgabe
 
<source lang="text">
 
<source lang="text">
−
xxx
+
url: /test/test.html.media/textimage/11400032033.png
 
</source>
 
</source>
  
−
<!--
+
 
−
bitte die passenden Kategorien auswählen und Kommentar entfernen
 
−
--------------------------------------------------------------
 
 
<noinclude>
 
<noinclude>
 
[[Category:SP-Tags]]
 
[[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]]
 
[[Category:Qualität_des_Codes_prüfen]]
 +
[[Category:Beispiel_überarbeiten_testen]]
 
</noinclude>
 
</noinclude>
−
-->
 

Aktuelle Version vom 24. Februar 2010, 12:54 Uhr

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"
   gravity="c"
   offset="2,5"
   />

Beschreibung

Mit diesem Tag können 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-Verzeichnisses 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
text 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
gravity 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 in ein 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
Hintergrundfarbe.
gravity
Ausrichtung der Schrift auf dem Bild.
c, center
Schrift zentrieren
n, north
Am oberen Rand ausrichten
ne, northeast
Am oberen-rechten Rand ausrichten
e, east
Am rechten Rand ausrichten
se, southeast
Am unteren-rechten Rand ausrichten
s, south
Am unteren Rand ausrichten
sw, southwest
Am unteren-linken Rand ausrichten
w, west
Am linken Rand ausrichten
nw, northwest
Am oberen-linken Rand aurichten
offset
Der Offset wird mit zwei Kommata getrennten Zahlen angegeben. Der erste Wert gibt den x-offset (horizontale Verschiebung), der zweite den y-offset (vertikale Verschiebung) an.
locale
Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachigen Variablen.
scope
Gültigkeitsbereich, 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
Abgerufen von „https://wiki.sitepark.com/index.php?title=Textimage_(SP-Tag)&oldid=4508“