smarty/docs/fr/designers/language-custom-functions/language-function-html-table.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready -->

<sect1 id="language.function.html.table">
 <title>{html_table}</title>
 <para>
  <varname>{html_table}</varname> est une
  <link linkend="language.custom.functions">fonction personnalisée</link>
  qui transforme un tableau de données dans un tabeau HTML.
 </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>Nom de l'attribut</entry>
     <entry>Type</entry>
     <entry>Requis</entry>
     <entry>Défaut</entry>
     <entry>Description</entry>
    </row>
   </thead>
   <tbody>
    <row>
     <entry>loop</entry>
     <entry>tableau</entry>
     <entry>Oui</entry>
     <entry><emphasis>n/a</emphasis></entry>
     <entry>Tableau de données à parcourir</entry>
    </row>
    <row>
     <entry>cols</entry>
     <entry>mixed</entry>
     <entry>Non</entry>
     <entry><emphasis>3</emphasis></entry>
     <entry>
      Nombre de colonnes de la table ou une liste de noms de colonnes séparés par une
      virgule ou un tableau contenant les noms des colonnes. Si l'attribut "cols" est vide,
      mais que des lignes sont données, alors le nombre de colonnes sera calculé
      en utilisant le nombre de lignes et le nombre d'éléments à afficher pour qu'il y 
      ait juste assez de colonnes pour afficher tous les éléments. Si les lignes et 
      les colonnes sont omis tous les deux, la valeur par défaut de "cols" sera appliquée,
      à savoir 3. Si fourni en tant que liste ou tableau, le nombre de colonnes
      est calculé par rapport au nombre d'éléments de la liste ou du tableau.
     </entry>
    </row>
    <row>
     <entry>rows</entry>
     <entry>entier</entry>
     <entry>No</entry>
     <entry><emphasis>empty</emphasis></entry>
     <entry>
      Nombre de lignes de la table. Si l'attribut "rows" est vide, mais que des colonnes
      sont données, alors le nombre de lignes sera calculée en utilisant le nombre de colonnes
      et le nombre d'éléments à afficher pour qu'il y ait juste assez de lignes pour afficher
      tous les éléments.
     </entry>
    </row>
    <row>
     <entry>inner</entry>
     <entry>chaîne de caractères</entry>
     <entry>No</entry>
     <entry><emphasis>cols</emphasis></entry>
     <entry>
      La direction du rendu des éléments consécutifs dans la boucle du tableau.
      <emphasis>cols</emphasis> signifie que les éléments doivent être
      afficher colonnes par colonnes.
      <emphasis>rows</emphasis> signifie que les éléments doivent être
      afficher lignes par lignes.
     </entry>
    </row>
    <row>
     <entry>caption</entry>
     <entry>chaîne de caractères</entry>
     <entry>No</entry>
     <entry><emphasis>empty</emphasis></entry>
     <entry>
      Texte à utiliser pour l'élément <literal>&lt;caption&gt;</literal> du tableau.
     </entry>
    </row>
    <row>
     <entry>table_attr</entry>
     <entry>chaîne de caractères</entry>
     <entry>Non</entry>
     <entry><emphasis>border="1"</emphasis></entry>
     <entry>attributs pour la balise <literal>&lt;table&gt;</literal></entry>
    </row>
    <row>
     <entry>th_attr</entry>
     <entry>chaîne de caractères</entry>
     <entry>No</entry>
     <entry><emphasis>empty</emphasis></entry>
     <entry>Attributs pour les balises <literal>&lt;th&gt;</literal>
      (les tableaux sont parcourus)</entry>
    </row>
    <row>
     <entry>tr_attr</entry>
     <entry>chaîne de caractères</entry>
     <entry>Non</entry>
     <entry><emphasis>empty</emphasis></entry>
     <entry>Attributs pour les balises <literal>&lt;tr&gt;</literal> (les tableaux sont parcourus)</entry>
    </row>
    <row>
     <entry>td_attr</entry>
     <entry>chaîne de caractères</entry>
     <entry>Non</entry>
     <entry><emphasis>empty</emphasis></entry>
     <entry>Attributs pour les balises <literal>&lt;td&gt;</literal>
      (les tableaux sont parcourus)</entry>
    </row>
    <row>
     <entry>trailpad</entry>
     <entry>chaîne de caractères</entry>
     <entry>Non</entry>
     <entry><emphasis>&amp;nbsp;</emphasis></entry>
     <entry>Valeur avec laquelle remplir les cellules
     restantes de la dernière ligne (si il y en a)</entry>
    </row>
    <row>
     <entry>hdir</entry>
     <entry>chaîne de caractères</entry>
     <entry>Non</entry>
     <entry><emphasis>right</emphasis></entry>
     <entry>
      Direction du rendu. Les valeurs possibles sont <emphasis>right</emphasis> (left-to-right),
      <emphasis>left</emphasis> (right-to-left)
     </entry>
    </row>
    <row>
     <entry>vdir</entry>
     <entry>chaîne de caractères</entry>
     <entry>Non</entry>
     <entry><emphasis>down</emphasis></entry>
     <entry>
      Direction des colonnes lors du rendu. Les valeurs possibles sont : 
      <emphasis>down</emphasis> (top-to-bottom), <emphasis>up</emphasis>
      (bottom-to-top)
     </entry>
    </row>
   </tbody>
  </tgroup>
 </informaltable>

 <itemizedlist>
  <listitem><para>
    L'attribut <parameter>cols</parameter> détermine le nombre
    de colonnes dans le tableau.
   </para></listitem>

  <listitem><para>
    Les valeurs <parameter>table_attr</parameter>, <parameter>tr_attr</parameter>
    et <parameter>td_attr</parameter> déterminent les attributs fournis dans les balises
    <literal>&lt;table&gt;</literal>, <literal>&lt;tr&gt;</literal>
    et <literal>&lt;td&gt;</literal>.
   </para></listitem>

  <listitem><para>
    Si <parameter>tr_attr</parameter> ou <parameter>td_attr</parameter>
    est un tableau, il sera parcourru.
   </para></listitem>

  <listitem><para>
    <parameter>trailpad</parameter> est la valeur utilisée pour compléter les cellules
    vides de la dernière ligne s'il y en a.
   </para></listitem>
   </itemizedlist>

 <example>
  <title>{html_table}</title>
  <programlisting role="php">
