Manuel Smarty

Niveau superieur
Sommaire

{foreach},{foreachelse}

{foreach} est utilisé pour parcourir un simple tableau associatif, contrairement à {section} qui effectue une boucle sur les tableaux de données. La synthaxe pour {foreach} est plus simple que {section}, mais ne peut être utilisé que pour des tableau simple. Chaque {foreach} doit aller de paire avec une balise fermante {/foreach}.

Nom attribut Type Requis Defaut Description
from tableau oui n/a Le tableau à parcourir
item chaîne de caractère Oui n/a Le nom de la variable "élément courant"
key chaîne de caractère Non n/a Le nom de la variable représentant la clef courante.
name chaîne de caractère Non n/a Le nom de la boucle foreach, qui nous permettra d'accéder à ses propriétés.

  • Required attributes are from and item.

  • The name of the {foreach} loop can be anything you like, made up of letters, numbers and underscores, like PHP variables.

  • {foreach} loops can be nested, and the nested {foreach} names must be unique from each other.

  • The from attribute, usually an array of values, determines the number of times {foreach} will loop.

  • {foreachelse} is executed when there are no values in the from variable.

  • {foreach} loops also have their own variables that handle properties. These are accessed with: {$smarty.foreach.name.property} with << name >> being the name attribute.

    Note : The name attribute is only required when you want to access a {foreach} property, unlike {section}. Accessing a {foreach} property with name undefined does not throw an error, but leads to unpredictable results instead.

  • {foreach} properties are index, iteration, first, last, show, total.

Exemple 7-5. L'attribut item

  1. <?php
  2. $arr = array(1000, 1001, 1002);  
  3. $smarty->assign('myArray', $arr);  
  4. ?> 

Template pour afficher $myArray dans une liste non-ordonnée.

<ul>
 {foreach from=$myArray item=foo}
 <li>{$foo}</li>
 {/foreach}
</ul>

L'exemple ci-dessus affichera :

<ul>
 <li>1000</li>
 <li>1001</li>
 <li>1002</li>
</ul>

Exemple 7-6. Utilisation des attributs item et key

  1. <?php
  2. $arr = array(9 => 'Tennis', 3 => 'Natation', 8 => 'Programmation');  
  3. $smarty->assign('myArray', $arr);  
  4. ?> 

Le template affiche le tableau $myArray comme paire clé/valeur, comme la fonction PHP foreach.

<ul>
 {foreach from=$myArray key=k item=v}
 <li>{$k}: {$v}</li>
 {/foreach}
</ul>

L'exemple ci-dessus affichera :

<ul>
 <li>9: Tennis</li>
 <li>3: Natation</li>
 <li>8: Programmation</li>
</ul>

Exemple 7-7. {foreach} avec un attribut associatif item

  1. <?php
  2. $items_list = array(23 => array('no' => 2456, 'label' => 'Salad'), 
  3.    96 => array('no' => 4889, 'label' => 'Cream')  
  4. );  
  5. $smarty->assign('items', $items_list);  
  6. ?> 

Le template affiche $items avec $myId dans l'URL.

<ul>
 {foreach from=$items key=myId item=i}
 <li><a href="item.php?id={$myId}">{$i.no}: {$i.label}</li>
  {/foreach}
 </ul>

L'exemple ci-dessus affichera :

<ul>
<li><a href="item.php?id=23">2456: Salad</li>
<li><a href="item.php?id=96">4889: Cream</li>
</ul>

Exemple 7-8. {foreach} avec item et key

Assigne un tableau à Smarty, la clé contient la clé pour chaque valeur de la boucle.

  1. <?php
  2. $smarty->assign('contacts', array(  
  3. array('phone' => '1', 
  4.       'fax' => '2', 
  5.       'cell' => '3'), 
  6.       array('phone' => '555-4444', 
  7.       'fax' => '555-3333', 
  8.       'cell' => '760-1234')  
  9. ));  
  10. ?> 

Le template affiche $contact.

