{counter} · smarty3中文手册

<table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"><tr><th colspan="3" align="center">Smarty - the compiling PHP template engine<br/> Smarty - php 模板编译引擎 </th> </tr><tr><td width="25%" align="left" valign="bottom"><a href="language.custom.functions.html" accesskey="P">Prev</a></td> <td width="50%" align="center" valign="bottom">Chapter 8. Custom Functions[第八章.自定义函数]</td> <td width="25%" align="right" valign="bottom"><a href="language.function.cycle.html" accesskey="N">Next</a></td></tr></table> # {counter} {counter} is used to print out a count. {counter} will remember the count on each iteration. You can adjust the number, the interval and the direction of the count, as well as determine whether or not to print the value. You can run multiple counters concurrently by supplying a unique name for each one. If you do not supply a name, the name “default” will be used. If you supply the assign attribute, the output of the {counter} function will be assigned to this template variable instead of being output to the template. {counter}用于输出一个记数过程。{counter}保存了每次记数时的当前记数值。用户可以通过调节间隔（skip）和方向（direction）计算该值。也可以决定是否输出该值。如果需要同时运行多个计数器，必须为它们指定不同的名称。如果没有指定名称，模板引擎使用 "default" 作为缺省值。如果指定了 "assign" 这个属性，该计数器的输出值将被赋给由*assign*指定的模板变量，而不是直接输出。 | Attribute Name | Type | Required | Default | Description | |-----|-----|-----|-----|-----| | name | string | No | *default* | The name of the counter | | start | number | No | *1* | The initial number to start counting from | | skip | number | No | *1* | The interval to count by | | direction | string | No | *up* | the direction to count (up/down) | | print | boolean | No | *true* | Whether or not to print the value | | assign | string | No | *n/a* | the template variable the output will be assigned to | | 属性 | 类型 | 是否必须 | 缺省值 | 描述 | |-----|-----|-----|-----|-----| | name | string | No | *default* | 计数器的名称 | | start | number | No | *1* | 记数器初始值 | | skip | number | No | *1* | 记数器间隔、步长 | | direction | string | No | *up* | 记数器方向，(增/减) | | print | boolean | No | *true* | 是否输出值 | | assign | string | No | *n/a* | 输出值将被赋给模板变量的名称 | <table width="100%" border="0" cellpadding="0" cellspacing="0" class="EXAMPLE"><tr><td><div class="EXAMPLE"><a name="AEN81" id="AEN81"/> <b>Example 8-1. {counter}<br/> 例 8-1. counter 函数演示</b> <table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="PROGRAMLISTING">{* initialize the count *}{counter start=0 skip=2}<br />{counter}<br />{counter}<br />{counter}<br /> this will output:0<br />2<br />4<br />6<br /></pre></td></tr></table></div></td></tr></table> <table summary="Footer navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"><tr><td width="33%" align="left" valign="top"><a href="language.custom.functions.html" accesskey="P">Prev</a></td><td width="34%" align="center" valign="top"><a href="index.html" accesskey="H">Home</a></td><td width="33%" align="right" valign="top"><a href="language.function.cycle.html" accesskey="N">Next</a></td></tr><tr><td width="33%" align="left" valign="top">Custom Functions<br/> 自定义函数</td><td width="34%" align="center" valign="top"><a href="language.custom.functions.html" accesskey="U">Up</a></td><td width="33%" align="right" valign="top">{cycle}</td></tr></table>