详解dede模板引擎中的标记

静态模板类：

类文件
include/dedetag.class.php

这个文件是dedecms V5.3及之前版本使用的主要的模板类，它是解析式模板类，并非编译式的（区别是前者通过获得标签位置进行内容替换，后者是直接解析式PHP代码，二次执行）

一、模板语法
织梦模板引擎是一种使用XML名字空间形式的模板解析器，使用织梦解析器解析模板的最大好处是可以轻松的制定标记的属性，感觉上就像在用HTML一样，使模板代码十分直观灵活，新版的织梦模板引擎不单能实现模板的解析还能分析模板里错误的标记。

1、织梦模板引擎的代码样式有如下几种形式：
{dede:标记名称 属性=’值’/}
{dede:标记名称 属性=’值’}{/dede:标记名称}
{dede:标记名称 属性=’值’}自定义样式模板(InnerText){/dede:标记名称}

提示：
如果使用带底层模板的标记，必须严格用{dede:标记名称 属性=’值’}{/dede:标记名称} 这种格式，否则会报错。

2、织梦模板引擎内置有多个系统标记，这些系统标记在任何场合都是能直接使用的。

(1) global 标记，表示获取一个外部变量，除了数据库密码之外，能调用系统的任何配置参数，形式为：
{dede:global name=’变量名称’}{/dede:global}
或
{dede:global name=’变量名称’/}

其中变量名称不能加 cfg_cmspath ，应该写成 {dede:global name=’cfg_cmspath’/} 。

(2) foreach 用来输出一个数组，形式为：
{dede:foreach array=’数组名称’}[field:key/] [field:value/]{/dede:foreach}

(3) include 引入一个文件，形式为：
{dede:include file=’文件名称’ ismake=’是否为dede板块模板(yes/no)’/}
对文件的搜索路径为顺序为：绝对路径、include文件夹，CMS安装目录，CMS主模板目录

3、织梦标记允许在任何标记中使用函数对得到的值进行处理，形式为：
{dede:标记名称 属性=’值’ function=’youfunction(“参数一”,”参数二”,”@me”)’/}
其中 @me 用于表示当前标记的值，其它参数由你的函数决定是否存在，例如：
{dede:field name=’pubdate’ function=’strftime(“%Y-%m-%d %H:%M:%S”,”@me”)’/}

4、织梦标记允许有限的编程扩展。
格式为：
{dede:tagname runphp=’yes’}
$aaa = @me;
@me = “123456″;
{/dede:tagname}
@me 表示这个标记本身的值，因此标记内编程是不能使用echo之类的语句的，只能把所有返回值传递给@me。
此外由于程序代码占用了底层模板InnerText的内容，因此需编程的标记只能使用默认的InnerText。

动态模板类：
核心类文件
include/dedetemplate.class.php
用途：用于非核心模块的动态页面或列表页的模板解析，如：member/content_list.php ，通常是在 datalistcp.class.php 中使用，这个类在动态运行的情况下，由于本身是把模板编译成PHP的，因此性能上会优级于旧的解析类，这个方法将在未来版本中作为通用的方式。

一、使用方法：

tpl = new DedeTemplate(‘tpl’);

如果在类文件中调用，应该加上设置：
this);
在一些块调用中默认将使用当前类的成员函数。

$tpl->LoadTemplate(模板的物理路径);

如果模板中带有 {dede:config name=” value=”/}
可以在载入模板后，通过 name) 获得这些变量的值。

显示页面或保存页面为文件
tpl->SaveTo(物理绝对路径的文件名);

二、模板标记语法

1、标记通用特性
(1) 短标记
{dede:tagname.name/}
等同于
{dede:tagname name=” /}
(2) 块标记
{dede:tagname}
循环代码
{/dede:tagname}

2、标记的具体语法及对应的PHP代码
(1) 配置变量
{dede:config name=” value=”/}
配置变量可以在载入模板后通过 name) 获得，仅作为配置，不在模板中显示。

(2) 短标记

{dede:global.name/} 外部变量 等同于
{dede:field.name/} field数组 等同于

考虑到大多数情况下都会在函数或类中调用模板，因此 $_vars、$fields 数组必须声明为 global 数组，否则模板引擎无法获得它的值从而导致产生错误。

(3) 自由调用块标记
{tag:blockname bind=’GetArcList’ bindtype=’class’}
循环代码
{/tag:blockname}

必要属性：
bind 数据源来源函数
bindtype 函数类型，默认是 class 可选为 sub
rstype 返回结果类型，默认是 array ，可选项为 string

自定义函数格式必须为 function(array refObj, array atts,fields) 统一管理，这个函数存放在 cls_dede_tplinc.php 。

(4) 固定块标记

[1] datalist
从绑定类成员函数GetArcList中获取数组并输出
{dede:datalist}
循环代码
{/dede:datalist}
遍历一个二给维数组，数据源是固定的，只适用用类调用。
等同于
{tag:blockname bind=’GetArcList’ bindtype=’class’ rstype=’arrayu’}
循环代码
{/tag:blockname}

[2] label
从绑定函数中获取字符串值并输出
等同于 {tag:blockname bind=’func’ bindtype=’sub’ rstype=’string’/}

[3] pagelist

从绑定类成员函数GetPageList中获取字符串值并输出
等同于 {tag:blockname bind=’GetPageList’ bindtype=’class’ rstype=’string’/}

(5) include 语法
{dede:include file=”/}
{dede:include filename=”/}

(6) php 代码块
{dede:php
php 代码
/}
或
{dede:php}
php代码
{/dede:php}

(7) if 条件
仅支持 if ，else ，else 直接用{else}表示,但不支持{else if}这样的语法 ，一般建议模板中不要使用太复杂的条件语法，如果确实有需要，可以直接使用 php 语法。

{dede:if 条件} a-block {else} b-block {/dede:if}

条件中允许使用 var.name 、 global.name 、 field.name、cfg.name 表示相应的变量。

如：
{dede:if field.id>10 }
{/dede:if}

(8) 遍历一个 array 数组

{dede:array.name}
{dede:key/} = {dede:value/}
{/dede:array}

各种语法的具体编译后的代码，可查看 dede-template-class.php 的 function CompilerOneTag(&$cTag)。

块调用示例代码：
1、示例一

{tag:datalist timeformat=”"}
  
    
      
?{tag:field.title/}
          {tag:field.description function=”CnSubstr(@me,150)”/}…
    
    {tag:field.formattime/}
  
{/tag:datalist}

编译后的代码

refObj->GetArcList($atts,$this->refObj,$fields);
foreach( $blockValue as $key=>$fields )
{
?>
  
    
      
?’>
          …
    
    
  

2、示例二

{tag:article sort=’new’ titlelen=’36′ row=’10′}
   
[{tag:field.typename/}]{tag:field.title function=”CnSubstr(@me,24)”/}
{/tag:article}

编译后的代码

refObj,$fields);
if(is_array($blockValue) && count($blockValue) > 0){
foreach( $blockValue as $key=>$fields )
{
?>
   
[]”>