DedeCms 常用函数参考：动态模板类

概述网(LieHuo.Net)教程 DedeCms V5.3 常用函数参考：动态模板类核心类文件 include/dedetemplate.class.php 用途：用于非核心模块的动态页面或列表页的模板解析，如：member/content_list.php ，通常是在 datalistcp.class.php 中使用，这个类在动态运行的情况下，由于本身是把模板编译成PHP的…

内存溢出 jb51.cc Dedecms V5.3 常用函数参考：动态模板类

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

一、使用方法：

$tpl = new DedeTemplate(
模板对象实例名称，通常是'tpl',
[模板存放目录（生成缓存时会存放在这个目录）,
include语法默认引用目录]
);
通常情况下参数二和参数三是不必要的，如：
$tpl = new DedeTemplate('tpl');

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

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

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

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

二、模板标记语法

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

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

(2) 短标记

{dede:global.name/} 外部变量 等同于 <?PHP echo $name; ?>
{dede:var.name/} var数组 等同于 <?PHP echo $_vars['name']; ?>
{dede:fIEld.name/} fIEld数组 等同于 <?PHP echo $fIElds['name']; ?>
{dede:cfg.name/} 系统配置变量 等同于 <?PHP echo $cfg_name; ?>

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

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

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

自定义函数格式必须为 function(array $atts,object $refObj,array $fIElds);
在没有指定 bind 绑定的函数的情况下，默认指向 MakePublicTag($atts,$tpl->refObj,$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=""}
<tr>
<td class='col1'>
<div>?<a href='{tag:fIEld.arcurl/}'>{tag:fIEld.Title/}</a></div>
<!--div class='descriptions'>&nbsp;&nbsp;&nbsp;&nbsp;{tag:fIEld.description function="CnSubstr(@me,150)"/}...</div-->
</td>
<td class='col2'>{tag:fIEld.formattime/}</td>
</tr>
{/tag:dataList}
编译后的代码
<?PHP
$atts = array();
$atts['tagname'] = 'dataList';
$atts['timeformat'] = '';
$blockValue = $this->refObj->GetArcList($atts,$this->refObj,$fIElds);
foreach( $blockValue as $key=>$fIElds )
{
?>
<tr>
<td class='col1'>
<div>?<a href='<?PHP echo $fIElds['arcurl']; ?>'><?PHP echo $fIElds['Title']; ?></a></div>
<!--div class='descriptions'>&nbsp;&nbsp;&nbsp;&nbsp;<?PHP echo CnSubstr($fIElds['description'],150); ?>...</div-->
</td>
<td class='col2'><?PHP echo $fIElds['formattime']; ?></td>
</tr>
<?PHP
}
?>
2、示例二
{tag:article sort='new' Titlelen='36' row='10'}
<dd>[{tag:fIEld.typename/}]<a href="{tag:fIEld.arcurl/}">{tag:fIEld.Title function="CnSubstr(@me,24)"/}</a></dd>
{/tag:article}

编译后的代码

<?PHP
$atts = array();
$atts['tagname'] = 'article';
$atts['sort'] = 'new';
$atts['Titlelen'] = '36';
$atts['row'] = '10';
$blockValue = MakePublicTag($atts,$fIElds);
if(is_array($blockValue) && count($blockValue) > 0){
foreach( $blockValue as $key=>$fIElds )
{
?>
<dd>[<?PHP echo $fIElds['typename']; ?>]<a href="<?PHP echo $fIElds['arcurl']; ?>"><?PHP echo CnSubstr($fIElds['Title'],24); ?></a></dd>
<?PHP
}
}
?>

总结

以上是内存溢出为你收集整理的DedeCms 常用函数参考：动态模板类全部内容，希望文章能够帮你解决DedeCms 常用函数参考：动态模板类所遇到的程序开发问题。

如果觉得内存溢出网站内容还不错，欢迎将内存溢出网站推荐给程序员好友。