標簽擴展

標簽庫加載

模板中加載標簽庫，預加載自定義標簽庫，擴展內(nèi)置標簽庫的加載 請參考:模板/標簽庫

建議開發(fā)者將自定義標簽庫請放置應用目錄中，請勿放在框架系統(tǒng)目錄內(nèi)，以免使用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目的是為了區(qū)分類型，一般來源是數(shù)據(jù)庫
        $name = $tag['name']; // name是必填項，這里不做判斷了
        $parse = '<?php ';
        $parse .= '$test_arr=[[1,3,5,7,9],[2,4,6,8,10]];'; // 這里是模擬數(shù)據(jù)
        $parse .= '$__LIST__ = $test_arr[' . $type . '];';
        $parse .= ' ?>';
        $parse .= '{volist name="__LIST__" id="' . $name . '"}';
        $parse .= $content;
        $parse .= '{/volist}';
        return $parse;
    }
   
}

這時候我們的控制器繼承Controller,在配置參數(shù)中配置：

'template'               => [
            // 模板引擎類型 支持 php think 支持擴展
            'type'         => 'Think',
            // 模板路徑
            'view_path'    => '',
            // 模板后綴
            'view_suffix'  => '.html',
            // 預先加載的標簽庫
            'taglib_pre_load'     =>    'app\common\taglib\Demo', 
          
        ],

我們就可以在控制器中對模版賦值：

//給模版給以一個當前時間戳的值
$this->assign('demo_time',$this->request->time());

在模版中調(diào)用我們已經(jīng)預先加載的標簽：

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

關(guān)于標簽庫開發(fā)

暫時可以參考3.2的官方手冊中關(guān)于標簽庫擴展的部分，建議自己分析內(nèi)置標簽庫Cx。