织梦教程-模板标签语法简介

模板标签语法简介

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

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

{dede:标记名称 属性=值/} {dede:标记名称 属性=值}{/dede:标记名称} {dede:标记名称 属性=值}自定义样式模板(InnerText){/dede:标记名称} {dede:标记名称commet=这是调用xxx变量标签 属性=值/}

提示:如果使用带底层模板的标记,必须严格用{dede:标记名称 属性=值}{/dede:标记名称} 这种格式,否则会报错。模板标签的属性,决定了模板标记输出的形式,例如arclist标签主要功能是列出文档列表,但列出什么内容、按照什么方式进行排序等取决于模板标签的属性。在织梦的模板标签说明中含有各个模板的标签属性可以详细查阅。

织梦标签的模板注释非常灵活,可以通过标签后面的commet属性进行赋值。在模板引擎将标签解析为html的时候,commet的内容是被忽略掉不去解析的,用户在阅读模板标记的时候可以更好的理解标签的意义。

2、织梦模板引擎内置多个系统标记,系统标记在任何模版中直接使用。

(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、织梦标记允许在任何标记中使用函数对得到的值进行处理,形式为:

{dede:标记名称 属性=值 function=youfunction(参数一,参数二,@me)/}

其中@me 用于表示当前标记的值,其它参数由你的函数决定是否存在,例如:

{dede:field name=pubdate function=strftime(%Y-%m-%d %H:%M:%S,@me)/}

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

格式为:

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

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

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