smarty template engine
Monday, February 08, 2010  
download | documentation | faq | forum | mailing lists | changelog | contribs 


Translate this page to:
search for in the


{html_table}

{html_table} is a custom function that dumps an array of data into an HTML <table>.

Attribute NameTypeRequiredDefaultDescription
looparrayYesn/aArray of data to loop through
colsmixedNo3 Number of columns in the table or a comma-separated list of column heading names or an array of column heading names.if the cols-attribute is empty, but rows are given, then the number of cols is computed by the number of rows and the number of elements to display to be just enough cols to display all elements. If both, rows and cols, are omitted cols defaults to 3. if given as a list or array, the number of columns is computed from the number of elements in the list or array.
rowsintegerNoempty Number of rows in the table. if the rows-attribute is empty, but cols are given, then the number of rows is computed by the number of cols and the number of elements to display to be just enough rows to display all elements.
innerstringNocols Direction of consecutive elements in the loop-array to be rendered. cols means elements are displayed col-by-col. rows means elements are displayed row-by-row.
captionstringNoemptyText to be used for the <caption> element of the table
table_attrstringNoborder="1"Attributes for <table> tag
th_attrstringNoemptyAttributes for <th> tag (arrays are cycled)
tr_attrstringNoemptyattributes for <tr> tag (arrays are cycled)
td_attrstringNoemptyAttributes for <td> tag (arrays are cycled)
trailpadstringNo&nbsp;Value to pad the trailing cells on last row with (if any)
hdirstringNoright Direction of each row to be rendered. possible values: right (left-to-right), and left (right-to-left)
vdirstringNodown Direction of each column to be rendered. possible values: down (top-to-bottom), up (bottom-to-top)

  • The cols attribute determines how many columns will be in the table.

  • The table_attr, tr_attr and td_attr values determine the attributes given to the <table>, <tr> and <td> tags.

  • If tr_attr or td_attr are arrays, they will be cycled through.

  • trailpad is the value put into the trailing cells on the last table row if there are any present.

Example 8-22. {html_table}

<?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');
?>

The variables assigned from php could be displayed as these three examples demonstrate. Each example shows the template followed by output.

{**** Example One ****}
{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>


{**** Example Two ****}
{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>


{**** Example Three ****}
{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>


[advertise]


credits 

Smarty Copyright © 2002-2008
New Digital Group, Inc.

All rights reserved.