mirror of
https://github.com/smarty-php/smarty.git
synced 2025-08-06 11:24:27 +02:00
sync with EN
This commit is contained in:
@@ -1,26 +1,28 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 1.13 Maintainer: gerald Status: ready -->
|
||||
<!-- EN-Revision: 1.14 Maintainer: gerald Status: ready -->
|
||||
|
||||
<sect1 id="language.function.capture">
|
||||
<title>{capture}</title>
|
||||
|
||||
<para>
|
||||
{capture} est utilis<69> pour r<>cup<75>rer la sortie d'<27>l<EFBFBD>ments dans une variable
|
||||
au lieu de les afficher. Tout contenu situ<74> entre {capture
|
||||
name='foo'} et {/capture} est intercept<EFBFBD> dans une variable dont le nom est
|
||||
sp<73>cifi<66> dans l'attribut name.
|
||||
<varname>{capture}</varname> est utilis<69> pour r<>cup<75>rer la sortie d'<27>l<EFBFBD>ments dans
|
||||
une variable au lieu de les afficher. Tout contenu situ<74> entre
|
||||
<varname>{capture name='foo'}</varname> et <varname>{/capture}</varname>
|
||||
est intercept<70> dans une variable dont le nom est sp<EFBFBD>cifi<EFBFBD> dans l'attribut
|
||||
<parameter>name</parameter>.
|
||||
</para>
|
||||
<para>
|
||||
Le contenu captur<75> peut <20>tre utilis<69> dans
|
||||
le template par l'interm<72>diaire de la variable sp<73>ciale
|
||||
<link linkend="language.variables.smarty.capture">$smarty.capture.foo</link>
|
||||
o<> "foo" est la valeur de l'attribut name. Si vous ne donnez pas de valeur
|
||||
<EFBFBD> l'attribut name, alors "default" est utilis<69> en tant que nom, i.e.
|
||||
$smarty.capture.default.
|
||||
<link linkend="language.variables.smarty.capture"><parameter>$smarty.capture.foo</parameter></link>
|
||||
o<> <quote>foo</quote> est la valeur de l'attribut <parameter>name</parameter>.
|
||||
Si vous ne donnez pas de valeur <20> l'attribut <parameter>name</parameter>, alors
|
||||
<quote>default</quote> est utilis<69> en tant que nom, i.e.
|
||||
<parameter>$smarty.capture.default</parameter>.
|
||||
</para>
|
||||
<para>
|
||||
{capture} peut <20>tre imbriqu<71>.
|
||||
<varname>{capture}</varname> peut <20>tre imbriqu<71>.
|
||||
</para>
|
||||
|
||||
<informaltable frame="all">
|
||||
@@ -59,11 +61,11 @@
|
||||
</informaltable>
|
||||
<caution>
|
||||
<para>
|
||||
Fa<46>tes attention lorsque vous interceptez la sortie de commandes <link
|
||||
linkend="language.function.insert">{insert}</link>.
|
||||
Fa<46>tes attention lorsque vous interceptez la sortie de commandes
|
||||
<link linkend="language.function.insert"><varname>{insert}</varname></link>.
|
||||
Si vous avez configur<75> le <link linkend="caching">cache</link> pour que ce
|
||||
dernier soit actif, et que vous avez des commandes <link
|
||||
linkend="language.function.insert">{insert}</link>
|
||||
linkend="language.function.insert"><varname>{insert}</varname></link>
|
||||
suppos<6F>es s'ex<65>cuter dans un contenu en cache, ne tentez pas de capturer
|
||||
ce contenu.
|
||||
</para>
|
||||
@@ -87,7 +89,7 @@
|
||||
<example>
|
||||
<title>{capture} dans une variable de template</title>
|
||||
<para>Cet exemple d<>montre <20>galement la fonction
|
||||
<link linkend="language.function.popup">{popup}</link>
|
||||
<link linkend="language.function.popup"><varname>{popup}</varname></link>
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
@@ -103,12 +105,11 @@ Votre IP est {$smarty.server.REMOTE_ADDR}.
|
||||
</para>
|
||||
<para>
|
||||
Voir aussi
|
||||
<link
|
||||
linkend="language.variables.smarty.capture">$smarty.capture</link>,
|
||||
<link linkend="language.function.eval">{eval}</link>,
|
||||
<link linkend="language.function.fetch">{fetch}</link>,
|
||||
<link linkend="api.fetch">fetch()</link> et
|
||||
<link linkend="language.function.assign">{assign}</link>.
|
||||
<link linkend="language.variables.smarty.capture"><parameter>$smarty.capture</parameter></link>,
|
||||
<link linkend="language.function.eval"><varname>{eval}</varname></link>,
|
||||
<link linkend="language.function.fetch"><varname>{fetch}</varname></link>,
|
||||
<link linkend="api.fetch"><varname>fetch()</varname></link> et
|
||||
<link linkend="language.function.assign"><varname>{assign}</varname></link>.
|
||||
</para>
|
||||
</sect1>
|
||||
|
||||
|
@@ -1,13 +1,13 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 1.11 Maintainer: gerald Status: ready -->
|
||||
<!-- EN-Revision: 1.12 Maintainer: gerald Status: ready -->
|
||||
|
||||
<sect1 id="language.function.config.load">
|
||||
<title>{config_load}</title>
|
||||
|
||||
<para>
|
||||
{config_load} est utilise<73> pour charger des variables
|
||||
<link linkend="language.config.variables">#variables#</link>
|
||||
<varname>{config_load}</varname> est utilise<73> pour charger des variables
|
||||
<link linkend="language.config.variables"><parameter>#variables#</parameter></link>
|
||||
depuis un <link linkend="config.files">fichier de configuration</link>
|
||||
dans un template.
|
||||
</para>
|
||||
@@ -75,9 +75,9 @@
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
<example>
|
||||
<title>fonction {config_load}</title>
|
||||
<title>Fonction {config_load}</title>
|
||||
<para>
|
||||
example.conf
|
||||
Le fichier <filename>example.conf</filename>
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
@@ -117,13 +117,13 @@ pageTitle = "Info personnalis
|
||||
<para>
|
||||
Les <link linkend="config.files">fichiers de configuration</link> peuvent contenir des sections.
|
||||
Vous pouvez charger des variables d'une section donn<6E>e avec le
|
||||
nouvel attribut <emphasis>'section'</emphasis>.
|
||||
nouvel attribut <parameter>section</parameter>.
|
||||
</para>
|
||||
<note>
|
||||
<para>
|
||||
Les <emphasis>sections des fichiers de configuration</emphasis>
|
||||
et la fonction native
|
||||
<link linkend="language.function.section"><emphasis>{section}</emphasis></link>
|
||||
Les <emphasis>sections</emphasis> des fichiers de configuration
|
||||
et la fonction native
|
||||
<link linkend="language.function.section"><varname>{section}</varname></link>
|
||||
n'ont rien en commun, il s'av<61>re simplement qu'elles portent le m<>me nom.
|
||||
</para>
|
||||
</note>
|
||||
@@ -150,17 +150,17 @@ pageTitle = "Info personnalis
|
||||
</example>
|
||||
|
||||
<para>
|
||||
Voir aussi <link linkend="variable.config.overwrite">$config_overwrite</link>
|
||||
Voir aussi <link linkend="variable.config.overwrite"><parameter>$config_overwrite</parameter></link>
|
||||
pour les tableaux de variables de configuration.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Voir aussi
|
||||
<link linkend="config.files">les fichiers de configuration</link>,
|
||||
<link linkend="language.config.variables">les variables de configuration</link>,
|
||||
<link linkend="variable.config.dir">$config_dir</link>,
|
||||
<link linkend="api.get.config.vars">get_config_vars()</link> et
|
||||
<link linkend="api.config.load">config_load()</link>.
|
||||
les <link linkend="config.files">fichiers de configuration</link>,
|
||||
les <link linkend="language.config.variables">variables de configuration</link>,
|
||||
<link linkend="variable.config.dir"><parameter>$config_dir</parameter></link>,
|
||||
<link linkend="api.get.config.vars"><varname>get_config_vars()</varname></link> et
|
||||
<link linkend="api.config.load"><varname>config_load()</varname></link>.
|
||||
</para>
|
||||
</sect1>
|
||||
|
||||
|
@@ -1,31 +1,22 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 1.8 Maintainer: gerald Status: ready -->
|
||||
<!-- EN-Revision: 1.11 Maintainer: gerald Status: ready -->
|
||||
|
||||
<sect1 id="language.function.foreach">
|
||||
<title>{foreach},{foreachelse}</title>
|
||||
|
||||
<para>
|
||||
Les boucles <emphasis>{foreach}</emphasis> sont une alternative aux boucles
|
||||
<link linkend="language.function.section"><emphasis>section</emphasis></link>.
|
||||
Les boucles <emphasis>{foreach}</emphasis>
|
||||
sont utilis<69>es pour parcourir des <emphasis role="bold">tableaux associatifs simples</emphasis>.
|
||||
La syntaxe des boucles <emphasis>{foreach}</emphasis> est bien plus simple
|
||||
que celle des boucles <emphasis>{section}</emphasis>, mais en contrepartie,
|
||||
<emphasis role="bold">elles ne peuvent <20>tre utilis<69>es que pour des tableaux associatifs
|
||||
simples</emphasis>. La balise <emphasis>{foreach}</emphasis> doit toujours <20>tre accompagn<67>e
|
||||
de la balise <emphasis>{/foreach}</emphasis>. Les param<61>tres requis sont
|
||||
<emphasis>from</emphasis> et <emphasis>item</emphasis>. Le nom des boucles
|
||||
{foreach} doit <20>tre compos<6F>s exclusivement de lettres,
|
||||
chiffres et underscores, selon vos pr<70>f<EFBFBD>rences. Les boucles
|
||||
<emphasis>{foreach}</emphasis> peuvent <20>tre imbriqu<71>es.
|
||||
La variable <emphasis>from</emphasis> (g<>n<EFBFBD>ralement le tableau <20>
|
||||
parcourir) d<>termine le nombre de fois que <emphasis>{foreach}</emphasis>
|
||||
sera ex<65>cut<75>. <emphasis>{foreachelse}</emphasis> est ex<65>cut<75> si aucune
|
||||
valeur n'est pr<70>sente dans la variable donn<6E>e <20> l'attribut
|
||||
<emphasis>from</emphasis>.
|
||||
<varname>{foreach}</varname> est utilis<69> pour parcourir un
|
||||
<emphasis role="bold">simple tableau associatif</emphasis>,
|
||||
contrairement <20> <link linkend="language.function.section"><varname>{section}</varname></link>
|
||||
qui effectue une boucle sur les <emphasis role="bold">tableaux de donn<6E>es</emphasis>.
|
||||
La synthaxe pour
|
||||
<varname>{foreach}</varname> est plus simple que
|
||||
<link linkend="language.function.section"><varname>{section}</varname></link>,
|
||||
mais <emphasis role="bold">ne peut <20>tre utilis<69> que pour des tableau simple</emphasis>.
|
||||
Chaque <varname>{foreach}</varname> doit aller de paire avec une balise fermante
|
||||
<varname>{/foreach}</varname>.
|
||||
</para>
|
||||
|
||||
|
||||
<informaltable frame="all">
|
||||
<tgroup cols="5">
|
||||
<colspec colname="param" align="center" />
|
||||
@@ -70,27 +61,89 @@
|
||||
<entry>Non</entry>
|
||||
<entry><emphasis>n/a</emphasis></entry>
|
||||
<entry>Le nom de la boucle foreach, qui nous permettra
|
||||
d'acc<63>der <20> ses propri<72>t<EFBFBD>s.</entry>
|
||||
d'acc<63>der <20> ses propri<72>t<EFBFBD>s.</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
|
||||
|
||||
<itemizedlist>
|
||||
<listitem><para>
|
||||
Required attributes are <parameter>from</parameter> and <parameter>item</parameter>.
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>
|
||||
The <parameter>name</parameter> of the <varname>{foreach}</varname> loop can be anything
|
||||
you like, made up of letters, numbers and underscores, like
|
||||
<ulink url="&url.php-manual;language.variables">PHP variables</ulink>.
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>
|
||||
<varname>{foreach}</varname> loops can be nested, and the nested
|
||||
<varname>{foreach}</varname> names must be unique from each other.
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>
|
||||
The <parameter>from</parameter> attribute, usually an array of values,
|
||||
determines the number of times <varname>{foreach}</varname> will loop.
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>
|
||||
<varname>{foreachelse}</varname> is executed when there are no
|
||||
values in the <parameter>from</parameter> variable.
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>
|
||||
<varname>{foreach}</varname> loops also have their own variables that handle properties.
|
||||
These are accessed with:
|
||||
<link linkend="language.variables.smarty.loops">
|
||||
<parameter>{$smarty.foreach.name.property}</parameter></link> with
|
||||
<quote>name</quote> being the
|
||||
<parameter>name</parameter> attribute.
|
||||
</para>
|
||||
<note>
|
||||
<title>Note</title>
|
||||
<para>The <parameter>name</parameter> attribute is only required when
|
||||
you want to access a <varname>{foreach</varname>} property, unlike
|
||||
<link linkend="language.function.section"><varname>{section}</varname></link>.
|
||||
Accessing a <varname>{foreach}</varname> property with <parameter>name</parameter>
|
||||
undefined does not throw an error, but leads to unpredictable results instead.
|
||||
</para>
|
||||
</note>
|
||||
</listitem>
|
||||
|
||||
<listitem><para>
|
||||
<varname>{foreach}</varname> properties are
|
||||
<link linkend="foreach.property.index"><parameter>index</parameter></link>,
|
||||
<link linkend="foreach.property.iteration"><parameter>iteration</parameter></link>,
|
||||
<link linkend="foreach.property.first"><parameter>first</parameter></link>,
|
||||
<link linkend="foreach.property.last"><parameter>last</parameter></link>,
|
||||
<link linkend="foreach.property.show"><parameter>show</parameter></link>,
|
||||
<link linkend="foreach.property.total"><parameter>total</parameter></link>.
|
||||
</para></listitem>
|
||||
</itemizedlist>
|
||||
|
||||
<example>
|
||||
<title>foreach</title>
|
||||
<title>L'attribut <parameter>item</parameter></title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
$arr = array( 1001,1002,1003);
|
||||
$smarty->assign('custid', $arr);
|
||||
$arr = array(1000, 1001, 1002);
|
||||
$smarty->assign('myArray', $arr);
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Template pour afficher <parameter>$myArray</parameter> dans une liste non-ordonn<6E>e.
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{* Cet exemple affiche toutes les valeurs du tableau $custid *}
|
||||
{foreach from=$custid item=curr_id}
|
||||
id: {$curr_id}<br />
|
||||
{/foreach}
|
||||
<ul>
|
||||
{foreach from=$myArray item=foo}
|
||||
<li>{$foo}</li>
|
||||
{/foreach}
|
||||
</ul>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
@@ -98,38 +151,116 @@ $smarty->assign('custid', $arr);
|
||||
</para>
|
||||
<screen>
|
||||
<![CDATA[
|
||||
id: 1000<br />
|
||||
id: 1001<br />
|
||||
id: 1002<br />
|
||||
<ul>
|
||||
<li>1000</li>
|
||||
<li>1001</li>
|
||||
<li>1002</li>
|
||||
</ul>
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
|
||||
<example>
|
||||
<title>foreach key</title>
|
||||
<title>Utilisation des attributs <parameter>item</parameter> et <parameter>key</parameter></title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
// key contient la clef de chaque <20>l<EFBFBD>ment parcouru
|
||||
// L'assignement ressemble <20> ceci :
|
||||
<?php
|
||||
$smarty->assign('contacts', array(
|
||||
array('phone' => '1',
|
||||
'fax' => '2',
|
||||
'cell' => '3'),
|
||||
array('phone' => '555-4444',
|
||||
'fax' => '555-3333',
|
||||
'cell' => '760-1234'))
|
||||
);
|
||||
$arr = array(9 => 'Tennis', 3 => 'Natation', 8 => 'Programmation');
|
||||
$smarty->assign('myArray', $arr);
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Le template affiche le tableau <parameter>$myArray</parameter> comme paire cl<63>/valeur,
|
||||
comme la fonction PHP
|
||||
<ulink url="&url.php-manual;foreach"><varname>foreach</varname></ulink>.
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
<ul>
|
||||
{foreach from=$myArray key=k item=v}
|
||||
<li>{$k}: {$v}</li>
|
||||
{/foreach}
|
||||
</ul>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
L'exemple ci-dessus affichera :
|
||||
</para>
|
||||
<screen>
|
||||
<![CDATA[
|
||||
<ul>
|
||||
<li>9: Tennis</li>
|
||||
<li>3: Natation</li>
|
||||
<li>8: Programmation</li>
|
||||
</ul>
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
|
||||
<example>
|
||||
<title>{foreach} avec un attribut associatif <parameter>item</parameter></title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
$items_list = array(23 => array('no' => 2456, 'label' => 'Salad'),
|
||||
96 => array('no' => 4889, 'label' => 'Cream')
|
||||
);
|
||||
$smarty->assign('items', $items_list);
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Le template affiche <parameter>$items</parameter> avec
|
||||
<parameter>$myId</parameter> dans l'URL.
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
<ul>
|
||||
{foreach from=$items key=myId item=i}
|
||||
<li><a href="item.php?id={$myId}">{$i.no}: {$i.label}</li>
|
||||
{/foreach}
|
||||
</ul>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
L'exemple ci-dessus affichera :
|
||||
</para>
|
||||
<screen>
|
||||
<![CDATA[
|
||||
<ul>
|
||||
<li><a href="item.php?id=23">2456: Salad</li>
|
||||
<li><a href="item.php?id=96">4889: Cream</li>
|
||||
</ul>
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
|
||||
<example>
|
||||
<title>{foreach} avec <parameter>item</parameter> et <parameter>key</parameter></title>
|
||||
<para>Assigne un tableau <20> Smarty, la cl<63> contient la cl<63> pour chaque valeur de la boucle.</para>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
$smarty->assign('contacts', array(
|
||||
array('phone' => '1',
|
||||
'fax' => '2',
|
||||
'cell' => '3'),
|
||||
array('phone' => '555-4444',
|
||||
'fax' => '555-3333',
|
||||
'cell' => '760-1234')
|
||||
));
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>Le template affiche <parameter>$contact</parameter>.</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{foreach name=outer item=contact from=$contacts}
|
||||
<hr />
|
||||
{foreach key=key item=item from=$contact}
|
||||
{$key}: {$item}<br />
|
||||
{/foreach}
|
||||
<hr />
|
||||
{foreach key=key item=item from=$contact}
|
||||
{$key}: {$item}<br />
|
||||
{/foreach}
|
||||
{/foreach}
|
||||
]]>
|
||||
</programlisting>
|
||||
@@ -139,92 +270,167 @@ $smarty->assign('contacts', array(
|
||||
<screen>
|
||||
<![CDATA[
|
||||
<hr />
|
||||
phone: 1<br />
|
||||
fax: 2<br />
|
||||
cell: 3<br />
|
||||
phone: 1<br />
|
||||
fax: 2<br />
|
||||
cell: 3<br />
|
||||
<hr />
|
||||
phone: 555-4444<br />
|
||||
fax: 555-3333<br />
|
||||
cell: 760-1234<br />
|
||||
phone: 555-4444<br />
|
||||
fax: 555-3333<br />
|
||||
cell: 760-1234<br />
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
|
||||
<example>
|
||||
<title>{foreach} - Exemple avec une base de donn<6E>es (eg PEAR ou ADODB)</title>
|
||||
<title>Exemple d'une base de donn<6E>es avec {foreachelse}</title>
|
||||
<para>Exemple d'un script de recherche dans une base de donn<6E>es (e.g. PEAR ou ADODB),
|
||||
le r<>sultat de la requ<71>te est assign<67> <20> Smarty.</para>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
$sql = 'select contact_id, name, nick from contacts order by contact';
|
||||
$smarty->assign("contacts", $db->getAssoc($sql));
|
||||
$search_condition = "where name like '$foo%' ";
|
||||
$sql = 'select contact_id, name, nick from contacts '.$search_condition.' order by name';
|
||||
$smarty->assign('results', $db->getAssoc($sql) );
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>Le template qui affiche <quote>None found</quote>
|
||||
si aucun r<>sultat avec <varname>{foreachelse}</varname>.</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{foreach key=cid item=con from=$contacts}
|
||||
<a href="contact.php?contact_id={$cid}">{$con.name} - {$con.nick}</a><br />
|
||||
{foreach key=cid item=con from=$results}
|
||||
<a href="contact.php?contact_id={$cid}">{$con.name} - {$con.nick}</a><br />
|
||||
{foreachelse}
|
||||
Aucun <20>l<EFBFBD>ment n'a <20>t<EFBFBD> trouv<75> dans la recherche
|
||||
{/foreach}
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
|
||||
<sect2 id="foreach.property.index">
|
||||
<title>.index</title>
|
||||
<para>
|
||||
<parameter>index</parameter> contient l'index courant du tableau, en comman<61>ant par z<>ro.
|
||||
</para>
|
||||
<example>
|
||||
<title>Exemple avec <parameter>index</parameter></title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
{* L'en-t<>te du block est affich<63> toutes les 5 lignes *}
|
||||
<table>
|
||||
{foreach from=$items key=myId item=i name=foo}
|
||||
{if $smarty.foreach.foo.index % 5 == 0}
|
||||
<tr><th>Title</th></tr>
|
||||
{/if}
|
||||
<tr><td>{$i.label}</td></tr>
|
||||
{/foreach}
|
||||
</table>
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
</sect2>
|
||||
|
||||
<sect2 id="foreach.property.iteration">
|
||||
<title>.iteration</title>
|
||||
<para>
|
||||
<parameter>iteration</parameter> contient l'it<69>ration courante de la boucle et commence
|
||||
toujours <20> 1, contrairement <20>
|
||||
<link linkend="foreach.property.index"><parameter>index</parameter></link>.
|
||||
Il est incr<63>ment<6E> d'un, <20> chaque it<69>ration.
|
||||
</para>
|
||||
<example>
|
||||
<title>Exemple avec <parameter>iteration</parameter> et <parameter>index</parameter></title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
{* this will output 0|1, 1|2, 2|3, ... etc *}
|
||||
{foreach from=$myArray item=i name=foo}
|
||||
{$smarty.foreach.foo.index}|{$smarty.foreach.foo.iteration},
|
||||
{/foreach}
|
||||
]]>
|
||||
</programlisting>
|
||||
|
||||
</example>
|
||||
|
||||
</sect2>
|
||||
<sect2 id="foreach.property.first">
|
||||
<title>.first</title>
|
||||
<para>
|
||||
<parameter>first</parameter> vaut &true; si l'it<69>ration courante de
|
||||
<varname>{foreach}</varname> est l'initial.
|
||||
</para>
|
||||
<example>
|
||||
<title>Exemple avec <parameter>first</parameter></title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
{* affiche LATEST sur le premier <20>l<EFBFBD>ment, sinon, l'id *}
|
||||
<table>
|
||||
{foreach from=$items key=myId item=i name=foo}
|
||||
<tr>
|
||||
<td>{if $smarty.foreach.foo.first}LATEST{else}{$myId}{/if}</td>
|
||||
<td>{$i.label}</td>
|
||||
</tr>
|
||||
{/foreach}
|
||||
</table>
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
</sect2>
|
||||
<sect2 id="foreach.property.last">
|
||||
<title>.last</title>
|
||||
<para>
|
||||
Les boucles {foreach} ont <20>galement leurs propres variables qui g<>rent les propri<72>t<EFBFBD>s
|
||||
de {foreach}. Elles sont indiqu<71>es par :
|
||||
<link linkend="language.variables.smarty.loops">{$smarty.foreach.foreachname.varname}</link>
|
||||
o<> foreachname est le nom sp<73>cifi<66> par l'attribut <emphasis>name</emphasis>
|
||||
de foreach.
|
||||
<parameter>last</parameter> est d<>fini <20> &true; si l'it<69>ration courante de
|
||||
<varname>{foreach}</varname> est la derni<6E>re.
|
||||
</para>
|
||||
|
||||
<para>Voir <link linkend="section.property.index">{section}</link>
|
||||
pour des exemples avec les prori<72>t<EFBFBD>s ci-dessus.
|
||||
<example>
|
||||
<title>Exemple avec <parameter>last</parameter></title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
{* Ajout une barre horizontale <20> la fin de la liste *}
|
||||
{foreach from=$items key=part_id item=prod name=products}
|
||||
<a href="#{$part_id}">{$prod}</a>{if $smarty.foreach.products.last}<hr>{else},{/if}
|
||||
{foreachelse}
|
||||
... contenu ...
|
||||
{/foreach}
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
</sect2>
|
||||
<sect2 id="foreach.property.show">
|
||||
<title>.show</title>
|
||||
<para>
|
||||
<parameter>show</parameter> est utilis<69> en tant que param<61>tre <20> <varname>{foreach}</varname>.
|
||||
<parameter>show</parameter> est une valeur bool<6F>enne. S'il vaut
|
||||
&false;, <varname>{foreach}</varname> ne sera pas affich<63>.
|
||||
S'il y a un <varname>{foreachelse}</varname>, il sera affich<63> alternativement.
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
<sect2 id="foreach.property.iteration">
|
||||
<title>iteration</title>
|
||||
<para>
|
||||
<emphasis>iteration</emphasis> est utilis<69> pour afficher l'it<69>ration de la boucle courante.
|
||||
<emphasis>iteration</emphasis> commence toujours par 1 et est incr<63>ment<6E>
|
||||
<20> chaque it<69>ration.
|
||||
</para>
|
||||
</sect2>
|
||||
<sect2 id="foreach.property.total">
|
||||
<title>.total</title>
|
||||
<para>
|
||||
<parameter>total</parameter> contient le nombre d'it<69>rations que cette boucle
|
||||
<varname>{foreach}</varname> effectuera.
|
||||
Il peut <20>tre utilis<69> dans ou apr<70>s un <varname>{foreach}</varname>.
|
||||
</para>
|
||||
<example>
|
||||
<title>Exemple avec <parameter>total</parameter></title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
{* affiche les lignes retourn<72>es <20> la fin *}
|
||||
{foreach from=$items key=part_id item=prod name=foo}
|
||||
{$prod.name><hr/>
|
||||
{if $smarty.foreach.foo.last}
|
||||
<div id="total">{$smarty.foreach.foo.total} items</div>
|
||||
{/if}
|
||||
{foreachelse}
|
||||
... quelque chose d'autre ...
|
||||
{/foreach}
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
|
||||
<sect2 id="foreach.property.first">
|
||||
<title>first</title>
|
||||
<para>
|
||||
<emphasis>first</emphasis> est d<>fini <20> true si l'it<69>ration courante de foreach est la premi<6D>re.
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
<sect2 id="foreach.property.last">
|
||||
<title>last</title>
|
||||
<para>
|
||||
<emphasis>last</emphasis> est d<>fini <20> true si l'it<69>ration courante de foreach est la derni<6E>re.
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
<sect2 id="foreach.property.show">
|
||||
<title>show</title>
|
||||
<para>
|
||||
<emphasis>show</emphasis> est utilis<69> en tant que param<61>tre de foreach.
|
||||
<emphasis>show</emphasis> est un bool<6F>en (true ou false).
|
||||
S'il vaut false, foreach ne sera pas affich<63>. Si foreachelse est pr<70>sent,
|
||||
il sera affich<63> alternativement.
|
||||
</para>
|
||||
|
||||
</sect2>
|
||||
<sect2 id="foreach.property.total">
|
||||
<title>total</title>
|
||||
<para>
|
||||
<emphasis>total</emphasis> est utilis<69> pour afficher le nombre d'it<69>rations
|
||||
boucl<63>es par ce foreach. Il peut <20>tre utilis<69> dans ou apr<70>s le foreach.
|
||||
</para>
|
||||
<para>
|
||||
Voir aussi
|
||||
<link linkend="language.function.section">{section}</link> et
|
||||
<link linkend="language.variables.smarty.loops">$smarty.foreach</link>.
|
||||
<link linkend="language.function.section"><varname>{section}</varname></link>
|
||||
et <link linkend="language.variables.smarty.loops"><parameter>$smarty.foreach</parameter></link>.
|
||||
</para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
@@ -1,25 +1,25 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready -->
|
||||
<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready -->
|
||||
|
||||
<sect1 id="language.function.if">
|
||||
<title>{if},{elseif},{else}</title>
|
||||
<para>
|
||||
L'instruction <emphasis>{if}</emphasis> dans Smarty dispose de la m<>me flexibilit<69> que l'instruction
|
||||
PHP <ulink url="&url.php-manual;if"><command>if</command></ulink>,
|
||||
L'instruction <varname>{if}</varname> dans Smarty dispose de la m<>me flexibilit<69> que l'instruction
|
||||
PHP <ulink url="&url.php-manual;if">if</ulink>,
|
||||
avec quelques fonctionnalit<69>s suppl<70>mentaires pour le
|
||||
moteur de template. Tous les <emphasis>{if}</emphasis> doivent <20>tre
|
||||
utilis<69>s de pair avec un <emphasis>{/if}</emphasis>.
|
||||
<emphasis>{else}</emphasis> et <emphasis>{elseif}</emphasis> sont <20>galement
|
||||
moteur de template. Tous les <varname>{if}</varname> doivent <20>tre
|
||||
utilis<69>s de pair avec un <varname>{/if}</varname>.
|
||||
<varname>{else}</varname> et <varname>{elseif}</varname> sont <20>galement
|
||||
des balises autoris<69>es. Toutes les conditions et fonctions PHP sont reconnues,
|
||||
comme <emphasis>||</emphasis>, <emphasis>or</emphasis>,
|
||||
<emphasis>&&</emphasis>, <emphasis>and</emphasis>,
|
||||
<emphasis>is_array()</emphasis>, etc.
|
||||
</para>
|
||||
<para>
|
||||
Si <link linkend="variable.security">$security</link> est actif,
|
||||
Si <link linkend="variable.security"><parameter>$security</parameter></link> est actif,
|
||||
alors le tableau <emphasis>IF_FUNCS</emphasis> dans le tableau
|
||||
<link linkend="variable.security.settings">$security_settings</link> (?!).
|
||||
<link linkend="variable.security.settings"><parameter>$security_settings</parameter></link> (?!).
|
||||
</para>
|
||||
<para>
|
||||
La liste suivante pr<70>sente les op<6F>rateurs reconnus, qui doivent <20>tre entour<75>s d'espaces.
|
||||
|
Reference in New Issue
Block a user