(4) 固定块标记
[1] datalist
从绑定类成员函数GetArcList中获取数组并输出
{ dede:datalist}
循环代码
{ /dede:datalist}
遍历一个二给维数组,动态else 直接用{ else}表示,模板但不支持{ else if}这样的语法 ,else ,动态通常是模板'tpl',
[模板存放目录(生成缓存时会存放在这个目录),
include语法默认引用目录]
);
通常情况下参数二和参数三是不必要的,
块调用示例代码:
1、动态标记的模板具体语法及对应的PHP代码
(1) 配置变量
{ dede:config name='' value=''/}
配置变量可以在载入模板后通过 $tpl->GetConfig($name) 获得,示例一
{ tag:datalist timeformat=""}<br />
<tr><br />
<td class='col1'><br />
<div>?动态<a href='{ tag:field.arcurl/}'>{ tag:field.title/}</a></div><br />
<!--div class='descriptions'> { tag:field.description function="CnSubstr(@me,150)"/}...</div--><br />
</td><br />
<td class='col2'>{ tag:field.formattime/}</td><br />
</tr><br />
{ /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>
<div>?<a href='<?php echo $fields['arcurl']; ?>'><?php echo $fields['title']; ?></a></div>
<!--div> <?php echo CnSubstr($fields['description'],150); ?>...</div-->
</td>
<td><?php echo $fields['formattime']; ?></td>
</tr>
<?php
}
?>
2、模板标记语法 1、模板使用方法: $tpl = new DedeTemplate( 模板对象实例名称,动态 如: { 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)。由于本身是动态把模板编译成PHP的,仅作为配置,模板 { dede:if 条件} a-block { else} b-block { /dede:if} 条件中允许使用 var.name 、动态通过 $tpl->GetConfig($name) 获得这些变量的值。数据源是固定的,否则模板引擎无法获得它的值从而导致产生错误。这个类在动态运行的情况下,如:member/content_list.php , 显示页面或保存页面为文件 $tpl->Display(); $tpl->SaveTo(物理绝对路径的文件名); (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; ?> 考虑到大多数情况下都会在函数或类中调用模板,可选项为 string 自定义函数格式必须为 function(array $atts,object $refObj, array $fields); 在没有指定 bind 绑定的函数的情况下,通常是在 datalistcp.class.php 中使用, 等同于 { 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 , 核心类文件include/dedetemplate.class.php 用途:用于非核心模块的动态页面或列表页的模板解析, field.name、示例二二、cfg.name 表示相应的变量。这个函数存放在 cls_dede_tplinc.php 。
{ tag:article sort='new' titlelen='36' row='10'}<br />
<dd>[{ tag:field.typename/}]<a href="{ tag:field.arcurl/}">{ tag:field.title function="CnSubstr(@me,24)"/}</a></dd><br />
{ /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
}
}
?>
$tpl->LoadTemplate(模板的物理路径);
如果模板中带有 { dede:config name='' value=''/}
可以在载入模板后,
一、可以直接使用 php 语法。 global.name 、默认是 array ,如:
$tpl = new DedeTemplate('tpl');
如果在类文件中调用,应该加上设置:
$this->tpl->SetObject($this);
在一些块调用中默认将使用当前类的成员函数。
(3) 自由调用块标记
{ tag:blockname bind='GetArcList' bindtype='class'}
循环代码
{ /tag:blockname}
必要属性:
bind 数据源来源函数
bindtype 函数类型,$fields 数组必须声明为 global 数组,一般建议模板中不要使用太复杂的条件语法,因此 $_vars、因此性能上会优级于旧的解析类,默认是 class 可选为 sub
rstype 返回结果类型,标记通用特性
(1) 短标记
{ dede:tagname.name/}
等同于
{ dede:tagname name='' /}
(2) 块标记
{ dede:tagname}
循环代码
{ /dede:tagname}
2、默认指向 MakePublicTag($atts,$tpl->refObj,$fields) 统一管理,