mirror of
https://github.com/smarty-php/smarty.git
synced 2025-11-10 01:01:45 +01:00
783 lines
19 KiB
XML
783 lines
19 KiB
XML
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
<!-- $Revision$ -->
|
|
<!-- EN-Revision: 1.14 Maintainer: andreas Status: ready -->
|
|
<sect1 id="language.function.section">
|
|
<title>section,sectionelse</title>
|
|
<para>
|
|
Template-{sections} werden verwendet, um durch <emphasis
|
|
role="bold">Arrays</emphasis> zu iterieren (ä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ä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.
|
|
</para>
|
|
<informaltable frame="all">
|
|
<tgroup cols="5">
|
|
<colspec colname="param" align="center" />
|
|
<colspec colname="type" align="center" />
|
|
<colspec colname="required" align="center" />
|
|
<colspec colname="default" align="center" />
|
|
<colspec colname="desc" />
|
|
<thead>
|
|
<row>
|
|
<entry>Attribut Name</entry>
|
|
<entry>Typ</entry>
|
|
<entry>Erforderlich</entry>
|
|
<entry>Standardwert</entry>
|
|
<entry>Beschreibung</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry>name</entry>
|
|
<entry>string</entry>
|
|
<entry>Ja</entry>
|
|
<entry><emphasis>n/a</emphasis></entry>
|
|
<entry>Der Name der 'section'</entry>
|
|
</row>
|
|
<row>
|
|
<entry>loop</entry>
|
|
<entry>[$variable_name]</entry>
|
|
<entry>Ja</entry>
|
|
<entry><emphasis>n/a</emphasis></entry>
|
|
<entry>Der Name des Zählers für die Iterationen.</entry>
|
|
</row>
|
|
<row>
|
|
<entry>start</entry>
|
|
<entry>integer</entry>
|
|
<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>
|
|
</row>
|
|
<row>
|
|
<entry>step</entry>
|
|
<entry>integer</entry>
|
|
<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.
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>max</entry>
|
|
<entry>integer</entry>
|
|
<entry>Nein</entry>
|
|
<entry><emphasis>n/a</emphasis></entry>
|
|
<entry>Maximale Anzahl an Iterationen, die Durchlaufen werden.</entry>
|
|
</row>
|
|
<row>
|
|
<entry>show</entry>
|
|
<entry>boolean</entry>
|
|
<entry>Nein</entry>
|
|
<entry><emphasis>true</emphasis></entry>
|
|
<entry>Definiert ob diese 'section' angezeigt werden soll oder nicht.</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</informaltable>
|
|
<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 />
|
|
{/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>
|
|
|
|
<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>
|
|
|
|
</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
|
|
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>
|
|
{/section}
|
|
]]>
|
|
</programlisting>
|
|
<para>
|
|
Ausgabe des obigen Beispiels:
|
|
</para>
|
|
<screen>
|
|
<![CDATA[
|
|
|
|
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>
|
|
<![CDATA[
|
|
{*
|
|
die 'name'-Variable definiert den Namen der verwendet werden soll,
|
|
um Daten aus dieser 'section' zu referenzieren
|
|
*}
|
|
{section name=meinedaten loop=$KundenId}
|
|
<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>
|
|
<![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}
|
|
<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 />
|
|
{/section}
|
|
{/section}
|
|
]]>
|
|
</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>
|
|
<![CDATA[
|
|
{*
|
|
Dies ist ein Beispiel wie man einen assoziativen Array in einer
|
|
'section' ausgeben kann.
|
|
*}
|
|
{section name=customer loop=$contacts}
|
|
<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. *}
|
|
|
|
{foreach item=customer from=$contacts}
|
|
<p>
|
|
name: {$customer.name}<br />
|
|
home: {$customer.home}<br />
|
|
cell: {$customer.cell}<br />
|
|
e-mail: {$customer.email}
|
|
</p>
|
|
{/foreach}
|
|
]]>
|
|
</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>
|
|
<![CDATA[
|
|
{*
|
|
sectionelse wird aufgerufen, wenn keine $custid Werte vorhanden sind
|
|
*}
|
|
{section name=customer loop=$custid}
|
|
|
|
id: {$custid[customer]}<br>
|
|
{sectionelse}
|
|
keine Werte in $custid gefunden
|
|
{/section}
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
<para>
|
|
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.
|
|
</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).
|
|
</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.
|
|
</para>
|
|
</note>
|
|
<example>
|
|
<title>'section'-Eigenschaft 'index'</title>
|
|
<programlisting>
|
|
<![CDATA[
|
|
{section name=customer loop=$custid}
|
|
{$smarty.section.customer.index} id: {$custid[customer]}<br />
|
|
{/section}
|
|
]]>
|
|
</programlisting>
|
|
<para>
|
|
Ausgabe des obigen Beispiels:
|
|
</para>
|
|
<programlisting>
|
|
<![CDATA[
|
|
0 id: 1000<br />
|
|
1 id: 1001<br />
|
|
2 id: 1002<br />
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</sect2>
|
|
<sect2 id="section.property.index.prev">
|
|
<title>index_prev</title>
|
|
<para>
|
|
'index_prev' wird verwendet um den vorhergehenden Schleifen-Index
|
|
auszugeben. Bei der ersten Iteration ist dieser Wert -1.
|
|
</para>
|
|
<example>
|
|
<title>section'-Eigenschaft 'index_prev'</title>
|
|
<programlisting>
|
|
<![CDATA[
|
|
{section name=customer loop=$custid}
|
|
{$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>
|
|
{/if}
|
|
{/section}
|
|
]]>
|
|
</programlisting>
|
|
<para>
|
|
Ausgabe des obigen Beispiels:
|
|
</para>
|
|
<programlisting>
|
|
<![CDATA[
|
|
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>
|
|
</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).
|
|
</para>
|
|
<example>
|
|
<title>section'-Eigenschaft 'index_next'</title>
|
|
<programlisting>
|
|
<![CDATA[
|
|
{section name=customer loop=$custid}
|
|
{$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>
|
|
{/if}
|
|
{/section}
|
|
]]>
|
|
</programlisting>
|
|
<para>
|
|
Ausgabe des obigen Beispiels:
|
|
</para>
|
|
<programlisting>
|
|
<![CDATA[
|
|
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>
|
|
</example>
|
|
</sect2>
|
|
<sect2 id="section.property.iteration">
|
|
<title>iteration</title>
|
|
<para>
|
|
'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.
|
|
</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>
|
|
{* 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>
|
|
{/if}
|
|
{/section}
|
|
]]>
|
|
</programlisting>
|
|
<para>
|
|
Ausgabe des obigen Beispiels:
|
|
</para>
|
|
<programlisting>
|
|
<![CDATA[
|
|
aktuelle loop iteration: 1
|
|
5 id: 1000<br>
|
|
Die Kundennummer wird sich ändern.<br>
|
|
aktuelle loop iteration: 2
|
|
7 id: 1001<br>
|
|
Die Kundennummer wird sich ändern.<br>
|
|
aktuelle loop iteration: 3
|
|
9 id: 1002<br>
|
|
Die Kundennummer wird sich ä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.
|
|
</para>
|
|
<example>
|
|
<title>'section'-Eigenschaft 'first'</title>
|
|
<programlisting>
|
|
<![CDATA[
|
|
{section name=customer loop=$custid}
|
|
{if $smarty.section.customer.first}
|
|
<table>
|
|
{/if}
|
|
|
|
<tr><td>{$smarty.section.customer.index} id:
|
|
{$custid[customer]}</td></tr>
|
|
|
|
{if $smarty.section.customer.last}
|
|
</table>
|
|
{/if}
|
|
{/section}
|
|
]]>
|
|
</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.
|
|
</para>
|
|
<example>
|
|
<title>'section'-Eigenschaft 'last'</title>
|
|
<programlisting>
|
|
<![CDATA[
|
|
{section name=customer loop=$custid}
|
|
{if $smarty.section.customer.first}
|
|
<table>
|
|
{/if}
|
|
|
|
<tr><td>{$smarty.section.customer.index} id:
|
|
{$custid[customer]}</td></tr>
|
|
|
|
{if $smarty.section.customer.last}
|
|
</table>
|
|
{/if}
|
|
{/section}
|
|
]]>
|
|
</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.
|
|
</para>
|
|
<example>
|
|
<title>'section'-Eigenschaft 'rownum'</title>
|
|
<programlisting>
|
|
<![CDATA[
|
|
{section name=customer loop=$custid}
|
|
{$smarty.section.customer.rownum} id: {$custid[customer]}<br />
|
|
{/section}
|
|
</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.
|
|
</para>
|
|
<example>
|
|
<title>'section'-Eigenschaft 'loop'</title>
|
|
<programlisting>
|
|
<![CDATA[
|
|
{section name=customer loop=$custid}
|
|
{$smarty.section.customer.index} id: {$custid[customer]}<br />
|
|
{/section}
|
|
|
|
Es wurden {$smarty.section.customer.loop} Kunden angezeigt.
|
|
]]>
|
|
</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>
|
|
<sect2 id="section.property.show">
|
|
<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.
|
|
</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 />
|
|
{/section}
|
|
|
|
{if $smarty.section.customer.show}
|
|
die 'section' wurde angezeigt
|
|
{else}
|
|
die 'section' wurde nicht angezeigt
|
|
{/if}
|
|
]]>
|
|
</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>
|
|
<sect2 id="section.property.total">
|
|
<title>total</title>
|
|
<para>
|
|
Wird verwendet um die Anzahl der durchlaufenen Iterationen einer
|
|
'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>
|
|
{/section}
|
|
|
|
Es wurden {$smarty.section.customer.total} Kunden angezeigt.
|
|
]]>
|
|
</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>
|
|
</sect1>
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-omittag:t
|
|
sgml-shorttag:t
|
|
sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t
|
|
sgml-indent-step:1
|
|
sgml-indent-data:t
|
|
indent-tabs-mode:nil
|
|
sgml-parent-document:nil
|
|
sgml-default-dtd-file:"../../../../manual.ced"
|
|
sgml-exposed-tags:nil
|
|
sgml-local-catalogs:nil
|
|
sgml-local-ecat-files:nil
|
|
End:
|
|
vim600: syn=xml fen fdm=syntax fdl=2 si
|
|
vim: et tw=78 syn=sgml
|
|
vi: ts=1 sw=1
|
|
-->
|