标签库加载
模板中加载标签库,预加载自定义标签库,扩展内置标签库的加载 请参考:模板/标签库
建议开发者将自定义标签库请放置应用目录中,请勿放在框架系统目录内,以免使用
Composer
更新框架时导致自定义标签库的丢失
下面以标签库放在common
作为一个示例:
<?php namespace app\common\taglib; use think\template\TagLib; class Demo extends TagLib{ /** * 定义标签列表 */ protected $tags = [ // 标签定义: attr 属性列表 close 是否闭合(0 或者1 默认1) alias 标签别名 level 嵌套层次 'close' => ['attr' => 'time,format', 'close' => 0], //闭合标签,默认为不闭合 'open' => ['attr' => 'name,type', 'close' => 1], ]; /** * 这是一个闭合标签的简单演示 */ public function tagClose($tag) { $format = empty($tag['format']) ? 'Y-m-d H:i:s' : $tag['format']; $time = empty($tag['time']) ? time() : $tag['time']; $parse = '<?php '; $parse .= 'echo date("' . $format . '",' . $time . ');'; $parse .= ' ?>'; return $parse; } /** * 这是一个非闭合标签的简单演示 */ public function tagOpen($tag, $content) { $type = empty($tag['type']) ? 0 : 1; // 这个type目的是为了区分类型,一般来源是数据库 $name = $tag['name']; // name是必填项,这里不做判断了 $parse = '<?php '; $parse .= '$test_arr=[[1,3,5,7,9],[2,4,6,8,10]];'; // 这里是模拟数据 $parse .= '$__LIST__ = $test_arr[' . $type . '];'; $parse .= ' ?>'; $parse .= '{volist name="__LIST__" id="' . $name . '"}'; $parse .= $content; $parse .= '{/volist}'; return $parse; } }
这时候我们的控制器继承Controller
,在配置参数中配置:
'template' => [ // 模板引擎类型 支持 php think 支持扩展 'type' => 'Think', // 模板路径 'view_path' => '', // 模板后缀 'view_suffix' => '.html', // 预先加载的标签库 'taglib_pre_load' => 'app\common\taglib\Demo', ],
我们就可以在控制器中对模版赋值:
//给模版给以一个当前时间戳的值 $this->assign('demo_time',$this->request->time());
在模版中调用我们已经预先加载的标签:
<h1>闭合标签</h1> {demo:close time='$demo_time'/} <hr> <h1>非闭合标签</h1> {demo:open name='demo_name'} {$key}=>{$demo_name}<br> {/demo:open} <br> {demo:open name='demo_name' type='1'} {$key}=>{$demo_name}<br> {/demo:open}
关于标签库开发
暂时可以参考3.2的官方手册中关于标签库扩展的部分,建议自己分析内置标签库Cx。