Smarty - die kompilierende PHP Template-Engine
Zurück	Kapitel 8. Eigene Funktionen	Nach vorne

html_image (Ausgabe von HTML-IMG Tag)

{html_image} ist eine eigene Funktion die ein HTML Tag für ein Bild erzeugt. Die Höhe und Breite der Ausgabe wird automatisch aus der Bilddatei berechnet wenn die Werte nicht übergeben werden.

Attribut Name	Typ	Erforderlich	Standardwert	Beschreibung
file	string	Ja	n/a	Name/Pfad zum Bild
height	string	Nein	Normale Höhe des Bildes	Höhe des Bildes
width	string	Nein	Normale Breite des Bildes	Breite des Bildes
basedir	string	Nein	DOCUMENT_ROOT	Basisverzeichnis für relative Pfadangaben
alt	string	Nein	""	Alternative Beschreibung des Bildes
href	string	Nein	n/a	Link für das Bild
path_prefix	string	Nein	n/a	Präfix für den Pfad zum Bild

basedir ist der Basispfad der für die Verlinkung verwendet werden soll. Wenn kein Wert übergeben wird, wird die Umgebungsvariable DOCUMENT_ROOT verwendet. Wenn Sicherheit eingeschaltet ist, muss das Bild in einem sicheren Verzeichnis liegen.

href ist das href Attribut für das Image-Tag. Wenn dieser Wert übergeben wird, wird um das Bild ein <a href="LINKVALUE"><a> Tag erzeugt.

path_prefix ist ein optionaler Präfix der dem Bildpfad vorangestellt wird. Die ist nützlich wenn zum Beispiel für den Bildpfad ein anderer Servername verwendet werden soll.

Alle weiteren Parameter werden als Name/Wert Paare (Attribute) im <img>-Tag ausgegeben.

Technische Bemerkung: {html_image} greift auf das Dateisystem zu um Höhe und Breite zu errechnen. Wenn Sie caching nicht verwenden sollten Sie normalerweise auf diese Funktion aus performance Gründen verzichten.

Beispiel 8-8. html_image

Wobei index.tpl wie folgt aussieht:
-----------------------------------
{html_image file="pumpkin.jpg"}
{html_image file="/path/from/docroot/pumpkin.jpg"}
{html_image file="../path/relative/to/currdir/pumpkin.jpg"}

Mögliche Ausgabe:

<img src="pumpkin.jpg" alt="" width="44" height="68" />
<img src="/path/from/docroot/pumpkin.jpg" alt="" width="44" height="68" />
<img src="../path/relative/to/currdir/pumpkin.jpg" alt="" width="44" height="68" />

Zurück	Zum Anfang	Nach vorne
{html_checkboxes} (Ausgabe von HTML-Checkbox Tag)	Nach oben	html_options (Ausgabe von HTML-Options)