DedeCms V5.3 常用函數(shù)參考：動(dòng)態(tài)模板類   核心類文件  include/dedetemplate.class.php  用途：用于非核心模塊的動(dòng)態(tài)頁面或列表頁的模板解析，如：member/content_list.php ，通常是在 datalistcp.class.php 中使用，這個(gè)類在動(dòng)態(tài)運(yùn)行的情況下，由于本身是把模板編譯成PHP的，因此性能上會(huì)優(yōu)級(jí)于舊的解析類，這個(gè)方法將在未來版本中作為通用的方式。   一、使用方法：   $tpl = new DedeTemplate(  模板對(duì)象實(shí)例名稱，通常是'tpl',  [模板存放目錄（生成緩存時(shí)會(huì)存放在這個(gè)目錄）,  include語法默認(rèn)引用目錄]  );  通常情況下參數(shù)二和參數(shù)三是不必要的，如：  $tpl = new DedeTemplate('tpl');   如果在類文件中調(diào)用，應(yīng)該加上設(shè)置：  $this->tpl->SetObject($this);  在一些塊調(diào)用中默認(rèn)將使用當(dāng)前類的成員函數(shù)。   $tpl->LoadTemplate(模板的物理路徑);   如果模板中帶有 {dede:config name='' value=''/}  可以在載入模板后，通過 $tpl->GetConfig($name) 獲得這些變量的值。   顯示頁面或保存頁面為文件  $tpl->Display();  $tpl->SaveTo(物理絕對(duì)路徑的文件名);     二、模板標(biāo)記語法   1、標(biāo)記通用特性  (1) 短標(biāo)記  {dede:tagname.name/}  等同于  {dede:tagname name='' /}  (2) 塊標(biāo)記  {dede:tagname}  循環(huán)代碼  {/dede:tagname}     2、標(biāo)記的具體語法及對(duì)應(yīng)的PHP代碼  (1) 配置變量  {dede:config name='' value=''/}  配置變量可以在載入模板后通過 $tpl->GetConfig($name) 獲得，僅作為配置，不在模板中顯示。   (2) 短標(biāo)記   {dede:global.name/} 外部變量 等同于 <?php echo $name; ?>  {dede:var.name/} var數(shù)組 等同于 <?php echo $_vars['name']; ?>  {dede:field.name/} field數(shù)組 等同于 <?php echo $fields['name']; ?>  {dede:cfg.name/} 系統(tǒng)配置變量 等同于 <?php echo $cfg_name; ?>   考慮到大多數(shù)情況下都會(huì)在函數(shù)或類中調(diào)用模板，因此 $_vars、$fields 數(shù)組必須聲明為 global 數(shù)組，否則模板引擎無法獲得它的值從而導(dǎo)致產(chǎn)生錯(cuò)誤。   (3) 自由調(diào)用塊標(biāo)記  {tag:blockname bind='GetArcList' bindtype='class'}  循環(huán)代碼  {/tag:blockname}   必要屬性：  bind 數(shù)據(jù)源來源函數(shù)  bindtype 函數(shù)類型，默認(rèn)是 class 可選為 sub  rstype 返回結(jié)果類型，默認(rèn)是 array ，可選項(xiàng)為 string   自定義函數(shù)格式必須為 function(array $atts,object $refObj, array $fields);  在沒有指定 bind 綁定的函數(shù)的情況下，默認(rèn)指向 MakePublicTag($atts,$tpl->refObj,$fields) 統(tǒng)一管理，這個(gè)函數(shù)存放在 cls_dede_tplinc.php 。   (4) 固定塊標(biāo)記   [1] datalist  從綁定類成員函數(shù)GetArcList中獲取數(shù)組并輸出  {dede:datalist}  循環(huán)代碼  {/dede:datalist}  遍歷一個(gè)二給維數(shù)組，數(shù)據(jù)源是固定的，只適用用類調(diào)用。  等同于  {tag:blockname bind='GetArcList' bindtype='class' rstype='arrayu'}  循環(huán)代碼  {/tag:blockname}   [2] label  從綁定函數(shù)中獲取字符串值并輸出  等同于 {tag:blockname bind='func' bindtype='sub' rstype='string'/}   [3] pagelist   從綁定類成員函數(shù)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}這樣的語法 ，一般建議模板中不要使用太復(fù)雜的條件語法，如果確實(shí)有需要，可以直接使用 php 語法。   {dede:if 條件} a-block {else} b-block {/dede:if}   條件中允許使用 var.name 、 global.name 、 field.name、cfg.name 表示相應(yīng)的變量。   如：  {dede:if field.id>10 }  {/dede:if}   (8) 遍歷一個(gè) array 數(shù)組   {dede:array.name}  {dede:key/} = {dede:value/}  {/dede:array}   各種語法的具體編譯后的代碼，可查看 dede-template-class.php 的 function CompilerOneTag(&$cTag)。   塊調(diào)用示例代碼：  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 } } ?>

下一篇：