{foreach name=outer item=contact from=$contacts}
    <hr />
    {foreach key=key item=item from=$contact}
        {$key}: {$item}<br />
    {/foreach}
{/foreach}

L'exemple ci-dessus affichera :

<hr />
phone: 1<br />
fax: 2<br />
cell: 3<br />
<hr />
phone: 555-4444<br />
fax: 555-3333<br />
cell: 760-1234<br />

Exemple 7-9. Exemple d'une base de données avec {foreachelse}

Exemple d'un script de recherche dans une base de données (e.g. PEAR ou ADODB), le résultat de la requête est assigné à Smarty.

  1. <?php
  2. $search_condition = "where name like '$foo%'";  
  3. $sql = 'select contact_id, name, nick from contacts '.$search_condition.' order by name';  
  4. $smarty->assign('results', $db->getAssoc($sql) );  
  5. ?> 

Le template qui affiche << None found >> si aucun résultat avec {foreachelse}.

{foreach key=cid item=con from=$results}
<a href="contact.php?contact_id={$cid}">{$con.name} - {$con.nick}</a><br />
{foreachelse}
Aucun élément n'a été trouvé dans la recherche
{/foreach}

.index

index contient l'index courant du tableau, en commançant par zéro.

Exemple 7-10. Exemple avec index

  1. {* L'en-tête du block est affiché toutes les 5 lignes *}
  2. <table>
  3. {foreach from=$items key=myId item=i name=foo}
  4. {if $smarty.foreach.foo.index % 5 == 0}
  5. <tr><th>Title</th></tr>
  6. {/if}
  7. <tr><td>{$i.label}</td></tr>
  8. {/foreach}
  9. </table> 

.iteration

iteration contient l'itération courante de la boucle et commence toujours à 1, contrairement à index. Il est incrémenté d'un, à chaque itération.

Exemple 7-11. Exemple avec iteration et index

  1. {* this will output 0|1, 1|2, 2|3, ... etc *}
  2. {foreach from=$myArray item=i name=foo}
  3. {$smarty.foreach.foo.index}|{$smarty.foreach.foo.iteration},
  4. {/foreach} 

.first

first vaut TRUE si l'itération courante de {foreach} est l'initial.

Exemple 7-12. Exemple avec first

  1. {* affiche LATEST sur le premier élément, sinon, l'id *}
  2. <table>
  3. {foreach from=$items key=myId item=i name=foo}
  4. <tr>
  5. <td>{if $smarty.foreach.foo.first}LATEST{else}{$myId}{/if}</td>
  6. <td>{$i.label}</td>
  7. </tr>
  8. {/foreach}
  9. </table> 

.last

last est défini à TRUE si l'itération courante de {foreach} est la dernière.

Exemple 7-13. Exemple avec last

  1. {* Ajout une barre horizontale à la fin de la liste *}
  2. {foreach from=$items key=part_id item=prod name=products}
  3. <a href="#{$par.php">{$prod}</a>{if $smarty.foreach.products.last}<hr>{else},{/if}
  4. {foreachelse}
  5. ... contenu ...
  6. {/foreach} 

.show

show est utilisé en tant que paramètre à {foreach}. show est une valeur booléenne. S'il vaut FALSE, {foreach} ne sera pas affiché. S'il y a un {foreachelse}, il sera affiché alternativement.

.total

total contient le nombre d'itérations que cette boucle {foreach} effectuera. Il peut être utilisé dans ou après un {foreach}.

Exemple 7-14. Exemple avec total

  1. {* affiche les lignes retournées à la fin *}
  2. {foreach from=$items key=part_id item=prod name=foo}
  3. {$prod.name>
  4. {if $smarty.foreach.foo.last}
  5. <div id="total">{$smarty.foreach.foo.total} items</div>
  6. {/if}
  7. {foreachelse}
  8. ... quelque chose d'autre ...
  9. {/foreach} 

Voir aussi {section} et $smarty.foreach.

Niveau superieur
Sommaire

Remonter Remonter
L'éditeur javascript - CSS - Gentoo - Tutoriaux PHP - Tutoriels PHP - Bretagne - php - Moto