e544ed6d9a
Comparing changes: https://github.com/smarty-php/smarty/compare/v4.3.1...v4.4.1 It is noticeable that Smarty 4.3.1 does not officially support PHP 8.3. Is only supported with 4.4.0. Remark: During tests with Smarty 4.5.1, it was noticed that the following warning occurs: Deprecated: Using the unregistered function "function_exists" in a template is deprecated and will be removed in a future version. Use Smarty::registerPlugin to explicitly register a custom modifier. As of Smarty 5.X.X, templates must be revised again. The Smarty release 5.0.2 is already officially available. However, integration into FlatPress is not entirely trivial.
94 lines
9.0 KiB
Markdown
94 lines
9.0 KiB
Markdown
# {html_table}
|
|
|
|
`{html_table}` is a [custom function](index.md) that
|
|
dumps an array of data into an HTML `<table>`.
|
|
|
|
## Attributes
|
|
|
|
| Attribute Name | Required | Description |
|
|
|----------------|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
| loop | Yes | Array of data to loop through |
|
|
| cols | No | 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. |
|
|
| rows | No | 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. |
|
|
| inner | No | 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. |
|
|
| caption | No | Text to be used for the `<caption>` element of the table |
|
|
| table\_attr | No | Attributes for `<table>` tag (defaults to 'border="1"') |
|
|
| th\_attr | No | Attributes for `<th>` tag (arrays are cycled) |
|
|
| tr\_attr | No | attributes for `<tr>` tag (arrays are cycled) |
|
|
| td\_attr | No | Attributes for `<td>` tag (arrays are cycled) |
|
|
| trailpad | No | Value to pad the trailing cells on last row with (if any) (defaults to ' ') |
|
|
| hdir | No | Direction of each row to be rendered. possible values: *right* (left-to-right), and *left* (right-to-left) (defaults to 'right') |
|
|
| vdir | No | Direction of each column to be rendered. possible values: *down* (top-to-bottom), *up* (bottom-to-top) (defaults to 'down') |
|
|
|
|
- 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.
|
|
|
|
## Examples
|
|
|
|
```php
|
|
<?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 1 **
|
|
```smarty
|
|
{html_table loop=$data}
|
|
```
|
|
```html
|
|
<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 2 **
|
|
```smarty
|
|
{html_table loop=$data cols=4 table_attr='border="0"'}
|
|
```
|
|
```html
|
|
<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> </td><td> </td><td> </td></tr>
|
|
</tbody>
|
|
</table>
|
|
```
|
|
|
|
** Example 3 **
|
|
```smarty
|
|
{html_table loop=$data cols="first,second,third,fourth" tr_attr=$tr}
|
|
```
|
|
```html
|
|
<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> </td><td> </td><td> </td></tr>
|
|
</tbody>
|
|
</table>
|
|
```
|
|
|