标签扩展

标签库加载

模板中加载标签库,预加载自定义标签库,扩展内置标签库的加载 请参考:模板/标签库

建议开发者将自定义标签库请放置应用目录中,请勿放在框架系统目录内,以免使用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。