{function}

{function}用于在模板中创建函数，然后像调用插件函数一样调用它们。与其编写生成展示性内容的插件，不如将其保留在模板中，通常是一种更易于管理的选择。它还简化了数据遍历，例如深度嵌套的菜单。

注意

模板函数被定义为全局。由于 Smarty 编译器是一个单次编译器， {call} 标记必须用于从给定模板外部定义的模板函数调用。否则，你可以在模板中直接用 {funcname ...} 的形式使用函数。

属性

属性名称	必要性	描述
name	是	模板函数的名称
[var ...]	否	传递给模板函数的默认变量值

• {function} 标记必须具有 name 属性，其中包含模板函数的名称。可以将具有此名称的标记用于调用模板函数。

• 变量的默认值可以作为 属性 传递给模板函数。像在 PHP 函数的声明中一样，你只能使用标量值作为默认值。在调用模板函数时，可以覆盖默认值。

• 你可以在模板函数中使用来自调用模板的所有变量。对变量的更改或在模板函数中创建的新变量具有局部作用域，并且在执行模板函数后在调用模板中不可见。

注意

在调用模板函数时，可以传递任意数量的参数。除非想要使用默认值，否则参数变量不得在 {funcname ...} 标记中声明。默认值必须是标量，不能是变量。必须在调用模板时传递变量。

示例

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