Smarty Icon

You may use the Smarty logo according to the trademark notice.

For sponsorship, advertising, news or other inquiries, contact us at:

Sites Using Smarty

{function}
Prev	Chapter 7. 内置函数	Next

{function}

{function}用于在模板内创建函数，这些函数可以像插件函数一样调用。用这个方式来代替写插件来显示内容，更具有可管理性。这也可以简化数据的复杂度，如多层结构的菜单。

Note

模板函数是全局的。因为Smarty的编译器是单次编译的，所以必须用 {call} 标签来调用定义在当前模板的函数。或者你可以直接使用函数，如{funcname ...}。

{function}标签必须设置name属性，也就是模板函数的名称。该名称可以用于调用模板函数。
可以按属性的方式传递给模板函数变量默认值。和PHP函数定义一样，你只可以使用标量值作为默认。默认值可以被覆盖，当模板函数被调用的时候。
你可以在调用模板函数内使用当前模板的全部变量，在模板内创建或修改的变量就不能被模板函数内访问了。

属性:

参数名称	类型	必选参数	默认值	说明
name	string	Yes	n/a	模板函数的名称
[var ...]	[var type]	No	n/a	模板函数参数的默认值

Note

当模板函数被调用时，你可以传递任意数量的参数给它。除非你需要默认值，否则不要在 {funcname ...}标签内定义参数。默认值必须是标量而且不是变量，变量必须在函数调用时才能传递。

Example 7.43. 递归菜单 {function} 例子


{* define the function *}
{function name=menu level=0}
{function menu level=0}          {* short-hand *}
  <ul class="level{$level}">
  {foreach $data as $entry}
    {if is_array($entry)}
      <li>{$entry@key}</li>
      {menu data=$entry level=$level+1}
    {else}
      <li>{$entry}</li>
    {/if}
  {/foreach}
  </ul>
{/function}

{* create an array to demonstrate *}
{$menu = ['item1','item2','item3' => ['item3-1','item3-2','item3-3' =>
['item3-3-1','item3-3-2']],'item4']}

{* run the array through the function *}
{menu data=$menu}

输出：


* item1
* item2
* item3
      o item3-1
      o item3-2
      o item3-3
            + item3-3-1
            + item3-3-2
* item4

参见 {call}

Prev	Up	Next
{foreach},{foreachelse}	Home	{if},{elseif},{else}

Smarty Icon

Sites Using Smarty

Advertisement

{function}

Note

Note

Sponsors [info]