标签库加载

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

建议开发者将自定义标签库请放置应用目录中，请勿放在框架系统目录内，以免使用Composer更新框架时导致自定义标签库的丢失

下面以标签库放在common作为一个示例：

  1. <?php
  2. namespace app\common\taglib;
  3. use think\template\TagLib;
  4. class Demo extends TagLib{
  5.     /**
  6.      * 定义标签列表
  7.      */
  8.     protected $tags   =  [
  9.         // 标签定义： attr 属性列表 close 是否闭合（0 或者1 默认1） alias 标签别名 level 嵌套层次
  10.         'close'     => ['attr' => 'time,format', 'close' => 0], //闭合标签，默认为不闭合
  11.         'open'      => ['attr' => 'name,type', 'close' => 1], 
  13.     ];
  15.     /**
  16.      * 这是一个闭合标签的简单演示
  17.      */
  18.     public function tagClose($tag)
  19.     {
  20.         $format = empty($tag['format']) ? 'Y-m-d H:i:s' : $tag['format'];
  21.         $time = empty($tag['time']) ? time() : $tag['time'];
  22.         $parse = '<?php ';
  23.         $parse .= 'echo date("' . $format . '",' . $time . ');';
  24.         $parse .= ' ?>';
  25.         return $parse;
  26.     }
  28.     /**
  29.      * 这是一个非闭合标签的简单演示
  30.      */
  31.     public function tagOpen($tag, $content)
  32.     {
  33.         $type = empty($tag['type']) ? 0 : 1; // 这个type目的是为了区分类型，一般来源是数据库
  34.         $name = $tag['name']; // name是必填项，这里不做判断了
  35.         $parse = '<?php ';
  36.         $parse .= '$test_arr=[[1,3,5,7,9],[2,4,6,8,10]];'; // 这里是模拟数据
  37.         $parse .= '$__LIST__ = $test_arr[' . $type . '];';
  38.         $parse .= ' ?>';
  39.         $parse .= '{volist name="__LIST__" id="' . $name . '"}';
  40.         $parse .= $content;
  41.         $parse .= '{/volist}';
  42.         return $parse;
  43.     }
  45. }

这时候我们的控制器继承Controller,在配置参数中配置：

  1. 'template'               => [
  2.             // 模板引擎类型 支持 php think 支持扩展
  3.             'type'         => 'Think',
  4.             // 模板路径
  5.             'view_path'    => '',
  6.             // 模板后缀
  7.             'view_suffix'  => '.html',
  8.             // 预先加载的标签库
  9.             'taglib_pre_load'     =>    'app\common\taglib\Demo', 
  11.         ],

我们就可以在控制器中对模版赋值：

  1. //给模版给以一个当前时间戳的值
  2. $this->assign('demo_time',$this->request->time());

在模版中调用我们已经预先加载的标签：

  1. <h1>闭合标签</h1>
  2. {demo:close time='$demo_time'/}
  3. <hr>
  4. <h1>非闭合标签</h1>
  5. {demo:open name='demo_name'}
  6.     {$key}=>{$demo_name}<br>
  7. {/demo:open}
  8. <br>
  9. {demo:open name='demo_name' type='1'}
  10.     {$key}=>{$demo_name}<br>
  11. {/demo:open}

关于标签库开发

暂时可以参考3.2的官方手册中关于标签库扩展的部分，建议自己分析内置标签库Cx。