<![CDATA[
<?php
$smarty->assign('data',array(1,2,3,4,5,6,7,8,9));
$smarty->assign('tr',array('bgcolor="#eeeeee"','bgcolor="#dddddd"'));
$smarty->display('index.tpl');
?>
]]>
  </programlisting>
  <para>
   Les variables assignées depuis PHP peuvent être affichées comme le démontre
   cet exemple.
  </para>
  <programlisting>
<![CDATA[
{**** Premier exemple ****}
{html_table loop=$data}

<table border="1">
 <tbody>
  <tr><td>1</td><td>2</td><td>3</td></tr>
  <tr><td>4</td><td>5</td><td>6</td></tr>
  <tr><td>7</td><td>8</td><td>9</td></tr>
 </tbody>
</table>


{**** Deuxième exemple ****}
{html_table loop=$data cols=4 table_attr='border="0"'}

<table border="0">
 <tbody>
  <tr><td>1</td><td>2</td><td>3</td><td>4</td></tr>
  <tr><td>5</td><td>6</td><td>7</td><td>8</td></tr>
  <tr><td>9</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr>
 </tbody>
</table>


{**** Troisième exemple ****}
{html_table loop=$data cols="first,second,third,fourth" tr_attr=$tr}

<table border="1">
 <thead>
  <tr>
   <th>first</th><th>second</th><th>third</th><th>fourth</th>
  </tr>
 </thead>
 <tbody>
  <tr bgcolor="#eeeeee"><td>1</td><td>2</td><td>3</td><td>4</td></tr>
  <tr bgcolor="#dddddd"><td>5</td><td>6</td><td>7</td><td>8</td></tr>
  <tr bgcolor="#eeeeee"><td>9</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr>
 </tbody>
</table>
]]>
  </programlisting>
 </example>
</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
-->