Files
smarty/docs/fr/designers/language-custom-functions/language-function-html-table.xml
2005-12-04 17:56:06 +00:00

202 lines
6.3 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready -->
<sect1 id="language.function.html.table">
<title>{html_table}</title>
<para>
{html_table} est une <link linkend="language.custom.functions">fonction personnalisée</link>
qui transforme un tableau de données dans un tabeau HTML. L'attribut
<emphasis>cols</emphasis> détermine le nombre de colonne du tableau.
Les attributs <emphasis>table_attr</emphasis>, <emphasis>tr_attr</emphasis>
et <emphasis>td_attr</emphasis> déterminent les attributs donnés aux
balises table, tr et td. Si <emphasis>tr_attr</emphasis> ou
<emphasis>td_attr</emphasis> sont des tableaux, ils seront parcourus.
<emphasis>trailpad</emphasis> est la valeur avec laquelle cera remplit
les cellules restantes de la dernière ligne, s'il y en a.
</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>entier</entry>
<entry>Non</entry>
<entry><emphasis>3</emphasis></entry>
<entry>
nombre de colonnes de la table. 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.
</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>table_attr</entry>
<entry>chaîne de caractères</entry>
<entry>Non</entry>
<entry><emphasis>border="1"</emphasis></entry>
<entry>attributs pour la balise table</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 tr (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 td (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>
<example>
<title>{html_table}</title>
<programlisting role="php">
<![CDATA[
Code PHP :
-------------
<?php
require('Smarty.class.php');
$smarty = new Smarty;
$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>
<programlisting>
<![CDATA[
Code du template :
----------------------
{html_table loop=$data}
{html_table loop=$data cols=4 table_attr='border="0"'}
{html_table loop=$data cols=4 tr_attr=$tr}
]]>
</programlisting>
<para>
Affichera :
</para>
<screen>
<![CDATA[
<table border="1">
<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>
</table>
<table border="0">
<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>
</table>
<table border="1">
<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>
</table>
]]>
</screen>
</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
-->