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:
yannick
@@ -1,26 +1,19 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready -->
|
||||
<!-- EN-Revision: 1.18 Maintainer: yannick Status: ready -->
|
||||
|
||||
<sect1 id="language.function.section">
|
||||
<title>{section},{sectionelse}</title>
|
||||
<para>
|
||||
Les balises <emphasis>section</emphasis> sont utilis<69>es pour
|
||||
parcourir un <emphasis role="bold">tableau de donn<6E>es</emphasis>
|
||||
(tout comme <link linkend="language.function.foreach">{foreach}</link>).
|
||||
Toutes les balises <emphasis>{section}</emphasis> doivent <20>tre utilis<69>es
|
||||
de paire avec les balises <emphasis>{/section}</emphasis>. Les param<61>tres
|
||||
requis sont <emphasis>name</emphasis> et <emphasis>loop</emphasis>.
|
||||
Le nom de la {section} est, selon votre choix, compos<6F> de lettres,
|
||||
chiffres et underscores. Les sections peuvent <20>tre imbriqu<71>es,
|
||||
mais leurs noms doivent <20>tre uniques. La variable de parcours
|
||||
(g<>n<EFBFBD>ralement un tableau de donn<6E>es) d<>termine le nombre de fois
|
||||
que la section sera parcourue. Lorsque l'on affiche une variable
|
||||
dans une section, le nom de la section doit pr<70>c<EFBFBD>der
|
||||
la variable entre crochets []. <emphasis>{sectionelse}</emphasis>
|
||||
est ex<65>cut<75> lorsqu'aucune valeur n'est trouv<75>e dans la variable <20>
|
||||
parcourir.
|
||||
Une <varname>{section}</varname>
|
||||
sert <20> boucler dans des <emphasis role="bold">tableaux de donn<6E>es</emphasis>,
|
||||
contrairement <20> <link linkend="language.function.foreach"><varname>{foreach}</varname></link>
|
||||
qui est utilis<69> pour boucler dans un
|
||||
<emphasis role="bold">simple tableau associatif</emphasis>.
|
||||
Chaque balise <varname>{section}</varname> doit aller de paire avec une
|
||||
balise <varname>{/section}</varname> fermante.
|
||||
</para>
|
||||
|
||||
<informaltable frame="all">
|
||||
<tgroup cols="5">
|
||||
<colspec colname="param" align="center" />
|
||||
@@ -33,7 +26,7 @@
|
||||
<entry>Nom attribut</entry>
|
||||
<entry>Type</entry>
|
||||
<entry>Requis</entry>
|
||||
<entry>Defaut</entry>
|
||||
<entry>D<EFBFBD>faut</entry>
|
||||
<entry>Description</entry>
|
||||
</row>
|
||||
</thead>
|
||||
@@ -50,20 +43,22 @@
|
||||
<entry>mixed</entry>
|
||||
<entry>Oui</entry>
|
||||
<entry><emphasis>n/a</emphasis></entry>
|
||||
<entry>valeur qui d<>termine le nombre de fois que la boucle sera ex<65>cut<75>e.</entry>
|
||||
<entry>Valeur qui d<>termine le nombre de fois que la boucle sera ex<65>cut<75>e</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>start</entry>
|
||||
<entry>entier</entry>
|
||||
<entry>Non</entry>
|
||||
<entry><emphasis>0</emphasis></entry>
|
||||
<entry>La position de l'index ou la section commencera son
|
||||
<entry>
|
||||
La position de l'index ou la section commencera son
|
||||
parcours. Si la valeur donn<6E>e est n<>gative, la position de
|
||||
d<>part est calcul<75>e depuis la fin du tableau. Par exemple,
|
||||
s'il existe 7 valeurs dans le tableau <20> parcourir et que start
|
||||
est <20> -2, l'index de d<>part sera 5. Les valeurs incorrectes
|
||||
(en dehors de la port<72>e du tableau) sont automatiquements
|
||||
tronqu<71>es <20> la valeur correcte la plus proche.</entry>
|
||||
tronqu<EFBFBD>es <20> la valeur correcte la plus proche
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>step</entry>
|
||||
@@ -73,49 +68,104 @@
|
||||
<entry>La valeur du pas qui sera utilis<69> pour parcourir le
|
||||
tableau.Par exemple, step=2 parcourera les indices
|
||||
0,2,4, etc. Si step est n<>gatif, le tableau sera parcouru en sens
|
||||
inverse.</entry>
|
||||
inverse</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>max</entry>
|
||||
<entry>entier</entry>
|
||||
<entry>Non</entry>
|
||||
<entry><emphasis>1</emphasis></entry>
|
||||
<entry><emphasis>n/a</emphasis></entry>
|
||||
<entry>D<EFBFBD>finit le nombre maximum de fois que le tableau sera
|
||||
parcouru.</entry>
|
||||
parcouru</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>show</entry>
|
||||
<entry>bool<EFBFBD>en</entry>
|
||||
<entry>Non</entry>
|
||||
<entry><emphasis>true</emphasis></entry>
|
||||
<entry>No</entry>
|
||||
<entry><emphasis>&true;</emphasis></entry>
|
||||
<entry>D<EFBFBD>termine s'il est n<>cessaire d'afficher la
|
||||
section ou non.</entry>
|
||||
section ou non</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
|
||||
<example>
|
||||
<title>{section}</title>
|
||||
<itemizedlist>
|
||||
<listitem><para>
|
||||
Les param<61>tres requis sont <parameter>name</parameter> et <parameter>loop</parameter>.
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>
|
||||
Le <parameter>name</parameter> de la <varname>{section}</varname> est, selon votre choix,
|
||||
compos<6F> de lettres, chiffres et underscores, comme pour les
|
||||
<ulink url="&url.php-manual;language.variables">variables PHP</ulink>.
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>
|
||||
Les sections peuvent <20>tre imbriqu<71>es mais leurs noms doivent <20>tre uniques.
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>
|
||||
L'attribut <parameter>loop</parameter>, habituellement un tableau de valeurs,
|
||||
d<>termine le nombre de fois que
|
||||
<varname>{section}</varname> doit boucler.
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>
|
||||
Lors de l'affichage d'une variable dans une <varname>{section}</varname>, le nom de la
|
||||
<varname>{section}</varname> doit <20>tre fournis apr<70>s le nom de la variable entre crochets [].
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>
|
||||
<varname>{sectionelse}</varname> est ex<65>cut<75> lorsqu'aucune valeur n'est trouv<75>e dans la variable <20>
|
||||
parcourir.
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>
|
||||
<varname>{section}</varname> a <20>galement ces propres variables qui g<>rent les propri<72>t<EFBFBD>s
|
||||
de la <varname>{section}</varname>.
|
||||
Ces propri<72>t<EFBFBD>s sont accessibles comme ceci : <link linkend="language.variables.smarty.loops">
|
||||
<parameter>{$smarty.section.name.property}</parameter></link>
|
||||
o<> <quote>name</quote> est l'attribut <parameter>name</parameter>.
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>
|
||||
Les propri<72>t<EFBFBD>s de <varname>{section}</varname> sont
|
||||
<link linkend="section.property.index"><parameter>index</parameter></link>,
|
||||
<link linkend="section.property.index.prev"><parameter>index_prev</parameter></link>,
|
||||
<link linkend="section.property.index.next"><parameter>index_next</parameter></link>,
|
||||
<link linkend="section.property.iteration"><parameter>iteration</parameter></link>,
|
||||
<link linkend="section.property.first"><parameter>first</parameter></link>,
|
||||
<link linkend="section.property.last"><parameter>last</parameter></link>,
|
||||
<link linkend="section.property.rownum"><parameter>rownum</parameter></link>,
|
||||
<link linkend="section.property.loop"><parameter>loop</parameter></link>,
|
||||
<link linkend="section.property.show"><parameter>show</parameter></link>,
|
||||
<link linkend="section.property.total"><parameter>total</parameter></link>.
|
||||
</para></listitem>
|
||||
</itemizedlist>
|
||||
|
||||
<example>
|
||||
<title>Boucler dans un simple tableau avec {section}</title>
|
||||
<para>
|
||||
<link linkend="api.assign"><varname>assign()</varname></link> un tableau <20> Smarty
|
||||
</para>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
|
||||
$data = array(1000,1001,1002);
|
||||
$smarty->assign('custid',$data);
|
||||
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>Le template qui affiche le tableau</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{* Cet exemple affiche toutes les valeurs du tableau $custid *}
|
||||
{* Cet exemple affichera toutes les valeurs du tableau $custid *}
|
||||
{section name=customer loop=$custid}
|
||||
id: {$custid[customer]}<br />
|
||||
{/section}
|
||||
<hr />
|
||||
{* Affiche toutes les valeurs du tableau $custid dans le sens inverse *}
|
||||
{* Affiche toutes les valeurs du tableau $custid, en ordre inverse *}
|
||||
{section name=foo loop=$custid step=-1}
|
||||
{$custid[foo]}<br />
|
||||
{/section}
|
||||
@@ -135,9 +185,11 @@ id: 1001<br />
|
||||
id: 1000<br />
|
||||
]]>
|
||||
</screen>
|
||||
<para>
|
||||
Voici d'autres exemples sans tableaux assign<67>s.
|
||||
</para>
|
||||
</example>
|
||||
|
||||
|
||||
<example>
|
||||
<title>{section} sans un tableau assign<67></title>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{section name=foo start=10 loop=20 step=2}
|
||||
@@ -161,8 +213,94 @@ id: 1000<br />
|
||||
</screen>
|
||||
</example>
|
||||
|
||||
|
||||
<example>
|
||||
<title>{section}, variable de parcours</title>
|
||||
<title>Nommage d'une {section}</title>
|
||||
<para>
|
||||
Le <parameter>name</parameter> de la <varname>{section}</varname> peut <20>tre ce que vous
|
||||
voulez, voir les <ulink url="&url.php-manual;language.variables">variables PHP</ulink>.
|
||||
Il sera utilis<69> pour r<>f<EFBFBD>rencer les donn<6E>es de la <varname>{section}</varname>.
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{section name=anything loop=$myArray}
|
||||
{$myArray[anything].foo}
|
||||
{$name[anything]}
|
||||
{$address[anything].bar}
|
||||
{/section}
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
|
||||
|
||||
<example>
|
||||
<title>Boucler dans un tableau associatif avec {section}</title>
|
||||
<para>
|
||||
Voici un exemple d'affichage d'un tableau associatif de donn<6E>es avec
|
||||
<varname>{section}</varname>. Ce qui suit est le script PHP assignant
|
||||
le tableau <parameter>$contacts</parameter> <20> Smarty.
|
||||
</para>
|
||||
<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>
|
||||
|
||||
<para>Le template pour afficher <parameter>$contacts</parameter></para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{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}
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
L'exemple ci-dessus affichera :
|
||||
</para>
|
||||
<screen>
|
||||
<![CDATA[
|
||||
<p>
|
||||
name: John Smith<br />
|
||||
home: 555-555-5555<br />
|
||||
cell: 666-555-5555<br />
|
||||
e-mail: john@myexample.com
|
||||
</p>
|
||||
<p>
|
||||
name: Jack Jones<br />
|
||||
home phone: 777-555-5555<br />
|
||||
cell phone: 888-555-5555<br />
|
||||
e-mail: jack@myexample.com
|
||||
</p>
|
||||
<p>
|
||||
name: Jane Munson<br />
|
||||
home phone: 000-555-5555<br />
|
||||
cell phone: 123456<br />
|
||||
e-mail: jane@myexample.com
|
||||
</p>
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
|
||||
<example>
|
||||
<title>{section} d<>montrant l'utilisation de la variable <varname>loop</varname></title>
|
||||
<para>Cet exemple suppose que <parameter>$custid</parameter>, <parameter>$name</parameter>
|
||||
et <parameter>$address</parameter> sont tous des tableaux contenant le m<>me
|
||||
nombre de valeurs. Tout d'abord, le script PHP qui assigne les tableaux <20> Smarty.</para>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
@@ -173,26 +311,24 @@ $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');
|
||||
$addr = array('253 Abbey road', '417 Mulberry ln', '5605 apple st');
|
||||
$smarty->assign('address',$addr);
|
||||
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>La variable <parameter>loop</parameter> d<>termine uniquement le nombre
|
||||
de fois qu'il faut boucler.
|
||||
Vous pouvez acc<63>der <20> n'importe quelle variable du template dans la
|
||||
<varname>{section}</varname></para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{*
|
||||
La variable de parcours d<>termine uniquement le nombre de fois que nous allons
|
||||
rentrer dans la boucle. Vous pouvez acc<63>der <20> toutes les variables du template
|
||||
lorsque vous <20>tes dans une section. Cet exemple part du principe que
|
||||
$idClient, $noms et $adresses sont tous des tableaux qui contiennent
|
||||
autant de valeurs les uns que les autres.
|
||||
*}
|
||||
{section name=client loop=$idClient}
|
||||
id : {$custid[customer]}<br />
|
||||
nom : {$name[customer]}<br />
|
||||
addresse : {$address[customer]}<br />
|
||||
{section name=customer loop=$custid}
|
||||
<p>
|
||||
id: {$custid[customer]}<br />
|
||||
name: {$name[customer]}<br />
|
||||
address: {$address[customer]}
|
||||
</p>
|
||||
{/section}
|
||||
]]>
|
||||
</programlisting>
|
||||
@@ -203,44 +339,33 @@ $smarty->assign('address',$addr);
|
||||
<![CDATA[
|
||||
<p>
|
||||
id: 1000<br />
|
||||
nom : John Smith<br />
|
||||
addresse : 253 N 45th
|
||||
name: John Smith<br />
|
||||
address: 253 Abbey road
|
||||
</p>
|
||||
<p>
|
||||
id: 1001<br />
|
||||
nom : Jack Jones<br />
|
||||
addresse : 417 Mulberry ln
|
||||
name: Jack Jones<br />
|
||||
address: 417 Mulberry ln
|
||||
</p>
|
||||
<p>
|
||||
id: 1002<br />
|
||||
nom : Jane Munson<br />
|
||||
addresse : 5605 apple st
|
||||
name: Jane Munson<br />
|
||||
address: 5605 apple st
|
||||
</p>
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
|
||||
<example>
|
||||
<title>nom de {section}</title>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{*
|
||||
Le nom de la section peut <20>tre ce que vous voulez,
|
||||
et est utilis<69> pour r<>f<EFBFBD>rencer les donn<6E>es depuis la section.
|
||||
*}
|
||||
{section name=monTableau loop=$idClient}
|
||||
<p>
|
||||
id: {$idCLient[monTableau]}<br />
|
||||
name: {$noms[monTableau]}<br />
|
||||
address: {$addresses[monTableau]}
|
||||
</p>
|
||||
{/section}
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
|
||||
|
||||
<example>
|
||||
<title>sections imbriqu<71>es</title>
|
||||
<title>{section} imbriqu<71>e</title>
|
||||
<para>
|
||||
Les sections peuvent <20>tre imbriqu<71>es autant de fois que vous le voulez.
|
||||
Avec les sections imbriqu<71>es, vous pouvez acc<63>der aux structures de donn<6E>es
|
||||
complexes, comme les tableaux multi-dimentionnels. Voici un script PHP qui assigne les
|
||||
tableaux.
|
||||
</para>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
@@ -271,22 +396,17 @@ $smarty->assign('contact_info', $info);
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>Dans ce template, <emphasis>$contact_type[customer]</emphasis> est un tableau de
|
||||
types de contacts.</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{*
|
||||
Les sections peuvent <20>tre imbriqu<71>es <20> un nombre de niveaux illimit<69>.
|
||||
Gr<47>ce aux sections imbriqu<71>es, vous pouvez acc<63>der <20> des structures de donn<6E>es
|
||||
complexes, comme des tableaux multi-dimentionnels. Dans cet exemple,
|
||||
$type_contact[client] est un tableau de type de contact pour le client
|
||||
courant.
|
||||
*}
|
||||
{section name=client loop=$idClient}
|
||||
<hr />
|
||||
id: {$idClient[client]}<br />
|
||||
nom: {$nom[client]}<br />
|
||||
addresse: {$addresse[client]}<br />
|
||||
{section name=contact loop=$type_contact[client]}
|
||||
{$type_contact[client][contact]}: {$info_contact[client][contact]}<br />
|
||||
{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}
|
||||
]]>
|
||||
@@ -296,110 +416,45 @@ $smarty->assign('contact_info', $info);
|
||||
</para>
|
||||
<screen>
|
||||
<![CDATA[
|
||||
<hr />
|
||||
<hr>
|
||||
id: 1000<br />
|
||||
nom: John Smith<br />
|
||||
addresse: 253 N 45th<br />
|
||||
telephone: 555-555-5555<br />
|
||||
telephone portable: 555-555-5555<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 />
|
||||
<hr>
|
||||
id: 1001<br />
|
||||
nom: Jack Jones<br />
|
||||
addresse: 417 Mulberry ln<br />
|
||||
telephone: 555-555-5555<br />
|
||||
telephone portable: 555-555-5555<br />
|
||||
e-mail: jack@myexample.com<br />
|
||||
<hr />
|
||||
name: Jack Jones<br />
|
||||
address: 417 Mulberry ln<br />
|
||||
home phone: 123-456-4<br />
|
||||
web: www.example.com<br />
|
||||
<hr>
|
||||
id: 1002<br />
|
||||
nom: Jane Munson<br />
|
||||
addresse: 5605 apple st<br />
|
||||
telephone: 555-555-5555<br />
|
||||
telephone portable: 555-555-5555<br />
|
||||
e-mail: jane@myexample.com<br />
|
||||
<hr />
|
||||
name: Jane Munson<br />
|
||||
address: 5605 apple st<br />
|
||||
cell phone: 0457878<br />
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
|
||||
|
||||
<example>
|
||||
<title>Sections et tableaux associatifs</title>
|
||||
<title>Exemple avec une base de donn<6E>es et {sectionelse}</title>
|
||||
<para>Les r<>sultats d'une recherche dans une base de donn<6E>es
|
||||
(e.g. ADODB ou PEAR) sont assign<67>s <20> Smarty</para>
|
||||
<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[
|
||||
{*
|
||||
Exemple d'affichage d'un tableau associatif dans une section
|
||||
*}
|
||||
{section name=client loop=$contacts}
|
||||
<p>
|
||||
nom: {$contacts[client].name}<br />
|
||||
telephone: {$contacts[client].home}<br />
|
||||
portable: {$contacts[client].cell}<br />
|
||||
e-mail: {$contacts[client].email}
|
||||
</p>
|
||||
{/section}
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
L'exemple ci-dessus affichera :
|
||||
</para>
|
||||
<screen>
|
||||
<![CDATA[
|
||||
<p>
|
||||
nom: John Smith<br />
|
||||
telephone: 555-555-5555<br />
|
||||
portable: 555-555-5555<br />
|
||||
e-mail: john@myexample.com
|
||||
</p>
|
||||
<p>
|
||||
nom: Jack Jones<br />
|
||||
telephone: 555-555-5555<br />
|
||||
portable: 555-555-5555<br />
|
||||
e-mail: jack@myexample.com
|
||||
</p>
|
||||
<p>
|
||||
nom: Jane Munson<br />
|
||||
telephone: 555-555-5555<br />
|
||||
portable: 555-555-5555<br />
|
||||
e-mail: jane@myexample.com<p>
|
||||
</p>
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
|
||||
<para>Exemple avec une base de donn<6E>es (eg. en utilisant Pear ou Adodb)</para>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
|
||||
$sql = 'select id, name, home, cell, email from contacts';
|
||||
$sql = 'select id, name, home, cell, email from contacts '
|
||||
."where name like '$foo%' ";
|
||||
$smarty->assign('contacts', $db->getAll($sql));
|
||||
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
|
||||
<para>Le template pour afficher le r<>sultat de la base de donn<6E>es dans un tableau HTML</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{*
|
||||
Affiche le r<>sultat de la base de donn<6E>es dans un tableau
|
||||
*}
|
||||
<table>
|
||||
<tr><th> </th><th>Name></th><th>Home</th><th>Cell</th><th>Email</th></tr>
|
||||
{section name=co loop=$contacts}
|
||||
@@ -410,61 +465,43 @@ Affiche le r
|
||||
<td>{$contacts[co].cell}</td>
|
||||
<td>{$contacts[co].email}</td>
|
||||
<tr>
|
||||
{sectionelse}
|
||||
<tr><td colspan="5">Aucun <20>l<EFBFBD>ment n'a <20>t<EFBFBD> trouv<75></td></tr>
|
||||
{/section}
|
||||
</table>
|
||||
]]>
|
||||
</programlisting>
|
||||
|
||||
<example>
|
||||
<title>{sectionelse}</title>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{* sectionelse est ex<65>cut<75> s'il n'existe aucune valeur dans idClient *}
|
||||
{section name=client loop=$idClient}
|
||||
id: {$idClient[client]}<br />
|
||||
{sectionelse}
|
||||
Aucune valeur dans $idClient.
|
||||
{/section}
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
<para>
|
||||
Les sections ont leur propre variable de gestion des propri<72>t<EFBFBD>s.
|
||||
Elles sont de la forme:
|
||||
<link linkend="language.variables.smarty.loops">{$smarty.section.sectionname.varname}</link>
|
||||
</para>
|
||||
<para>
|
||||
Depuis Smarty 1.5.0, la syntaxe pour les propri<72>t<EFBFBD>s des sections
|
||||
a <20>t<EFBFBD> chang<6E>e de {%sectionname.varname%} <20>
|
||||
{$smarty.section.nomSection.nomVariable}. L'ancienne syntaxe est toujours
|
||||
support<72>e, mais vous ne verrez que des exemples avec la nouvelle syntaxe
|
||||
dans le manuel.
|
||||
</para>
|
||||
|
||||
|
||||
<sect2 id="section.property.index">
|
||||
<title>index</title>
|
||||
<title>.index</title>
|
||||
<para>
|
||||
Index est utilis<69> pour afficher l'index de parcours courant, commence par
|
||||
0 (ou l'attribut start s'il est fourni), et s'incr<63>mente de 1 (ou de la valeur
|
||||
de l'attribut step s'il est fourni).
|
||||
<parameter>index</parameter> contient l'index courant du tableau, en commen<65>ant par z<>ro ou par
|
||||
<parameter>start</parameter> s'il est fourni. Il s'incr<63>mente d'un en un ou de
|
||||
<parameter>step</parameter> s'il est fourni.
|
||||
</para>
|
||||
<note>
|
||||
<title>Note technique</title>
|
||||
<para>
|
||||
Si les attributs step et start ne sont pas modifi<66>s, alors index
|
||||
fonctionne de la m<>me fa<EFBFBD>on que <link
|
||||
linkend="section.property.iteration">iteration</link>, <20> l'exception qu'il commence
|
||||
par 0 plut<75>t que par 1.
|
||||
Si les propri<EFBFBD>t<EFBFBD>s <parameter>step</parameter> et <parameter>start</parameter>
|
||||
ne sont pas modifi<66>s, alors le fonctionnement est le m<>me que celui de la propri<72>t<EFBFBD>
|
||||
<link linkend="section.property.iteration"><parameter>iteration</parameter></link>,
|
||||
mise <20> part qu'il commence <20> z<>ro au lieu de un.
|
||||
</para>
|
||||
</note>
|
||||
<example>
|
||||
<title>propri<EFBFBD>t<EFBFBD> de {section} index</title>
|
||||
<title>Exemple avec la propri<72>t<EFBFBD> <varname>index</varname></title>
|
||||
<para>
|
||||
<note><title>FYI</title>
|
||||
<para><literal>$custid[customer.index]</literal> et
|
||||
<literal>$custid[customer]</literal> sont identiques.</para>
|
||||
</note>
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{* FYI, $custid[customer.index] et $custid[customer] sont identiques *}
|
||||
|
||||
{section name=client loop=$idClient}
|
||||
{$smarty.section.client.index} id: {$idClient[client]}<br />
|
||||
{section name=customer loop=$custid}
|
||||
{$smarty.section.customer.index} id: {$custid[customer]}<br />
|
||||
{/section}
|
||||
]]>
|
||||
</programlisting>
|
||||
@@ -481,56 +518,56 @@ Affiche le r
|
||||
</example>
|
||||
</sect2>
|
||||
|
||||
|
||||
<sect2 id="section.property.index.prev">
|
||||
<title>index_prev</title>
|
||||
<title>.index_prev</title>
|
||||
<para>
|
||||
index_prev est utilis<69> pour afficher l'index de parcours
|
||||
pr<EFBFBD>c<EFBFBD>dent de la boucle. Au premier passage, il vaut -1.
|
||||
<parameter>index_prev</parameter> est l'index de la boucle pr<70>c<EFBFBD>dente.
|
||||
Lors de la premi<6D>re boucle, il vaut -1.
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
<sect2 id="section.property.index.next">
|
||||
<title>index_next</title>
|
||||
<title>.index_next</title>
|
||||
<para>
|
||||
index_next est utilis<69> pour afficher la valeur th<74>orique suivante de
|
||||
index. Dans la derni<6E>re boucle, cel<65> reste la valeur incr<63>ment<6E>e,
|
||||
qui respecte l'attribut step si donn<6E>.
|
||||
<parameter>index_next</parameter> est l'index de la prochaine boucle.
|
||||
Lors de la prochaine boucle, il vaudra un de moins que l'index courant, suivant
|
||||
la configuration de l'attribut <parameter>step</parameter>, s'il est fourni.
|
||||
</para>
|
||||
|
||||
<example>
|
||||
<title>propri<EFBFBD>t<EFBFBD> de {section} index_next et index_prev</title>
|
||||
<title>Exemple avec les propri<72>t<EFBFBD>s <varname>index</varname>, <varname>index_next</varname>
|
||||
et <varname>index_prev</varname></title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
|
||||
$data = array(1001,1002,1003,1004,1005);
|
||||
$smarty->assign('custid',$data);
|
||||
|
||||
$smarty->assign('rows',$data);
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>Le template pour afficher le tableau ci-dessus dans un tableau HTML</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{* FYI, $custid[cus.index] et $custid[cus] sont identiques *}
|
||||
|
||||
{* $rows[row.index] et $rows[row] sont identiques *}
|
||||
<table>
|
||||
<tr>
|
||||
<th>index</th><th>id</th>
|
||||
<th>index_prev</th><th>prev_id</th>
|
||||
<th>index_next</th><th>next_id</th>
|
||||
</tr>
|
||||
{section name=cus loop=$custid}
|
||||
{section name=row loop=$rows}
|
||||
<tr>
|
||||
<td>{$smarty.section.cus.index}</td><td>{$custid[cus]}</td>
|
||||
<td>{$smarty.section.cus.index_prev}</td><td>{$custid[cus.index_prev]}</td>
|
||||
<td>{$smarty.section.cus.index_next}</td><td>{$custid[cus.index_next]}</td>
|
||||
<td>{$smarty.section.row.index}</td><td>{$rows[row]}</td>
|
||||
<td>{$smarty.section.row.index_prev}</td><td>{$rows[row.index_prev]}</td>
|
||||
<td>{$smarty.section.row.index_next}</td><td>{$rows[row.index_next]}</td>
|
||||
</tr>
|
||||
{/section}
|
||||
</table>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
L'exemple ci-dessus affichera :
|
||||
L'exemple ci-dessus affichera un tableau HTML contenant :
|
||||
</para>
|
||||
<screen>
|
||||
<![CDATA[
|
||||
@@ -545,35 +582,40 @@ index id index_prev prev_id index_next next_id
|
||||
</example>
|
||||
</sect2>
|
||||
|
||||
|
||||
<sect2 id="section.property.iteration">
|
||||
<title>iteration</title>
|
||||
<title>.iteration</title>
|
||||
<para>
|
||||
iteration est utilis<69> pour afficher la valeur courante de l'iteration.
|
||||
<parameter>iteration</parameter> contient l'it<69>ration courante de la boucle et commence <20> un.
|
||||
</para>
|
||||
<note>
|
||||
<para>
|
||||
NOTE: Cette valeur n'est pas affect<63>e par les attributs start, step et
|
||||
max, <20> l'inverse de la propri<72>t<EFBFBD> <link linkend="section.property.index">index</link>.
|
||||
L'it<69>ration commence par
|
||||
1 et non par 0 (comme le fait index). <link
|
||||
linkend="section.property.rownum">rownum</link> est un alias de iteration,
|
||||
ils fonctionnent de la m<>me fa<66>on.
|
||||
Ceci n'est pas affect<63> par les propri<EFBFBD>t<EFBFBD>s <varname>{section}</varname>
|
||||
<parameter>start</parameter>, <parameter>step</parameter> et
|
||||
<parameter>max</parameter> contrairement <20> la propri<72>t<EFBFBD>
|
||||
<link linkend="section.property.index"><parameter>index</parameter></link>.
|
||||
<parameter>iteration</parameter> commence <20>galement <20> un au lieu de z<>ro
|
||||
contrairement <20> <parameter>index</parameter>.
|
||||
<link linkend="section.property.rownum"><parameter>rownum</parameter></link>
|
||||
est un alias de <parameter>iteration</parameter>, ils sont identiques.
|
||||
</para>
|
||||
</note>
|
||||
<example>
|
||||
<title>propri<EFBFBD>t<EFBFBD> iteration de {section}</title>
|
||||
<title>Exemple avec la propri<72>t<EFBFBD> <varname>iteration</varname></title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
|
||||
// Tableau de 3000 <20> 3015
|
||||
// array of 3000 to 3015
|
||||
$id = range(3000,3015);
|
||||
$smarty->assign('custid',$id);
|
||||
|
||||
$smarty->assign('arr',$id);
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>Le template pour afficher tous les autres <20>l<EFBFBD>ments du tableau <literal>$arr</literal> comme
|
||||
<literal>step=2</literal></para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{section name=cu loop=$custid start=5 step=2}
|
||||
{section name=cu loop=$arr start=5 step=2}
|
||||
iteration={$smarty.section.cu.iteration}
|
||||
index={$smarty.section.cu.index}
|
||||
id={$custid[cu]}<br />
|
||||
@@ -594,10 +636,11 @@ iteration=6 index=15 id=3015<br />
|
||||
]]>
|
||||
</screen>
|
||||
<para>
|
||||
Cet exemple utilise la propri<72>t<EFBFBD> iteration pour afficher
|
||||
un block d'en-t<>te de tableau toutes les cinq lignes
|
||||
(utilisez <link linkend="language.function.if">{if}</link>
|
||||
avec l'op<6F>rateur mod).
|
||||
Un autre exemple d'utilisation de la propri<72>t<EFBFBD>
|
||||
<parameter>iteration</parameter> est d'afficher un bloc d'en-t<>te d'un tableau toutes
|
||||
les 5 lignes.
|
||||
Utilisez la fonction <link linkend="language.function.if"><varname>{if}</varname></link>
|
||||
avec l'op<6F>rateur mod.
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
@@ -620,25 +663,29 @@ iteration=6 index=15 id=3015<br />
|
||||
</example>
|
||||
</sect2>
|
||||
|
||||
|
||||
<sect2 id="section.property.first">
|
||||
<title>first</title>
|
||||
<title>.first</title>
|
||||
<para>
|
||||
first est <20> true lorsque la section est parcouru pour la premi<6D>re fois.
|
||||
<parameter>first</parameter> est d<>fini <20> &true; si l'it<69>ration courante de
|
||||
<varname>{section}</varname> est l'initiale.
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
|
||||
<sect2 id="section.property.last">
|
||||
<title>last</title>
|
||||
<title>.last</title>
|
||||
<para>
|
||||
last est <20> true lorsque la section est parcourue pour la derni<6E>re fois.
|
||||
<parameter>last</parameter> est d<>fini <20> &true;
|
||||
si l'it<69>ration courante de la section est la derni<6E>re.
|
||||
</para>
|
||||
<example>
|
||||
<title>Propri<EFBFBD>t<EFBFBD> last et first de {section}</title>
|
||||
<title>Exemple avec les propri<72>t<EFBFBD>s <varname>first</varname> et <varname>last</varname></title>
|
||||
<para>
|
||||
Cet exemple boucle le tableau $customers ;
|
||||
affiche un block d'en-t<>te lors de la premi<6D>re it<69>ration et,
|
||||
<20> la derni<6E>re, affiche un block de pied de page
|
||||
(utilisation de la propri<72>t<EFBFBD> <link linkend="section.property.total">total</link>)
|
||||
Cet exemple boucle sur le tableau <varname>$customers</varname>,
|
||||
affiche un bloc d'en-t<>te lors de la premi<6D>re it<69>ration et, lors de la derni<6E>re,
|
||||
affiche un bloc de pied de page. Utilise aussi la propri<72>t<EFBFBD>
|
||||
<link linkend="section.property.total"><parameter>total</parameter></link>.
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
@@ -663,31 +710,31 @@ iteration=6 index=15 id=3015<br />
|
||||
</example>
|
||||
</sect2>
|
||||
|
||||
|
||||
<sect2 id="section.property.rownum">
|
||||
<title>rownum</title>
|
||||
<title>.rownum</title>
|
||||
<para>
|
||||
rownum, utilis<69> pour afficher la valeur courante de l'it<69>ration,
|
||||
commence par 1. C'est un alias de <link
|
||||
linkend="section.property.iteration">iteration</link>, ils fonctionnent de fa<66>on
|
||||
identique.
|
||||
<parameter>rownum</parameter> contient l'it<69>ration courante de la boucle,
|
||||
commen<EFBFBD>ant <20> un. C'est un alias de <link
|
||||
linkend="section.property.iteration"><parameter>iteration</parameter></link>,
|
||||
ils fonctionnent exactement de la m<>me fa<66>on.
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
<sect2 id="section.property.loop">
|
||||
<title>loop</title>
|
||||
<title>.loop</title>
|
||||
<para>
|
||||
loop est utilis<69> pour afficher la derni<EFBFBD>re valeur de index que cette
|
||||
section a utilis<69>. Peut <20>tre utilis<69> dans ou en dehors de la section.
|
||||
<parameter>loop</parameter> contient le dernier index de la boucle de la section.
|
||||
Il peut <20>tre utilis<69> dans ou apr<EFBFBD>s la <varname>{section}</varname>.
|
||||
</para>
|
||||
<example>
|
||||
<title>Propri<EFBFBD>t<EFBFBD> de {section} index</title>
|
||||
<title>Exemple avec la propri<72>t<EFBFBD> <varname>loop</varname></title>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{section name=client loop=$idClient}
|
||||
{$smarty.section.client.index} id: {$idClient[client]}<br />
|
||||
{section name=customer loop=$custid}
|
||||
{$smarty.section.customer.index} id: {$custid[customer]}<br />
|
||||
{/section}
|
||||
|
||||
Il y eu {$smarty.section.client.loop} clients d'affich<63>s.
|
||||
There are {$smarty.section.customer.loop} customers shown above.
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
@@ -698,37 +745,33 @@ Il y eu {$smarty.section.client.loop} clients d'affich
|
||||
0 id: 1000<br />
|
||||
1 id: 1001<br />
|
||||
2 id: 1002<br />
|
||||
|
||||
Il y eu 3 clients d'affich<63>s.
|
||||
There are 3 customers shown above.
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
</sect2>
|
||||
|
||||
<sect2 id="section.property.show">
|
||||
<title>show</title>
|
||||
<title>.show</title>
|
||||
<para>
|
||||
<emphasis>show</emphasis> est utilis<69> comme param<61>tre de section.
|
||||
<emphasis>show</emphasis> est une valeur bool<6F>enne, true ou false.
|
||||
Si show est <20> "false", la section ne sera pas affich<63>e. Si un
|
||||
{sectionelse} est pr<70>sent, elle sera affich<63>e.
|
||||
<parameter>show</parameter> est utilis<69> en tant que param<61>tre <EFBFBD> la section et est une valeur bool<6F>enne.
|
||||
S'il vaut &false;, la section ne sera pas affich<63>e. S'il y a un
|
||||
<varname>{sectionelse}</varname>, il sera affich<63> de fa<66>on alternative.
|
||||
</para>
|
||||
<example>
|
||||
<title>{section}, attribut show</title>
|
||||
<title>Exemple avec la propri<72>t<EFBFBD> <varname>show</varname></title>
|
||||
<para>Une valeur bool<6F>enne <varname>$show_customer_info</varname> est pass<73>e
|
||||
depuis l'application PHP, pour r<>guler l'affichage ou non de cette section.</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{*
|
||||
$show_client_info a pu <20>tre pass<73> par le script PHP,
|
||||
pour d<>terminer si oui ou non on souhaite afficher la section
|
||||
*}
|
||||
{section name=client loop=$idClient show=$show_client_info}
|
||||
{$smarty.section.client.rownum} id: {$idClient[client]}<br />
|
||||
{section name=customer loop=$customers show=$show_customer_info}
|
||||
{$smarty.section.customer.rownum} id: {$customers[customer]}<br />
|
||||
{/section}
|
||||
|
||||
{if $smarty.section.client.show}
|
||||
la section a <20>t<EFBFBD> affich<63>e.
|
||||
{if $smarty.section.customer.show}
|
||||
the section was shown.
|
||||
{else}
|
||||
la section n'a pas <20>t<EFBFBD> affich<63>e.
|
||||
the section was not shown.
|
||||
{/if}
|
||||
]]>
|
||||
</programlisting>
|
||||
@@ -741,46 +784,34 @@ Il y eu 3 clients d'affich
|
||||
2 id: 1001<br />
|
||||
3 id: 1002<br />
|
||||
|
||||
la section a <20>t<EFBFBD> affich<63>e.
|
||||
the section was shown.
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
</sect2>
|
||||
|
||||
<sect2 id="section.property.total">
|
||||
<title>total</title>
|
||||
<title>.total</title>
|
||||
<para>
|
||||
<literal>total</literal> est utilis<69> pour afficher le nombre d'it<69>ration que la section
|
||||
va ex<65>cuter. Peut <20>tre utilis<69> dans ou en dehors de la section.
|
||||
<parameter>total</parameter> contient le nombre d'it<69>rations que cette
|
||||
<varname>{section}</varname> bouclera. Il peut <20>tre utilis<69> dans ou apr<EFBFBD>s une
|
||||
<varname>{section}</varname>.
|
||||
</para>
|
||||
<example>
|
||||
<title>{section}, propri<72>t<EFBFBD> <literal>total</literal></title>
|
||||
<title>Exemple avec la propri<72>t<EFBFBD> <varname>total</varname></title>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{section name=client loop=$idClient step=2}
|
||||
{$smarty.section.client.index} id: {$idClient[client]}<br />
|
||||
{section name=customer loop=$custid step=2}
|
||||
{$smarty.section.customer.index} id: {$custid[customer]}<br />
|
||||
{/section}
|
||||
|
||||
Il y eu {$smarty.section.client.total} clients affich<63>s.
|
||||
There are {$smarty.section.customer.total} customers shown above.
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
L'exemple ci-dessus affichera :
|
||||
</para>
|
||||
<screen>
|
||||
<![CDATA[
|
||||
0 id: 1000<br />
|
||||
2 id: 1001<br />
|
||||
4 id: 1002<br />
|
||||
|
||||
Il y eu 3 clients affich<63>s.
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
<para>
|
||||
Voir aussi
|
||||
<link linkend="language.function.foreach">{foreach}</link> et
|
||||
<link linkend="language.variables.smarty.loops">$smarty.section</link>.
|
||||
<link linkend="language.function.foreach"><varname>{foreach}</varname></link> et
|
||||
<link linkend="language.variables.smarty.loops"><parameter>$smarty.section</parameter></link>.
|
||||
</para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
Reference in New Issue
Block a user