DedeCMS模板标记功能简单介绍

手册/FAQ (534) 2015-08-01 10:37:54

在了解DedeCms的模板代码之前,了解一下织梦模板引擎的知识是非常有意义的。

 

DedeCms织梦模板引擎是一种使用XML名字空间形式的模板解析器,使用织梦解析器解析模板的最大好处是可以轻松的制定标记的属性,感觉上就像在用HTML一样,使模板代码十分直观灵活,新版的DedeCms织梦模板引擎不单能实现模板的解析还能分析模板里错误的标记。

 

1、织梦模板引擎的代码样式有如下几种形式:

 

{dede:标记名称 属性='值'/}

{dede:标记名称 属性='值'}{/dede:标记名称}

{dede:标记名称 属性='值'}自定义样式模板(InnerText){/dede:标记名称}

提示:如果使用带底层模板的标记,必须严格用{dede:标记名称 属性='值'}{/dede:标记名称} 这种格式,否则会报错。

 

2、DedeCMS织梦模板引擎内置有多个系统标记,这些系统标记在任何场合都是能直接使用的。

 

(1)、global 标记,表示获取一个外部变量,除了数据库密码之外,能调用系统的任何配置参数,形式为:{dede:global name='变量名称'}{/dede:global}或{dede:global name='变量名称'/},其中变量名称不能加 $ 符号,如变量 $cfg_cmspath ,应该写成 {dede:global name='cfg_cmspath'/} 。

(2)、foreach 用来输出一个数组,形式为:{dede:foreach array='数组名称'}[field:key/] [field:value/]{/dede:foreach}。

(3)、include 引入一个文件,形式为:{dede:include file='文件名称' ismake='是否为dede板块模板(yes/no)'/},对文件的搜索路径为顺序为:绝对路径、include文件夹,CMS安装目录,CMS主模板目录。

 

3、DedeCMS织梦标记允许在任何标记中使用函数对得到的值进行处理。

 

形式为:{dede:标记名称 属性='值' function='youfunction("参数一","参数二","@me")'/}
其中 @me 用于表示当前标记的值,其它参数由你的函数决定是否存在。如:{dede:field name='pubdate' function='strftime("%Y-%m-%d %H:%M:%S","@me")'/}

 

4、DedeCMS织梦标记允许有限的编程扩展。

 

格式为:

{dede:tagname runphp='yes'}
$aaa = @me;
@me = "123456";
{/dede:tagname} 

@me 表示这个标记本身的值,因此标记内编程是不能使用echo之类的语句的,只能把所有返回值传递给@me。

 

此外由于程序代码占用了底层模板InnerText的内容,因此需编程的标记只能使用默认的InnerText。

THE END