void smarty_block_name( |
$params, | |
| $content, | ||
| $template, | ||
&$repeat); |
array $params;mixed $content;object $template;boolean &$repeat;
块函数的形式是：{func} .. {/func}。
换句话说，它们用标签圈起一个块，然后对这个块的内容进行操作。
块函数优先于同名的自定义函数，
这样，你不能同时有自定义函数{func}和块函数{func}..{/func}。
默认你的函数将被Smarty调用两次，在开始标签位置调用和在结束标签位置调用。
（参考下面如何通过$repeat来改变这种情况）
从Smarty 3.1开始，开始标签的返回值将会被显示。
块函数只有在开始标签时才有 属性。
模板中传递给块函数的属性都包含在$params参数数组中。
在处理结束标签时，这些属性也是可用的。
$content的值，取决于函数在执行开始标签还是结束标签。
当在开始标签时，它会是null；
当在结束标签时，它会是模板块里面全部的内容。
注意模板块已经是被Smarty处理过的，所以你得到的内容是模板块的输出内容，而不是模板块的源代码。
$repeat是一个引用值，能控制块可以被显示多少次。
当块函数被第一次调用时（开始标签），$repeat默认是true；
随后的调用（结束标签）都是false。
每次当块函数返回时将$repeat设成true，
{func}...{/func}间的内容会被再次计算，
计算结果保存$content参数内，
在并且函数将被再次执行。
如果使用了嵌套的块函数，
可以通过$smarty->_tag_stack变量来找到父块的函数。
只要对其用一下var_dump()
就可以知道整个层次结构了。
Example 18.5. 块函数
<?php
/*
* Smarty plugin
* -------------------------------------------------------------
* File: block.translate.php
* Type: block
* Name: translate
* Purpose: 翻译一块文字
* -------------------------------------------------------------
*/
function smarty_block_translate($params, $content, Smarty_Internal_Template $template, &$repeat)
{
// 只在结束标签时输出
if(!$repeat){
if (isset($content)) {
$lang = $params['lang'];
// 翻译$content的内容
return $translation;
}
}
}
?>