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

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、示例一 

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/6f5d0e7eae69444e5e72a9d6b0d7695e.html