mirror of
https://github.com/smarty-php/smarty.git
synced 2025-08-07 03:44:26 +02:00
sync with en
This commit is contained in:
@@ -1,8 +1,8 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 1.1 Maintainer: andreas Status: ready -->
|
||||
<!-- EN-Revision: 1.5 Maintainer: andreas Status: ready -->
|
||||
<sect1 id="language.function.insert">
|
||||
<title>insert (einfügen)</title>
|
||||
<title>insert (einf<EFBFBD>gen)</title>
|
||||
<informaltable frame="all">
|
||||
<tgroup cols="5">
|
||||
<colspec colname="param" align="center" />
|
||||
@@ -46,74 +46,81 @@
|
||||
<entry>[var typ]</entry>
|
||||
<entry>Nein</entry>
|
||||
<entry><emphasis>n/a</emphasis></entry>
|
||||
<entry>Variablen die der 'insert'-Funktion übergeben werden sollen.</entry>
|
||||
<entry>Variablen die der 'insert'-Funktion <EFBFBD>bergeben werden sollen.</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
<para>
|
||||
'insert'-Tags funktionieren ähnlich den 'include'-Tags,
|
||||
werden aber nicht gecached, falls <link linkend="caching">caching</link>
|
||||
eingeschaltet ist. Sie werden bei jedem Aufruf des Templates ausgeführt.
|
||||
{insert}-Tags funktionieren <EFBFBD>hnlich den <link
|
||||
linkend="language.function.include">{include}</link>-Tags, werden
|
||||
aber nicht gecached, falls <link linkend="caching">caching</link>
|
||||
eingeschaltet ist. Sie werden bei jedem Aufruf des Templates
|
||||
ausgef<65>hrt.
|
||||
</para>
|
||||
<para>
|
||||
Stellen Sie sich vor, sie hätten ein Template mit einem
|
||||
Werbebanner. Dieser Banner kann verschiedene Arten von
|
||||
Inhalten haben: Bilder, HTML, Flash, etc.
|
||||
Deshalb können wir nicht einfach einen statischen Link
|
||||
verwenden und müssen vermeiden, dass dieser Inhalt gecached wird.
|
||||
Hier kommt das 'insert'-Tag ins Spiel. Das Template kennt die Variablen
|
||||
'#banner_location_id#' und '#site_id#' (zum Beispiel aus einer Konfigurationsdatei)
|
||||
und soll eine Funktion aufrufen, die den Inhalt des Banners liefert.
|
||||
Stellen Sie sich vor, sie h<EFBFBD>tten ein Template mit einem
|
||||
Werbebanner. Dieser Banner kann verschiedene Arten von Inhalten
|
||||
haben: Bilder, HTML, Flash, etc. Deshalb k<>nnen wir nicht einfach
|
||||
einen statischen Link verwenden und m<>ssen vermeiden, dass dieser
|
||||
Inhalt gecached wird. Hier kommt das {insert}-Tag ins Spiel. Das
|
||||
Template kennt die Variablen '#banner_location_id#' und '#site_id#'
|
||||
(zum Beispiel aus einer <link
|
||||
linkend="config.files">Konfigurationsdatei</link>) und soll eine
|
||||
Funktion aufrufen, die den Inhalt des Banners liefert.
|
||||
</para>
|
||||
<example>
|
||||
<title>Funktion 'insert'</title>
|
||||
<programlisting>
|
||||
|
||||
{* erzeugen des Banners *}
|
||||
{insert name="getBanner" lid=#banner_location_id# sid=#site_id#}</programlisting>
|
||||
{insert name="getBanner" lid=#banner_location_id# sid=#site_id#}
|
||||
</programlisting>
|
||||
</example>
|
||||
<para>
|
||||
In diesem Beispiel verwenden wir die Funktion 'getBanner' und
|
||||
übergeben die Parameter '#banner_location_id#' und '#site_id#'.
|
||||
<20>bergeben die Parameter '#banner_location_id#' und '#site_id#'.
|
||||
Smarty wird daraufhin in Ihrer Applikatiopn nach einer Funktion
|
||||
namens 'getBanner' suchen und diese mit den Parametern '#banner_location_id#'
|
||||
und '#site_id#' aufrufen. Allen 'insert'-Funktionen in Ihrer Applikation
|
||||
muss 'insert_' vorangestellt werden, um Konflikte im Namensraum
|
||||
zu vermeiden. Ihre 'insert_getBanner()'-Funktion sollte etwas mit den
|
||||
übergebenen Parametern unternehmen und das Resultat zurückgeben.
|
||||
Dieses Resultat wird an der Stelle des 'insert'-Tags in Ihrem Template ausgegeben.
|
||||
In diesem Beispiel würde Smarty folgende Funktion aufrufen:
|
||||
insert_getBanner(array("lid" => "12345","sid" => "67890")) und die erhaltenen Resultate
|
||||
an Stelle des 'insert'-Tags ausgeben.
|
||||
namens 'getBanner' suchen und diese mit den Parametern
|
||||
'#banner_location_id#' und '#site_id#' aufrufen. Allen
|
||||
'insert'-Funktionen in Ihrer Applikation muss 'insert_'
|
||||
vorangestellt werden, um Konflikte im Namensraum zu vermeiden. Ihre
|
||||
'insert_getBanner()'-Funktion sollte etwas mit den <20>bergebenen
|
||||
Parametern unternehmen und das Resultat zur<75>ckgeben. Dieses
|
||||
Resultat wird an der Stelle des 'insert'-Tags in Ihrem Template
|
||||
ausgegeben. In diesem Beispiel w<>rde Smarty folgende Funktion
|
||||
aufrufen: insert_getBanner(array("lid" => "12345","sid" => "67890"))
|
||||
und die erhaltenen Resultate an Stelle des 'insert'-Tags ausgeben.
|
||||
</para>
|
||||
<para>
|
||||
Falls Sie das 'assign'-Attribut übergeben, wird die Ausgabe
|
||||
des 'insert'-Tags in dieser Variablen abgelegt.
|
||||
Bemerkung: dies ist nicht sinnvoll, wenn Caching eingeschaltet ist.
|
||||
Falls Sie das 'assign'-Attribut <EFBFBD>bergeben, wird die Ausgabe des
|
||||
'insert'-Tags in dieser Variablen abgelegt. Bemerkung: dies ist
|
||||
nicht sinnvoll, wenn <link linkend="variable.caching">Caching</link>
|
||||
eingeschaltet ist.
|
||||
</para>
|
||||
<para>
|
||||
Falls Sie das 'script'-Attribut übergeben, wird das angegebene
|
||||
PHP-Skript vor der Ausführung der 'insert'-Funktion eingebunden.
|
||||
Dies ist nützlich, um die 'insert'-Funktion erst in diesem
|
||||
Skript zu definieren.
|
||||
Der Pfad kann absolut oder relativ zu '$trusted_dir' angegeben werden.
|
||||
Wenn Sicherheit eingeschaltet ist, muss das Skript in '$trusted_dir'
|
||||
liegen.
|
||||
Falls Sie das 'script'-Attribut <EFBFBD>bergeben, wird das angegebene
|
||||
PHP-Skript vor der Ausf<EFBFBD>hrung der {insert}-Funktion eingebunden.
|
||||
Dies ist n<EFBFBD>tzlich, um die {insert}-Funktion erst in diesem Skript zu
|
||||
definieren. Der Pfad kann absolut oder relativ zu <link
|
||||
linkend="variable.trusted.dir">$trusted_dir</link> angegeben werden.
|
||||
Wenn Sicherheit eingeschaltet ist, muss das Skript in <link
|
||||
linkend="variable.trusted.dir">$trusted_dir</link> liegen.
|
||||
</para>
|
||||
<para>
|
||||
Als zweites Argument wird der 'insert'-Funktion das Smarty-Objekt selbst
|
||||
übergeben. Damit kann dort auf die Informationen im Smarty-Objekt
|
||||
zugegriffen werden.
|
||||
Als zweites Argument wird der {insert}-Funktion das Smarty-Objekt
|
||||
selbst <20>bergeben. Damit kann dort auf die Informationen im
|
||||
Smarty-Objekt zugegriffen werden.
|
||||
</para>
|
||||
<note>
|
||||
<title>Technische Bemerkung</title>
|
||||
<para>
|
||||
Es gibt die Möglichkeit, Teile des Templates nicht zu cachen.
|
||||
Wenn Sie <link linkend="caching">caching</link> eingeschaltet haben,
|
||||
werden 'insert'-Tags nicht gecached. Sie werden jedesmal ausgeführt, wenn
|
||||
die Seite erstellt wird - selbst innerhalb gecachter Seiten. Dies funktioniert
|
||||
gut für Dinge wie Werbung (Banner), Abstimmungen, Wetterberichte, Such-Resultate, Benutzer-Feedback-Ecke, etc.
|
||||
Es gibt die M<EFBFBD>glichkeit, Teile des Templates nicht zu cachen. Wenn
|
||||
Sie <link linkend="caching">caching</link> eingeschaltet haben,
|
||||
werden {insert}-Tags nicht gecached. Sie werden jedesmal
|
||||
ausgef<EFBFBD>hrt, wenn die Seite erstellt wird - selbst innerhalb
|
||||
gecachter Seiten. Dies funktioniert gut f<>r Dinge wie Werbung
|
||||
(Banner), Abstimmungen, Wetterberichte, Such-Resultate,
|
||||
Benutzer-Feedback-Ecke, etc.
|
||||
</para>
|
||||
</note>
|
||||
</sect1>
|
||||
|
@@ -1,26 +1,63 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 1.1 Maintainer: andreas Status: ready -->
|
||||
<!-- EN-Revision: 1.9 Maintainer: andreas Status: ready -->
|
||||
<sect1 id="language.function.ldelim">
|
||||
<title>ldelim,rdelim (Ausgabe der Trennzeichen)</title>
|
||||
<para>
|
||||
ldelim und rdelim werden verwendet, um die Trennzeichen auszugeben -
|
||||
in unserem Fall "{" oder "}" - ohne dass Smarty versucht, sie zu
|
||||
interpretieren.
|
||||
interpretieren. Um text im Template vor dem Interpretieren zu
|
||||
schützen kann auch <link
|
||||
linkend="language.function.literal">{literal}{/literal}</link>
|
||||
verwendet werden. Siehe auch <link
|
||||
linkend="language.variables.smarty.ldelim">{$smarty.ldelim}</link>.
|
||||
</para>
|
||||
<example>
|
||||
<title>ldelim, rdelim</title>
|
||||
<programlisting>
|
||||
|
||||
<![CDATA[
|
||||
{* gibt die konfigurierten Trennzeichen des Templates aus *}
|
||||
|
||||
{ldelim}funktionsname{rdelim} Funktionen sehen in Smarty so aus!
|
||||
|
||||
|
||||
AUSGABE:
|
||||
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Das obige Beispiel ergibt als Ausgabe:
|
||||
</para>
|
||||
<screen>
|
||||
<![CDATA[
|
||||
{funktionsname} Funktionen sehen in Smarty so aus!</programlisting>
|
||||
]]>
|
||||
</screen>
|
||||
<para>
|
||||
Ein weiteres Beispiel (diesmal mit javascript)
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
<script language="JavaScript">
|
||||
function foo() {ldelim}
|
||||
... code ...
|
||||
{rdelim}
|
||||
</script>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Ausgabe:
|
||||
</para>
|
||||
<screen>
|
||||
<![CDATA[
|
||||
<script language="JavaScript">
|
||||
function foo() {
|
||||
.... code ...
|
||||
}
|
||||
</script>
|
||||
]]>
|
||||
</screen>
|
||||
|
||||
</example>
|
||||
<para>
|
||||
Siehe auch <link linkend="language.escaping">Smarty Parsing umgehen</link>
|
||||
</para>
|
||||
</sect1>
|
||||
<!-- Keep this comment at the end of the file
|
||||
Local variables:
|
||||
|
@@ -4,33 +4,41 @@
|
||||
<sect1 id="language.function.literal">
|
||||
<title>literal</title>
|
||||
<para>
|
||||
'literal'-Tags erlauben es, einen Block wörtlich auszugeben,
|
||||
d.h. von der Interpretation durch Smarty auszuschliessen.
|
||||
Dies ist vor allem für Javascript- oder andere Blöcke
|
||||
nützlich, die geschwungene Klammern verwenden. Alles
|
||||
was zwischen den {literal}{/literal} Tags steht, wird direkt
|
||||
angezeigt.</para>
|
||||
{literal}-Tags erlauben es, einen Block w<EFBFBD>rtlich auszugeben,
|
||||
d.h. von der Interpretation durch Smarty auszuschliessen. Dies ist
|
||||
vor allem f<EFBFBD>r Javascript- oder andere Bl<EFBFBD>cke n<>tzlich, die
|
||||
geschwungene Klammern verwenden. Alles was zwischen den
|
||||
{literal}{/literal} Tags steht, wird direkt angezeigt. Wenn in
|
||||
einem {literal}-Block temlate-Tags verwendet werden sollen, is es
|
||||
manchmal sinnvoller <link
|
||||
linkend="language.function.ldelim">{ldelim}{rdelim}</link> statt
|
||||
{literal} zu verwenden.
|
||||
</para>
|
||||
<example>
|
||||
<title>literal-Tags</title>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{literal}
|
||||
<script language=javascript>
|
||||
|
||||
<!--
|
||||
<script language=javascript>
|
||||
<!--
|
||||
function isblank(field) {
|
||||
if (field.value == '')
|
||||
{ return false; }
|
||||
else
|
||||
{
|
||||
if (field.value == '') {
|
||||
return false;
|
||||
} else {
|
||||
document.loginform.submit();
|
||||
return true;
|
||||
}
|
||||
}
|
||||
// -->
|
||||
|
||||
</script>
|
||||
{/literal}</programlisting>
|
||||
// -->
|
||||
</script>
|
||||
{/literal}
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
<para>
|
||||
Siehe auch <link linkend="language.escaping">Smarty Parsing
|
||||
umgehen</link>.
|
||||
</para>
|
||||
</sect1>
|
||||
<!-- Keep this comment at the end of the file
|
||||
Local variables:
|
||||
|
@@ -1,23 +1,44 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 1.1 Maintainer: andreas Status: ready -->
|
||||
<!-- EN-Revision: 1.6 Maintainer: andreas Status: ready -->
|
||||
<sect1 id="language.function.php">
|
||||
<title>php</title>
|
||||
<para>
|
||||
'php'-Tags erlauben es, PHP-Code direkt in das Template einzubetten. Der Inhalt
|
||||
wird nicht 'escaped', egal wie <link linkend="variable.php.handling">$php_handling</link>
|
||||
konfiguriert ist.
|
||||
Dieses Tag ist nur für erfahrene Benutzer gedacht und wird
|
||||
auch von diesen normalerweise nicht benötigt.
|
||||
{php}-Tags erlauben es, PHP-Code direkt in das Template
|
||||
einzubetten. Der Inhalt wird nicht 'escaped', egal wie <link
|
||||
linkend="variable.php.handling">$php_handling</link> konfiguriert
|
||||
ist. Dieses Tag ist nur f<EFBFBD>r erfahrene Benutzer gedacht und wird
|
||||
auch von diesen normalerweise nicht ben<EFBFBD>tigt.
|
||||
</para>
|
||||
<example>
|
||||
<title>php-Tags</title>
|
||||
<title>{php}-Tags</title>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{php}
|
||||
// php Skript direkt von Template einbinden
|
||||
include("/pfad/zu/zeige_weather.php");
|
||||
{/php}</programlisting>
|
||||
{/php}
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
<note>
|
||||
<title>Technical Note</title>
|
||||
<para>
|
||||
Um auf PHP-Variablen in {php}-Bl<42>cken zugreifen zu k<>nnen, kann es
|
||||
n<>tig sein, die Variable als <ulink
|
||||
url="&url.php-manual;global">global</ulink> zu deklarieren. Der
|
||||
{php}-Bl<42>ck l<>uft n<>mlich nicht in einem globalen Kontext, sondern
|
||||
im Kontext der method des laufenden $smarty-Objektes.
|
||||
</para>
|
||||
</note>
|
||||
<para>
|
||||
Siehe auch <link
|
||||
linkend="variable.php.handling">$php_handling</link>, <link
|
||||
linkend="language.function.include.php">{include_php}</link>, <link
|
||||
linkend="language.function.include">{include}</link> und <link
|
||||
linkend="tips.componentized.templates">Template/Script
|
||||
Komponenten</link>.
|
||||
</para>
|
||||
</sect1>
|
||||
<!-- Keep this comment at the end of the file
|
||||
Local variables:
|
||||
|
@@ -1,6 +1,6 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 1.3 Maintainer: andreas Status: ready -->
|
||||
<!-- EN-Revision: 1.13 Maintainer: andreas Status: ready -->
|
||||
<sect1 id="language.function.section">
|
||||
<title>section,sectionelse</title>
|
||||
<informaltable frame="all">
|
||||
@@ -32,7 +32,7 @@
|
||||
<entry>[$variable_name]</entry>
|
||||
<entry>Ja</entry>
|
||||
<entry><emphasis>n/a</emphasis></entry>
|
||||
<entry>Der Name des Zählers für die Iterationen.</entry>
|
||||
<entry>Der Name des Z<EFBFBD>hlers f<>r die Iterationen.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>start</entry>
|
||||
@@ -40,11 +40,13 @@
|
||||
<entry>Nein</entry>
|
||||
<entry><emphasis>0</emphasis></entry>
|
||||
<entry>
|
||||
Definiert die Startposition. Falls ein negativer Wert übergeben wird,
|
||||
berechnet sich die Startposition ausgehend vom Ende des Arrays. Wenn zum Beispiel
|
||||
7 Werte in einem Array enthalten sind und die Startposition -2 ist, ist die
|
||||
berechnete Startposition 5. Unerlaubte Werte (Werte ausserhalb der Grösse des
|
||||
Arrays) werden automatisch auf den nächstmöglichen Wert gesetzt.</entry>
|
||||
Definiert die Startposition. Falls ein negativer Wert <EFBFBD>bergeben
|
||||
wird, berechnet sich die Startposition ausgehend vom Ende des
|
||||
Arrays. Wenn zum Beispiel 7 Werte in einem Array enthalten sind
|
||||
und die Startposition -2 ist, ist die berechnete Startposition
|
||||
5. Unerlaubte Werte (Werte ausserhalb der Gr<47>sse des Arrays)
|
||||
werden automatisch auf den n<>chstm<74>glichen Wert gesetzt.
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>step</entry>
|
||||
@@ -52,9 +54,9 @@
|
||||
<entry>Nein</entry>
|
||||
<entry><emphasis>1</emphasis></entry>
|
||||
<entry>
|
||||
Definiert die Schrittweite mit welcher das Array durchlaufen wird.
|
||||
'step=2' iteriert durch 0, 2, 4, etc. Wenn ein negativer Wert übergeben wurde,
|
||||
wird das Array rückwärts durchlaufen.
|
||||
Definiert die Schrittweite mit welcher das Array durchlaufen
|
||||
wird. 'step=2' iteriert durch 0, 2, 4, etc. Wenn ein negativer
|
||||
Wert <20>bergeben wurde, wird das Array r<>ckw<6B>rts durchlaufen.
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
@@ -75,210 +77,368 @@
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
<para>
|
||||
Template-'sections' werden verwendet, um durch Arrays zu iterieren.
|
||||
Jedes <emphasis>section</emphasis>-Tag muss mit einem <emphasis>/section</emphasis>-Tag
|
||||
kombiniert werden. <emphasis>name</emphasis> und <emphasis>loop</emphasis> sind erforderliche
|
||||
Parameter. Der Name der 'section' kann frei gewählt werden, muss jedoch aus Buchstaben,
|
||||
Zahlen oder Unterstrichen bestehen. 'sections' können verschachtelt werden. Dabei ist
|
||||
zu beachten, dass sich ihre Namen unterscheiden. Aus der 'loop'-Variable (normalerweise ein
|
||||
Array von Werten) resultiert die Anzahl der Iterationen, die durchlaufen werden.
|
||||
Wenn ein Wert aus der 'loop'-Variable innerhalb der 'section' ausgegeben werden soll,
|
||||
muss der 'section-name' umschlossen mit [] angefügt werden.
|
||||
<emphasis>sectionelse</emphasis> wird ausgeführt, wenn keine Werte in der
|
||||
'loop'-Variable enthalten sind.
|
||||
Template-{sections} werden verwendet, um durch <emphasis
|
||||
role="bold">Arrays</emphasis> zu iterieren (<28>hnlich wie <link
|
||||
linkend="language.function.foreach">{foreach}</link>). Jedes
|
||||
<emphasis>section</emphasis>-Tag muss mit einem
|
||||
<emphasis>/section</emphasis>-Tag kombiniert
|
||||
werden. <emphasis>name</emphasis> und <emphasis>loop</emphasis> sind
|
||||
erforderliche Parameter. Der Name der 'section' kann frei gew<65>hlt
|
||||
werden, muss jedoch aus Buchstaben, Zahlen oder Unterstrichen
|
||||
bestehen. {sections} k<>nnen verschachtelt werden. Dabei ist zu
|
||||
beachten, dass sich ihre Namen unterscheiden. Aus der
|
||||
'loop'-Variable (normalerweise ein Array von Werten) resultiert die
|
||||
Anzahl der Iterationen, die durchlaufen werden. Wenn ein Wert aus
|
||||
der 'loop'-Variable innerhalb der {section} ausgegeben werden soll,
|
||||
muss der 'section-name' umschlossen mit [] angef<65>gt werden.
|
||||
<emphasis>sectionelse</emphasis> wird ausgef<65>hrt, wenn keine Werte
|
||||
in der 'loop'-Variable enthalten sind.
|
||||
</para>
|
||||
<example>
|
||||
<title>section</title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
|
||||
$data = array(1000,1001,1002);
|
||||
$smarty->assign('custid',$data);
|
||||
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
<programlisting>
|
||||
|
||||
|
||||
<![CDATA[
|
||||
{* dieses Beispiel gibt alle Werte des $KundenId Arrays aus *}
|
||||
{section name=kunde loop=$KundenId}
|
||||
id: {$KundenId[kunde]}<br>
|
||||
id: {$KundenId[kunde]}<br />
|
||||
{/section}
|
||||
{* alle Werte in umgekehrter Reihenfolge ausgeben: *}
|
||||
{section name=kunde loop=$KundenId step=-1}
|
||||
id: {$KundenId[kunde]}<br />
|
||||
{/section}
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Ausgabe des obigen Beispiels:
|
||||
</para>
|
||||
<screen>
|
||||
<![CDATA[
|
||||
id: 1000<br />
|
||||
id: 1001<br />
|
||||
id: 1002<br />
|
||||
<hr />
|
||||
id: 1002<br />
|
||||
id: 1001<br />
|
||||
id: 1000<br />
|
||||
]]>
|
||||
</screen>
|
||||
|
||||
AUSGABE:
|
||||
<para>
|
||||
Ein weiteres Beispiel, diesmal ohne ein zugewiesenes Array.
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{section name=foo start=10 loop=20 step=2}
|
||||
{$smarty.section.foo.index}
|
||||
{/section}
|
||||
<hr />
|
||||
{section name=bar loop=21 max=6 step=-2}
|
||||
{$smarty.section.bar.index}
|
||||
{/section}
|
||||
]]>
|
||||
</programlisting>
|
||||
|
||||
<para>
|
||||
Ausgabe des obigen Beispiels:
|
||||
</para>
|
||||
|
||||
<screen>
|
||||
<![CDATA[
|
||||
10 12 14 16 18
|
||||
<hr />
|
||||
20 18 16 14 12 10
|
||||
]]>
|
||||
</screen>
|
||||
|
||||
id: 1000<br>
|
||||
id: 1001<br>
|
||||
id: 1002<br></programlisting>
|
||||
</example>
|
||||
|
||||
|
||||
|
||||
<example>
|
||||
<title>section loop Variable</title>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{* die 'loop'-Variable definiert nur die Anzahl der Iterationen,
|
||||
Sie können in dieser 'section' auf jeden Wert des Templates
|
||||
Sie k<EFBFBD>nnen in dieser 'section' auf jeden Wert des Templates
|
||||
zugreifen. Dieses Beispiel geht davon aus, dass $KundenId, $Namen und
|
||||
$Adressen Arrays sind, welche die selbe Anzahl Werte enthalten *}
|
||||
{section name=kunde loop=$KundenId}
|
||||
id: {$KundenId[kunde]}<br>
|
||||
name: {$Namen[kunde]}<br>
|
||||
address: {$Adressen[kunde]}<br>
|
||||
<p>
|
||||
id: {$KundenId[kunde]}<br>
|
||||
name: {$Namen[kunde]}<br>
|
||||
address: {$Adressen[kunde]}<br>
|
||||
<p>
|
||||
{/section}
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Ausgabe des obigen Beispiels:
|
||||
</para>
|
||||
<screen>
|
||||
<![CDATA[
|
||||
|
||||
|
||||
AUSGABE:
|
||||
|
||||
id: 1000<br>
|
||||
name: Peter Müller <br>
|
||||
adresse: 253 N 45th<br>
|
||||
<p>
|
||||
id: 1001<br>
|
||||
name: Fritz Muster<br>
|
||||
adresse:: 417 Mulberry ln<br>
|
||||
<p>
|
||||
id: 1002<br>
|
||||
name: Hans Meier<br>
|
||||
adresse:: 5605 apple st<br>
|
||||
<p></programlisting>
|
||||
id: 1000<br>
|
||||
name: Peter M<>ller <br>
|
||||
adresse: 253 N 45th<br>
|
||||
<p>
|
||||
id: 1001<br>
|
||||
name: Fritz Muster<br>
|
||||
adresse:: 417 Mulberry ln<br>
|
||||
<p>
|
||||
id: 1002<br>
|
||||
name: Hans Meier<br>
|
||||
adresse:: 5605 apple st<br>
|
||||
<p>
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
|
||||
<example>
|
||||
<title>section names</title>
|
||||
<programlisting>
|
||||
{* die 'name'-Variable definiert den Namen der verwendet werden soll,
|
||||
um Daten aus dieser 'section' zu referenzieren *}
|
||||
<![CDATA[
|
||||
{*
|
||||
die 'name'-Variable definiert den Namen der verwendet werden soll,
|
||||
um Daten aus dieser 'section' zu referenzieren
|
||||
*}
|
||||
{section name=meinedaten loop=$KundenId}
|
||||
id: {$KundenId[meinedaten]}<br>
|
||||
name: {$Namen[meinedaten]}<br>
|
||||
address: {$Adressen[meinedaten]}<br>
|
||||
<p>
|
||||
{/section}</programlisting>
|
||||
<p>
|
||||
id: {$KundenId[meinedaten]}<br>
|
||||
name: {$Namen[meinedaten]}<br>
|
||||
address: {$Adressen[meinedaten]}
|
||||
</p>
|
||||
{/section}
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
|
||||
<example>
|
||||
<title>nested sections (verschachtelte 'sections')</title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
|
||||
$id = array(1001,1002,1003);
|
||||
$smarty->assign('custid',$id);
|
||||
|
||||
$fullnames = array('John Smith','Jack Jones','Jane Munson');
|
||||
$smarty->assign('name',$fullnames);
|
||||
|
||||
$addr = array('253 N 45th', '417 Mulberry ln', '5605 apple st');
|
||||
$smarty->assign('address',$addr);
|
||||
|
||||
$types = array(
|
||||
array( 'home phone', 'cell phone', 'e-mail'),
|
||||
array( 'home phone', 'web'),
|
||||
array( 'cell phone')
|
||||
);
|
||||
$smarty->assign('contact_type', $types);
|
||||
|
||||
$info = array(
|
||||
array('555-555-5555', '666-555-5555', 'john@myexample.com'),
|
||||
array( '123-456-4', 'www.example.com'),
|
||||
array( '0457878')
|
||||
);
|
||||
$smarty->assign('contact_info', $info);
|
||||
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
<programlisting>
|
||||
{* Sections können unbegrenzt tief verschachtelt werden.
|
||||
Mit verschachtelten 'sections' können Sie auf komplexe Datenstrukturen
|
||||
zugreifen (wie zum Beispiel multidimensionale Arrays). Im folgenden Beispiel
|
||||
ist $contact_type[customer] ein Array mit Kontakttypen des aktuellen Kunden. *}
|
||||
<![CDATA[
|
||||
{*
|
||||
Sections k<>nnen unbegrenzt tief verschachtelt werden. Mit
|
||||
verschachtelten 'sections' k<>nnen Sie auf komplexe Datenstrukturen
|
||||
zugreifen (wie zum Beispiel multidimensionale Arrays). Im folgenden
|
||||
Beispiel ist $contact_type[customer] ein Array mit Kontakttypen des
|
||||
aktuellen Kunden.
|
||||
*}
|
||||
{section name=customer loop=$custid}
|
||||
id: {$custid[customer]}<br>
|
||||
name: {$name[customer]}<br>
|
||||
address: {$address[customer]}<br>
|
||||
<hr />
|
||||
id: {$custid[customer]}<br />
|
||||
name: {$name[customer]}<br />
|
||||
address: {$address[customer]}<br />
|
||||
{section name=contact loop=$contact_type[customer]}
|
||||
{$contact_type[customer][contact]}: {$contact_info[customer][contact]}<br>
|
||||
{$contact_type[customer][contact]}: {$contact_info[customer][contact]}<br />
|
||||
{/section}
|
||||
<p>
|
||||
{/section}
|
||||
|
||||
|
||||
AUSGABE:
|
||||
|
||||
id: 1000<br>
|
||||
name: John Smith<br>
|
||||
address: 253 N 45th<br>
|
||||
home phone: 555-555-5555<br>
|
||||
cell phone: 555-555-5555<br>
|
||||
e-mail: john@mydomain.com<br>
|
||||
<p>
|
||||
id: 1001<br>
|
||||
name: Jack Jones<br>
|
||||
address: 417 Mulberry ln<br>
|
||||
home phone: 555-555-5555<br>
|
||||
cell phone: 555-555-5555<br>
|
||||
e-mail: jack@mydomain.com<br>
|
||||
<p>
|
||||
id: 1002<br>
|
||||
name: Jane Munson<br>
|
||||
address: 5605 apple st<br>
|
||||
home phone: 555-555-5555<br>
|
||||
cell phone: 555-555-5555<br>
|
||||
e-mail: jane@mydomain.com<br>
|
||||
<p></programlisting>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Ausgabe des obigen Beispiels:
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
<hr />
|
||||
id: 1000<br />
|
||||
name: John Smith<br />
|
||||
address: 253 N 45th<br />
|
||||
home phone: 555-555-5555<br />
|
||||
cell phone: 666-555-5555<br />
|
||||
e-mail: john@myexample.com<br />
|
||||
<hr />
|
||||
id: 1001<br />
|
||||
name: Jack Jones<br />
|
||||
address: 417 Mulberry ln<br />
|
||||
home phone: 123-456-4<br />
|
||||
web: www.example.com<br />
|
||||
<hr />
|
||||
id: 1002<br />
|
||||
name: Jane Munson<br />
|
||||
address: 5605 apple st<br />
|
||||
cell phone: 0457878<br />
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
|
||||
<example>
|
||||
<title>sections und assoziative Arrays</title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
|
||||
$data = array(
|
||||
array('name' => 'John Smith', 'home' => '555-555-5555',
|
||||
'cell' => '666-555-5555', 'email' => 'john@myexample.com'),
|
||||
array('name' => 'Jack Jones', 'home' => '777-555-5555',
|
||||
'cell' => '888-555-5555', 'email' => 'jack@myexample.com'),
|
||||
array('name' => 'Jane Munson', 'home' => '000-555-5555',
|
||||
'cell' => '123456', 'email' => 'jane@myexample.com')
|
||||
);
|
||||
$smarty->assign('contacts',$data);
|
||||
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
<programlisting>
|
||||
{* Dies ist ein Beispiel wie man einen assoziativen Array
|
||||
in einer 'section' ausgeben kann.*}
|
||||
<![CDATA[
|
||||
{*
|
||||
Dies ist ein Beispiel wie man einen assoziativen Array in einer
|
||||
'section' ausgeben kann.
|
||||
*}
|
||||
{section name=customer loop=$contacts}
|
||||
name: {$contacts[customer].name}<br>
|
||||
home: {$contacts[customer].home}<br>
|
||||
cell: {$contacts[customer].cell}<br>
|
||||
e-mail: {$contacts[customer].email}<p>
|
||||
<p>
|
||||
name: {$contacts[customer].name}<br />
|
||||
home: {$contacts[customer].home}<br />
|
||||
cell: {$contacts[customer].cell}<br />
|
||||
e-mail: {$contacts[customer].email}
|
||||
</p>
|
||||
{/section}
|
||||
|
||||
{* Anm. d. übersetzers: Oft ist die Anwendung von 'foreach' kürzer. *}
|
||||
{* Anm. d. <EFBFBD>bersetzers: Oft ist die Anwendung von 'foreach' k<EFBFBD>rzer. *}
|
||||
|
||||
{foreach item=customer from=$contacts}
|
||||
name: {$customer.name}<br>
|
||||
home: {$customer.home}<br>
|
||||
cell: {$customer.cell}<br>
|
||||
e-mail: {$customer.email}<p>
|
||||
<p>
|
||||
name: {$customer.name}<br />
|
||||
home: {$customer.home}<br />
|
||||
cell: {$customer.cell}<br />
|
||||
e-mail: {$customer.email}
|
||||
</p>
|
||||
{/foreach}
|
||||
|
||||
|
||||
AUSGABE:
|
||||
|
||||
name: John Smith<br>
|
||||
home: 555-555-5555<br>
|
||||
cell: 555-555-5555<br>
|
||||
e-mail: john@mydomain.com<p>
|
||||
name: Jack Jones<br>
|
||||
home phone: 555-555-5555<br>
|
||||
cell phone: 555-555-5555<br>
|
||||
e-mail: jack@mydomain.com<p>
|
||||
name: Jane Munson<br>
|
||||
home phone: 555-555-5555<br>
|
||||
cell phone: 555-555-5555<br>
|
||||
e-mail: jane@mydomain.com<p></programlisting>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Ausgabe des obigen Beispiels:
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
<p>
|
||||
name: John Smith<br />
|
||||
home: 555-555-5555<br />
|
||||
cell: 555-555-5555<br />
|
||||
e-mail: john@mydomain.com
|
||||
</p>
|
||||
<p>
|
||||
name: Jack Jones<br />
|
||||
home phone: 555-555-5555<br />
|
||||
cell phone: 555-555-5555<br />
|
||||
e-mail: jack@mydomain.com
|
||||
<p>
|
||||
name: Jane Munson<br />
|
||||
home phone: 555-555-5555<br />
|
||||
cell phone: 555-555-5555<br />
|
||||
e-mail: jane@mydomain.com
|
||||
</p>
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<example>
|
||||
<title>sectionelse</title>
|
||||
<programlisting>
|
||||
{* sectionelse wird aufgerufen, wenn keine $custid Werte vorhanden sind *}
|
||||
<![CDATA[
|
||||
{*
|
||||
sectionelse wird aufgerufen, wenn keine $custid Werte vorhanden sind
|
||||
*}
|
||||
{section name=customer loop=$custid}
|
||||
id: {$custid[customer]}<br>
|
||||
|
||||
id: {$custid[customer]}<br>
|
||||
{sectionelse}
|
||||
keine Werte in $custid gefunden
|
||||
{/section}</programlisting>
|
||||
{/section}
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
<para>
|
||||
Die Eigenschaften der 'section' werden in besonderen Variablen abgelegt.
|
||||
Diese sind wie folgt aufgebaut: {$smarty.section.sectionname.varname}
|
||||
Die Eigenschaften der 'section' werden in besonderen Variablen
|
||||
abgelegt. Diese sind wie folgt aufgebaut: <link
|
||||
linkend="language.variables.smarty.loops">{$smarty.section.sectionname.varname}</link>
|
||||
</para>
|
||||
<note>
|
||||
<para>
|
||||
Bermerkung: Seit Smarty 1.5.0 hat sich die Syntax der 'section' Eigenschaften
|
||||
von {%sectionname.varname%} zu {$smarty.section.sectionname.varname} geändert.
|
||||
Die alte Syntax wird noch immer unterstützt, die Dokumentation erwähnt
|
||||
jedoch nur noch die neue Schreibweise.
|
||||
Bermerkung: Seit Smarty 1.5.0 hat sich die Syntax der 'section'
|
||||
Eigenschaften von {%sectionname.varname%} zu
|
||||
{$smarty.section.sectionname.varname} ge<67>ndert. Die alte Syntax
|
||||
wird noch immer unterst<73>tzt, die Dokumentation erw<72>hnt jedoch nur
|
||||
noch die neue Schreibweise.
|
||||
</para>
|
||||
</note>
|
||||
<sect2 id="section.property.index">
|
||||
<title>index</title>
|
||||
<para>
|
||||
'index' wird verwendet, um den aktuellen Schleifen-Index anzuzeigen. Er startet
|
||||
bei 0 (beziehungsweise der definierten Startposition) und inkrementiert in 1-er Schritten
|
||||
(beziehungsweise der definierten Schrittgrösse).
|
||||
'index' wird verwendet, um den aktuellen Schleifen-Index
|
||||
anzuzeigen. Er startet bei 0 (beziehungsweise der definierten
|
||||
Startposition) und inkrementiert in 1-er Schritten (beziehungsweise
|
||||
der definierten Schrittgr<67>sse).
|
||||
</para>
|
||||
<note>
|
||||
<title>Technische Bemerkung</title>
|
||||
<para>
|
||||
Wenn 'step' und 'start' nicht übergeben werden, verhält sich
|
||||
der Wert wie die 'section'-Eigenschaft 'iteration', ausser dass
|
||||
er bei 0 anstatt 1 beginnt.
|
||||
Wenn 'step' und 'start' nicht <EFBFBD>bergeben werden, verh<EFBFBD>lt sich der
|
||||
Wert wie die 'section'-Eigenschaft 'iteration', ausser dass er bei
|
||||
0 anstatt 1 beginnt.
|
||||
</para>
|
||||
</note>
|
||||
<example>
|
||||
<title>'section'-Eigenschaft 'index'</title>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{section name=customer loop=$custid}
|
||||
{$smarty.section.customer.index} id: {$custid[customer]}<br>
|
||||
{$smarty.section.customer.index} id: {$custid[customer]}<br />
|
||||
{/section}
|
||||
|
||||
|
||||
AUSGABE:
|
||||
|
||||
0 id: 1000<br>
|
||||
1 id: 1001<br>
|
||||
2 id: 1002<br>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Ausgabe des obigen Beispiels:
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
0 id: 1000<br />
|
||||
1 id: 1001<br />
|
||||
2 id: 1002<br />
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
</sect2>
|
||||
@@ -291,53 +451,64 @@ e-mail: jane@mydomain.com<p></programlisting>
|
||||
<example>
|
||||
<title>section'-Eigenschaft 'index_prev'</title>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{section name=customer loop=$custid}
|
||||
{$smarty.section.customer.index} id: {$custid[customer]}<br>
|
||||
{$smarty.section.customer.index} id: {$custid[customer]}<br>
|
||||
{* zur Information, $custid[customer.index] und $custid[customer] bedeuten das selbe *}
|
||||
{if $custid[customer.index_prev] ne $custid[customer.index]}
|
||||
Die Kundennummer hat sich geändert.<br>
|
||||
Die Kundennummer hat sich ge<EFBFBD>ndert.<br>
|
||||
{/if}
|
||||
{/section}
|
||||
|
||||
|
||||
AUSGABE:
|
||||
|
||||
0 id: 1000<br>
|
||||
Die Kundennummer hat sich geändert.<br>
|
||||
1 id: 1001<br>
|
||||
Die Kundennummer hat sich geändert.<br>
|
||||
2 id: 1002<br>
|
||||
Die Kundennummer hat sich geändert.<br>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Ausgabe des obigen Beispiels:
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
0 id: 1000<br>
|
||||
Die Kundennummer hat sich ge<67>ndert.<br>
|
||||
1 id: 1001<br>
|
||||
Die Kundennummer hat sich ge<67>ndert.<br>
|
||||
2 id: 1002<br>
|
||||
Die Kundennummer hat sich ge<67>ndert.<br>
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
</sect2>
|
||||
<sect2 id="section.property.index.next">
|
||||
<title>index_next</title>
|
||||
<para>
|
||||
'index_next' wird verwendet um den nächsten 'loop'-Index
|
||||
auszugeben. Bei der letzten Iteration ist dieser Wert um 1 grösser
|
||||
als der aktuelle 'loop'-Index (inklusive dem definierten 'step' Wert).
|
||||
'index_next' wird verwendet um den n<EFBFBD>chsten 'loop'-Index
|
||||
auszugeben. Bei der letzten Iteration ist dieser Wert um 1 gr<EFBFBD>sser
|
||||
als der aktuelle 'loop'-Index (inklusive dem definierten 'step'
|
||||
Wert).
|
||||
</para>
|
||||
<example>
|
||||
<title>section'-Eigenschaft 'index_next'</title>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{section name=customer loop=$custid}
|
||||
{$smarty.section.customer.index} id: {$custid[customer]}<br>
|
||||
{$smarty.section.customer.index} id: {$custid[customer]}<br>
|
||||
{* zur Information, $custid[customer.index] und $custid[customer] bedeuten das selbe *}
|
||||
{if $custid[customer.index_next] ne $custid[customer.index]}
|
||||
Die Kundennummer wird sich ändern.<br>
|
||||
Die Kundennummer wird sich <EFBFBD>ndern.<br>
|
||||
{/if}
|
||||
{/section}
|
||||
|
||||
|
||||
AUSGABE:
|
||||
|
||||
0 id: 1000<br>
|
||||
Die Kundennummer wird sich ändern.<br>
|
||||
1 id: 1001<br>
|
||||
Die Kundennummer wird sich ändern.<br>
|
||||
2 id: 1002<br>
|
||||
Die Kundennummer wird sich ändern.<br>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Ausgabe des obigen Beispiels:
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
0 id: 1000<br>
|
||||
Die Kundennummer wird sich <20>ndern.<br>
|
||||
1 id: 1001<br>
|
||||
Die Kundennummer wird sich <20>ndern.<br>
|
||||
2 id: 1002<br>
|
||||
Die Kundennummer wird sich <20>ndern.<br>
|
||||
]]<5D>
|
||||
</programlisting>
|
||||
</example>
|
||||
</sect2>
|
||||
@@ -347,147 +518,175 @@ e-mail: jane@mydomain.com<p></programlisting>
|
||||
'iteration' wird verwendet um die aktuelle Iteration auszugeben.
|
||||
</para>
|
||||
<para>
|
||||
Bemerkung: Die Eigenschaften 'start', 'step' und 'max' beeinflussen 'iteration'
|
||||
nicht, die Eigenschaft 'index' jedoch schon. 'iteration' startet im gegensatz
|
||||
zu 'index' bei 1. 'rownum' ist ein Alias für 'iteration' und arbeitet identisch.
|
||||
Bemerkung: Die Eigenschaften 'start', 'step' und 'max'
|
||||
beeinflussen 'iteration' nicht, die Eigenschaft 'index' jedoch
|
||||
schon. 'iteration' startet im gegensatz zu 'index' bei 1. 'rownum'
|
||||
ist ein Alias f<>r 'iteration' und arbeitet identisch.
|
||||
</para>
|
||||
<example>
|
||||
<title>'section'-Eigenschaft 'iteration'</title>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{section name=customer loop=$custid start=5 step=2}
|
||||
aktuelle loop iteration: {$smarty.section.customer.iteration}<br>
|
||||
{$smarty.section.customer.index} id: {$custid[customer]}<br>
|
||||
aktuelle loop iteration: {$smarty.section.customer.iteration}<br>
|
||||
{$smarty.section.customer.index} id: {$custid[customer]}<br>
|
||||
{* zur Information, $custid[customer.index] und $custid[customer] bedeuten das gleiche *}
|
||||
{if $custid[customer.index_next] ne $custid[customer.index]}
|
||||
Die Kundennummer wird sich ändern.<br>
|
||||
Die Kundennummer wird sich <EFBFBD>ndern.<br>
|
||||
{/if}
|
||||
{/section}
|
||||
|
||||
|
||||
AUSGABE:
|
||||
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Ausgabe des obigen Beispiels:
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
aktuelle loop iteration: 1
|
||||
5 id: 1000<br>
|
||||
Die Kundennummer wird sich ändern.<br>
|
||||
5 id: 1000<br>
|
||||
Die Kundennummer wird sich <EFBFBD>ndern.<br>
|
||||
aktuelle loop iteration: 2
|
||||
7 id: 1001<br>
|
||||
Die Kundennummer wird sich ändern.<br>
|
||||
7 id: 1001<br>
|
||||
Die Kundennummer wird sich <EFBFBD>ndern.<br>
|
||||
aktuelle loop iteration: 3
|
||||
9 id: 1002<br>
|
||||
Die Kundennummer wird sich ändern.<br>
|
||||
9 id: 1002<br>
|
||||
Die Kundennummer wird sich <EFBFBD>ndern.<br>
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
</sect2>
|
||||
<sect2 id="section.property.first">
|
||||
<title>first</title>
|
||||
<para>
|
||||
|
||||
'first' ist 'true', wenn die aktuelle Iteration die erste dieser 'section' ist.
|
||||
'first' ist 'true', wenn die aktuelle Iteration die erste dieser
|
||||
'section' ist.
|
||||
</para>
|
||||
<example>
|
||||
<title>'section'-Eigenschaft 'first'</title>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{section name=customer loop=$custid}
|
||||
{if $smarty.section.customer.first}
|
||||
<table>
|
||||
<table>
|
||||
{/if}
|
||||
|
||||
<tr><td>{$smarty.section.customer.index} id:
|
||||
{$custid[customer]}</td></tr>
|
||||
<tr><td>{$smarty.section.customer.index} id:
|
||||
{$custid[customer]}</td></tr>
|
||||
|
||||
{if $smarty.section.customer.last}
|
||||
</table>
|
||||
</table>
|
||||
{/if}
|
||||
{/section}
|
||||
|
||||
|
||||
AUSGABE:
|
||||
|
||||
<table>
|
||||
<tr><td>0 id: 1000</td></tr>
|
||||
<tr><td>1 id: 1001</td></tr>
|
||||
<tr><td>2 id: 1002</td></tr>
|
||||
</table>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Ausgabe des obigen Beispiels:
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
<table>
|
||||
<tr><td>0 id: 1000</td></tr>
|
||||
<tr><td>1 id: 1001</td></tr>
|
||||
<tr><td>2 id: 1002</td></tr>
|
||||
</table>
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
</sect2>
|
||||
<sect2 id="section.property.last">
|
||||
<title>last</title>
|
||||
<para>
|
||||
|
||||
'last' ist 'true' wenn die aktuelle Iteration die letzte dieser 'section' ist.
|
||||
'last' ist 'true' wenn die aktuelle Iteration die letzte dieser
|
||||
'section' ist.
|
||||
</para>
|
||||
<example>
|
||||
<title>'section'-Eigenschaft 'last'</title>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{section name=customer loop=$custid}
|
||||
{if $smarty.section.customer.first}
|
||||
<table>
|
||||
<table>
|
||||
{/if}
|
||||
|
||||
<tr><td>{$smarty.section.customer.index} id:
|
||||
{$custid[customer]}</td></tr>
|
||||
<tr><td>{$smarty.section.customer.index} id:
|
||||
{$custid[customer]}</td></tr>
|
||||
|
||||
{if $smarty.section.customer.last}
|
||||
</table>
|
||||
</table>
|
||||
{/if}
|
||||
{/section}
|
||||
|
||||
|
||||
AUSGABE:
|
||||
|
||||
<table>
|
||||
<tr><td>0 id: 1000</td></tr>
|
||||
<tr><td>1 id: 1001</td></tr>
|
||||
<tr><td>2 id: 1002</td></tr>
|
||||
</table>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Ausgabe des obigen Beispiels:
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
<table>
|
||||
<tr><td>0 id: 1000</td></tr>
|
||||
<tr><td>1 id: 1001</td></tr>
|
||||
<tr><td>2 id: 1002</td></tr>
|
||||
</table>
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
</sect2>
|
||||
<sect2 id="section.property.rownum">
|
||||
<title>rownum</title>
|
||||
<para>
|
||||
'rownum' wird verwendet um die aktuelle Iteration (startend bei 1) auszugeben.
|
||||
'rownum' ist ein Alias für 'iteration' und arbeitet identisch.
|
||||
'rownum' wird verwendet um die aktuelle Iteration (startend bei 1)
|
||||
auszugeben. 'rownum' ist ein Alias f<EFBFBD>r 'iteration' und arbeitet
|
||||
identisch.
|
||||
</para>
|
||||
<example>
|
||||
<title>'section'-Eigenschaft 'rownum'</title>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{section name=customer loop=$custid}
|
||||
{$smarty.section.customer.rownum} id: {$custid[customer]}<br>
|
||||
{$smarty.section.customer.rownum} id: {$custid[customer]}<br />
|
||||
{/section}
|
||||
|
||||
|
||||
AUSGABE:
|
||||
|
||||
1 id: 1000<br>
|
||||
2 id: 1001<br>
|
||||
3 id: 1002<br>
|
||||
</programlisting>
|
||||
<para>
|
||||
Ausgabe des obigen Beispiels:
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
1 id: 1000<br />
|
||||
2 id: 1001<br />
|
||||
3 id: 1002<br />
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
</sect2>
|
||||
<sect2 id="section.property.loop">
|
||||
<title>loop</title>
|
||||
<para>
|
||||
'loop' wird verwendet, um die Nummer letzte Iteration der 'section' auszugeben.
|
||||
Dieser Wert kann inner- und ausserhalb der 'section' verwendet werden.
|
||||
'loop' wird verwendet, um die Nummer letzte Iteration der 'section'
|
||||
auszugeben. Dieser Wert kann inner- und ausserhalb der 'section'
|
||||
verwendet werden.
|
||||
</para>
|
||||
<example>
|
||||
<title>'section'-Eigenschaft 'loop'</title>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{section name=customer loop=$custid}
|
||||
{$smarty.section.customer.index} id: {$custid[customer]}<br>
|
||||
{$smarty.section.customer.index} id: {$custid[customer]}<br />
|
||||
{/section}
|
||||
|
||||
Es wurden {$smarty.section.customer.loop} Kunden angezeigt.
|
||||
|
||||
AUSGABE:
|
||||
|
||||
0 id: 1000<br>
|
||||
1 id: 1001<br>
|
||||
2 id: 1002<br>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Ausgabe des obigen Beispiels:
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
0 id: 1000<br />
|
||||
1 id: 1001<br />
|
||||
2 id: 1002<br />
|
||||
|
||||
Es wurden 3 Kunden angezeigt.
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
</sect2>
|
||||
@@ -495,14 +694,16 @@ e-mail: jane@mydomain.com<p></programlisting>
|
||||
<title>show</title>
|
||||
<para>
|
||||
<emphasis>show</emphasis> kann die Werte 'true' oder 'false' haben.
|
||||
Falls der Wert 'true' ist, wird die 'section' angezeigt. Falls
|
||||
der Wert 'false' ist, wird die 'section' - ausser dem 'sectionelse' - nicht ausgegeben.
|
||||
Falls der Wert 'true' ist, wird die 'section' angezeigt. Falls der
|
||||
Wert 'false' ist, wird die 'section' - ausser dem 'sectionelse' -
|
||||
nicht ausgegeben.
|
||||
</para>
|
||||
<example>
|
||||
<title>'section'-Eigenschaft 'show'</title>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{section name=customer loop=$custid show=$show_customer_info}
|
||||
{$smarty.section.customer.rownum} id: {$custid[customer]}<br>
|
||||
{$smarty.section.customer.rownum} id: {$custid[customer]}<br />
|
||||
{/section}
|
||||
|
||||
{if $smarty.section.customer.show}
|
||||
@@ -510,15 +711,19 @@ e-mail: jane@mydomain.com<p></programlisting>
|
||||
{else}
|
||||
die 'section' wurde nicht angezeigt
|
||||
{/if}
|
||||
|
||||
|
||||
AUSGABE:
|
||||
|
||||
1 id: 1000<br>
|
||||
2 id: 1001<br>
|
||||
3 id: 1002<br>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Ausgabe des obigen Beispiels:
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
1 id: 1000<br />
|
||||
2 id: 1001<br />
|
||||
3 id: 1002<br />
|
||||
|
||||
die 'section' wurde angezeigt
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
</sect2>
|
||||
@@ -526,25 +731,31 @@ e-mail: jane@mydomain.com<p></programlisting>
|
||||
<title>total</title>
|
||||
<para>
|
||||
Wird verwendet um die Anzahl der durchlaufenen Iterationen einer
|
||||
'section' auszugeben. Kann innerhalb oder ausserhalb der 'section' verwendet
|
||||
werden.
|
||||
'section' auszugeben. Kann innerhalb oder ausserhalb der 'section'
|
||||
verwendet werden.
|
||||
</para>
|
||||
<example>
|
||||
<title>'section'-Eigenschaft 'total'</title>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{section name=customer loop=$custid step=2}
|
||||
{$smarty.section.customer.index} id: {$custid[customer]}<br>
|
||||
{$smarty.section.customer.index} id: {$custid[customer]}<br>
|
||||
{/section}
|
||||
|
||||
Es wurden {$smarty.section.customer.total} Kunden angezeigt.
|
||||
|
||||
OUTPUT:
|
||||
|
||||
0 id: 1000<br>
|
||||
2 id: 1001<br>
|
||||
4 id: 1002<br>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Ausgabe des obigen Beispiels:
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
0 id: 1000<br>
|
||||
2 id: 1001<br>
|
||||
4 id: 1002<br>
|
||||
|
||||
Es wurden 3 Kunden angezeigt.
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
</sect2>
|
||||
|
@@ -1,24 +1,26 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 1.2 Maintainer: andreas Status: ready -->
|
||||
<!-- EN-Revision: 1.6 Maintainer: andreas Status: ready -->
|
||||
<sect1 id="language.function.strip">
|
||||
<title>strip</title>
|
||||
<para>
|
||||
Webdesigner haben oft das Problem, dass Leerzeichen und Zeilenumbrüche
|
||||
die Ausgabe des erzeugten HTML im Browser beeinflussen. Oft werden deshalb alle
|
||||
Tags aufeinanderfolgend im Template notiert, was aber zu einer schlechten
|
||||
Lesbarkeit führt.
|
||||
Webdesigner haben oft das Problem, dass Leerzeichen und
|
||||
Zeilenumbr<62>che die Ausgabe des erzeugten HTML im Browser
|
||||
beeinflussen. Oft werden deshalb alle Tags aufeinanderfolgend im
|
||||
Template notiert, was aber zu einer schlechten Lesbarkeit f<EFBFBD>hrt.
|
||||
</para>
|
||||
<para>
|
||||
Aus dem Inhalt zwischen den {strip}{/strip}-Tags werden alle Leerzeichen und
|
||||
Zeilenumbrüche entfernt. So können Sie Ihre Templates lesbar
|
||||
halten, ohne sich Sorgen um die Leerzeichen zu machen.
|
||||
Aus dem Inhalt zwischen den {strip}{/strip}-Tags werden alle
|
||||
Leerzeichen und Zeilenumbr<EFBFBD>che entfernt. So k<EFBFBD>nnen Sie Ihre
|
||||
Templates lesbar halten, ohne sich Sorgen um die Leerzeichen zu
|
||||
machen.
|
||||
</para>
|
||||
<note>
|
||||
<title>Technische Bemerkung</title>
|
||||
<para>
|
||||
{strip}{/strip} ändert nicht den Inhalt einer Template-Variablen.
|
||||
Dafür gibt es den <link linkend="language.modifier.strip">strip Modifikator</link>.
|
||||
{strip}{/strip} <EFBFBD>ndert nicht den Inhalt einer Template-Variablen.
|
||||
Daf<61>r gibt es den <link linkend="language.modifier.strip">strip
|
||||
Modifikator</link>.
|
||||
</para>
|
||||
</note>
|
||||
<example>
|
||||
@@ -30,27 +32,36 @@
|
||||
<table border=0>
|
||||
<tr>
|
||||
<td>
|
||||
<A HREF="{$url}">
|
||||
<a HREF="{$url}">
|
||||
<font color="red">Das ist ein Test.</font>
|
||||
</A>
|
||||
</a>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
{/strip}
|
||||
|
||||
|
||||
AUSGABE:
|
||||
|
||||
<table border=0><tr><td><A HREF="http://my.domain.com"><font color="red">Das ist ein Test.</font></A></td></tr></table></programlisting>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Ausgebe des obigen Beispiels:
|
||||
</para>
|
||||
<screen>
|
||||
<![CDATA[
|
||||
<table border=0><tr><td><A HREF="http://my.domain.com"><font color="red">Das ist ein Test.</font></A></td></tr></table>
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
<para>
|
||||
Achtung: im obigen Beispiel beginnen und enden alle Zeilen mit HTML-Tags.
|
||||
Falls Sie Abschnitte haben, die nur Text enthalten, werden diese ebenfalls
|
||||
zusammengeschlossen. Das kann zu unerwünschten Resultaten führen.
|
||||
Achtung: im obigen Beispiel beginnen und enden alle Zeilen mit
|
||||
HTML-Tags. Falls Sie Abschnitte haben, die nur Text enthalten,
|
||||
werden diese ebenfalls zusammengeschlossen. Das kann zu
|
||||
unerw<72>nschten Resultaten f<>hren.
|
||||
</para>
|
||||
<para>
|
||||
Siehe auch <link linkend="language.modifier.strip">strip-Modifikator
|
||||
(Zeichenkette strippen)</link>
|
||||
</para>
|
||||
</sect1>
|
||||
|
||||
<!-- Keep this comment at the end of the file
|
||||
Local variables:
|
||||
mode: sgml
|
||||
|
Reference in New Issue
Block a user