include/dedetemplate.class.php

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

  1. $tpl = new DedeTemplate(
  2.     模板对象实例名称，通常是'tpl',
  3.     [模板存放目录（生成缓存时会存放在这个目录）,
  4.     include语法默认引用目录]
  5. );

通常情况下参数二和参数三是不必要的，如：

  1. $tpl = new  DedeTemplate('tpl');

如果在类文件中调用，应该加上设置：

  1. $this->tpl->SetObject($this);

在一些块调用中默认将使用当前类的成员函数。

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

{dede:config name='' value=''/} 可以在载入模板后，通过 $tpl->GetConfig($name) 获得这些变量的值。 显示页面或保存页面为文件

  1. $tpl->Display();
  1. $tpl->SaveTo(/*物理绝对路径的文件名*/);
  1. {dede:tagname.name /}

等同于

  1. {dede:tagname name='' /}
  1. {dede:tagname}
  2.     循环代码...
  3. {/dede:tagname}
  1. {dede:config name='' value='' /}

$tpl->GetConfig($name) 获得，仅作为配置，不在模板中显示。

  1. {dede:global.name /}

<?php echo $name; ?>

  1. {dede:var.name /}

<?php echo $_vars['name']; ?>

  1. {dede:field.name /}

<?php echo $fields['name']; ?>

  1. {dede:cfg.name/}

<?php echo $cfg_name; ?> $_vars 、$fields 数组必须声明为 global 数组，否则模板引擎无法获得它的值从而导致产生错误。

  1. {tag:blockname bind='GetArcList'  bindtype='class'}
  2.     循环代码
  3. {/tag:blockname}
​
  • class 可选为 sub
  • array ，可选项为 string 。 function(array $atts,object $refObj, array $fields); 在没有指定 bind 绑定的函数的情况下，默认指向 MakePublicTag($atts,$tpl->refObj,$fields) 统一管理。
​

GetArcList 中获取数组并输出

  1. {dede:datalist}
  2.     循环代码
  3. {/dede:datalist}

遍历一个二维数组，数据源是固定的，只适用用类调用。等同于

  1. {tag:blockname bind='GetArcList' bindtype='class' rstype='arrayu'}
  2.     循环代码
  3. {/tag:blockname}
​

从绑定函数中获取字符串值并输出。等同于

  1. {tag:blockname bind='func' bindtype='sub' rstype='string'/}
​

GetPageList 中获取字符串值并输出。等同于

  1. {tag:blockname bind='GetPageList' bindtype='class' rstype='string'/}
​
  1. {dede:include file='文件路径'/}

或

  1. {dede:include filename='文件路径'/}
​
  1. {dede:php php代码... /}

或

  1. {dede:php}
  2.     php代码...
  3. {/dede:php}
​

if ，else ，else 直接用 {else} 表示，但不支持 {else if} 这样的语法 ，一般建议模板中不要使用太复杂的条件语法，如果确实有需要，可以直接使用 php 语法。

  1. {dede:if 条件}
  2.     a-block
  3. {else}
  4.     b-block
  5. {/dede:if}

var.name 、global.name 、field.name 、cfg.name 表示相应的变量。 如：

  1. {dede:if field.id>10 }
  2.     ......
  3. {/dede:if}
​
  1. {dede:array.name}
  2.     {dede:key/} = {dede:value/}
  3. {/dede:array}

dedetemplate.class.php 中的 function CompilerOneTag(&$cTag) 函数。