您好,欢迎来到菜鸟吧源码网(www.cniao8.com)本站只做精品网站源码!
  • 首 页
  • 会员介绍
  •  

    当前位置:主页 > 站长学堂 > dede教程 >
    DedeCms 常用函数参考:动态模板类
    时间:2020-08-08 11:39 作者:菜鸟吧 浏览:收藏 挑错 打印
    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、示例一
    01{tag:datalist timeformat=""}
    02<tr>
    03<td class='col1'>
    04<div>?<a href='{tag:field.arcurl/}'>{tag:field.title/}</a></div>
    05<!--div class='descriptions'>&nbsp;&nbsp;&nbsp;&nbsp;{tag:field.description function="CnSubstr(@me,150)"/}...</div-->
    06</td>
    07<td class='col2'>{tag:field.formattime/}</td>
    08</tr>
    09{/tag:datalist}
    10编译后的代码
    11<?php
    12$atts = array();
    13$atts['tagname'] = 'datalist';
    14$atts['timeformat'] = '';
    15$blockValue = $this->refObj->GetArcList($atts,$this->refObj,$fields);
    16foreach( $blockValue as $key=>$fields )
    17{
    18?>
    19<tr>
    20<td class='col1'>
    21<div>?<a href='<?php echo $fields['arcurl']; ?>'><?php echo$fields['title']; ?></a></div>
    22<!--div class='descriptions'>&nbsp;&nbsp;&nbsp;&nbsp;<?php echoCnSubstr($fields['description'],150); ?>...</div-->
    23</td>
    24<td class='col2'><?php echo$fields['formattime']; ?></td>
    25</tr>
    26<?php
    27}
    28?>
    292、示例二
    30{tag:article sort='new'titlelen='36'row='10'}
    31<dd>[{tag:field.typename/}]<a href="{tag:field.arcurl/}">{tag:field.title function="CnSubstr(@me,24)"/}</a></dd>
    32{/tag:article}
    编译后的代码
    查看源码
    打印代码帮助
    01<?php
    02$atts = array();
    03$atts['tagname'] = 'article';
    04$atts['sort'] = 'new';
    05$atts['titlelen'] = '36';
    06$atts['row'] = '10';
    07$blockValue = MakePublicTag($atts,$this->refObj,$fields);
    08if(is_array($blockValue) && count($blockValue) > 0){
    09foreach( $blockValue as $key=>$fields )
    10{
    11?>
    12<dd>[<?php echo$fields['typename']; ?>]<a href="<?php echo $fields['arcurl']; ?>"><?php echoCnSubstr($fields['title'],24); ?></a></dd>
    13<?php
    14}
    15}
    16?>

    郑重声明:
    本站所有内容均由互联网收集整理、网友上传,并且以计算机技术研究交流为目的,仅供大家参考、学习,不存在任何商业目的与商业用途。 若您需要商业运营或用于其他商业活动,请您购买正版授权并合法使用。
    我们不承担任何技术及版权问题,且不对任何资源负法律责任。
    如无法下载,联系站长索要。
    如有侵犯您的版权,请给我们来信:admin@cniao8.com,我们尽快处理。

    DEDECMS批量导入excel数据到后台文章系统的开发教程DEDECMS批量导入excel数据到后台文章系
    织梦中TAG标签字数长度限制解决方法织梦中TAG标签字数长度限制解决方法
    dedecms 问答模块时间显示dedecms 问答模块时间显示