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

2021-07-28 0 3,430
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,$this->refObj,$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 
} 
} 
?>

收藏 (0) 打赏

您的支持是我们前进最大的动力!

打开微信扫一扫,即可进行扫码打赏哦
点赞 (0)

本站声明: 根据2013年1月30日《计算机软件保护条例》2次修订第17条规定:为了学习和研究软件内含的设计思想和原理,通过安装、显示、传输或者存储软件等方式使用软件的,可以不经软件著作权人许可,不向其支付报酬,鉴于此,也希望大家遵守相关法律法规使用、研究软件。 1、本站所有资源来源于用户上传和网络,因此不包含技术服务请大家谅解。 2、下载用户仅供学习交流,若使用商业用途,请购买正版授权,否则产生的一切后果将由下载用户自行承担。 3、站内资源均来源于网络公开发表文件或网友投稿发布,如侵犯您的权益,请联系管理员处理。 4、本站不保证所提供下载的资源的准确性、安全性和完整性,资源仅供下载学习之用,如有链接无法下载、失效或广告,请联系客服处理。 5、所有资源均收集于互联网仅供学习、参考和研究,请理解这个概念,所以不能保证每个细节都符合你的需求,也可能存在未知的BUG与瑕疵,因本站资源均为可复制品,所 以不支持任何理由的退款兑现,请熟知后再下载。

彤彤模板团 织梦CMS教程 DedeCms 常用函数参考:动态模板类 https://www.xiaoyuerqingfen.cn/3477.html

一家有态度的精品资源分享平台

常见问题
  • 模板团承诺演示效果图均和网站95%一样,并且我们的模板和数据都没有留后门,请放心使用。
查看详情
  • 因为模板具有可复制性和可传播性,模板一旦发货,非质量问题,不支持退换;所以务必请您一定看清楚后再购买。
查看详情

相关文章

评论
暂无评论
官方客服团队

为您解决烦忧 - 24小时在线 专业服务

  • 0 +

    访问总数

  • 0 +

    会员总数

  • 0 +

    资源总数

  • 0 +

    今日发布

  • 0 +

    本周发布

  • 0 +

    运行天数

开通会员,尊享海量资源下载特权