mirror of
https://github.com/smarty-php/smarty.git
synced 2025-08-06 11:24:27 +02:00
sync with en
This commit is contained in:
@@ -1,8 +1,16 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 1.3 Maintainer: andreas Status: ready -->
|
||||
<!-- EN-Revision: 1.7 Maintainer: andreas Status: ready -->
|
||||
<sect1 id="language.function.html.image">
|
||||
<title>html_image (Ausgabe von HTML-IMG Tag)</title>
|
||||
<para>
|
||||
{html_image} ist eine <link
|
||||
linkend="language.custom.functions">eigene Funktion</link> 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
|
||||
<20>bergeben werden.
|
||||
</para>
|
||||
|
||||
<informaltable frame="all">
|
||||
<tgroup cols="5">
|
||||
<colspec colname="param" align="center" />
|
||||
@@ -30,90 +38,93 @@
|
||||
<row>
|
||||
<entry>height</entry>
|
||||
<entry>string</entry>
|
||||
<entry>No</entry>
|
||||
<entry><emphasis>Normale Höhe des Bildes</emphasis></entry>
|
||||
<entry>Höhe des Bildes</entry>
|
||||
<entry>Nein</entry>
|
||||
<entry><emphasis>Normale H<EFBFBD>he des Bildes</emphasis></entry>
|
||||
<entry>H<EFBFBD>he des Bildes</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>width</entry>
|
||||
<entry>string</entry>
|
||||
<entry>No</entry>
|
||||
<entry>Nein</entry>
|
||||
<entry><emphasis>Normale Breite des Bildes</emphasis></entry>
|
||||
<entry>Breite des Bildes</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>basedir</entry>
|
||||
<entry>string</entry>
|
||||
<entry>no</entry>
|
||||
<entry><emphasis>DOCUMENTROOT</emphasis></entry>
|
||||
<entry>Basisverzeichnis für relative Pfadangaben</entry>
|
||||
<entry>Nein</entry>
|
||||
<entry><emphasis>DOCUMENT_ROOT</emphasis></entry>
|
||||
<entry>Basisverzeichnis f<EFBFBD>r relative Pfadangaben</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>alt</entry>
|
||||
<entry>string</entry>
|
||||
<entry>no</entry>
|
||||
<entry>Nein</entry>
|
||||
<entry><emphasis>""</emphasis></entry>
|
||||
<entry>Alternative Beschreibung des Bildes</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>href</entry>
|
||||
<entry>string</entry>
|
||||
<entry>no</entry>
|
||||
<entry>Nein</entry>
|
||||
<entry><emphasis>n/a</emphasis></entry>
|
||||
<entry>Link für das Bild</entry>
|
||||
<entry>Link f<EFBFBD>r das Bild</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>path_prefix</entry>
|
||||
<entry>string</entry>
|
||||
<entry>Nein</entry>
|
||||
<entry><emphasis>n/a</emphasis></entry>
|
||||
<entry>Pr<EFBFBD>fix f<>r den Pfad zum Bild</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
|
||||
<para>
|
||||
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.
|
||||
basedir ist der Basispfad der f<>r die Verlinkung verwendet werden
|
||||
soll. Wenn kein Wert <20>bergeben wird, wird die <link
|
||||
linkend="language.variables.smarty">Umgebungsvariable</link>
|
||||
DOCUMENT_ROOT verwendet. Wenn <link
|
||||
linkend="variable.security">Sicherheit</link> eingeschaltet ist,
|
||||
muss das Bild in einem sicheren Verzeichnis liegen.
|
||||
</para>
|
||||
<para>
|
||||
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.
|
||||
<parameter>href</parameter> ist das href Attribut f<>r das
|
||||
Image-Tag. Wenn dieser Wert <20>bergeben wird, wird um das Bild ein
|
||||
<a href="LINKVALUE"><a> Tag erzeugt.
|
||||
</para>
|
||||
<para>
|
||||
<parameter>href</parameter> 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.
|
||||
<parameter>path_prefix</parameter> ist ein optionaler Pr<50>fix der dem
|
||||
Bildpfad vorangestellt wird. Die ist n<>tzlich wenn zum Beispiel f<>r
|
||||
den Bildpfad ein anderer Servername verwendet werden soll.
|
||||
</para>
|
||||
<para>
|
||||
Alle weiteren Parameter werden als Name/Wert Paare (Attribute) im <img>-Tag ausgegeben.
|
||||
Alle weiteren Parameter werden als Name/Wert Paare (Attribute) im
|
||||
<img>-Tag ausgegeben.
|
||||
</para>
|
||||
<note>
|
||||
<title>Technische Bemerkung</title>
|
||||
<para>
|
||||
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.
|
||||
{html_image} greift auf das Dateisystem zu um H<EFBFBD>he und Breite zu
|
||||
errechnen. Wenn Sie <link linkend="caching">caching</link> nicht
|
||||
verwenden sollten Sie normalerweise auf diese Funktion aus
|
||||
performance Gr<47>nden verzichten.
|
||||
</para>
|
||||
</note>
|
||||
<example>
|
||||
<title>html_image</title>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
<?php
|
||||
|
||||
require('Smarty.class.php');
|
||||
$smarty = new Smarty;
|
||||
$smarty->display('index.tpl');
|
||||
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Wobei index.tpl wie folgt aussieht:
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
-----------------------------------
|
||||
{html_image file="pumpkin.jpg"}
|
||||
{html_image file="/path/from/docroot/pumpkin.jpg"}
|
||||
{html_image file="../path/relative/to/currdir/pumpkin.jpg"}
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Mögliche Ausgabe:
|
||||
M<>gliche Ausgabe:
|
||||
</para>
|
||||
<screen>
|
||||
<![CDATA[
|
||||
|
Reference in New Issue
Block a user