标签语法

DTcms 模板语法和C#非常接近,4.0和3.0版本中,标签语法大同小异,依然符合于技术开发人员的编程习惯。如果你是一名程序员,下面的语法我相信只需要看一次便可牢牢记住各种标签的使用规则,所以你不必担心DTcms模板难掌握。如果非程序员,难度有所加大,毕竟我们考虑到了整个系统的扩展性和二次开发,所以比较偏向于技术开发人员。

页面嵌套标签

如果想在一个模板页面中嵌入另一个模板页的内容可使用该标签,注意避免被嵌套的页面嵌套主模板页,这样会造成迭代循环。另外,嵌套的深度最多只能5层。其中src所指定的路径为当前相对路径,如src="common/_header.html"

<!--一般在当前模板下使用可下面的嵌套标签-->
<%template src="模板页面相对路径"%>

<!--如需跨模板访问可使用下面的嵌套标签,一般插件模板使用较多,前提该模板须存在,否则访问不到-->
<%template skin="模板目录名" src="模板页面相对路径"%> 

当前模板路径标签

因为3.0版本中增加分站的功能,所以这里和2.1及前版本的模板标签有所不同。输出不包含/,如:templates/green/images/logo.png,同一模板目录下使用第一个种标签即可

<!--当前模板路径标签-->
<%templateskin%>  <!--访问其它模板的路径标签,前提该模板须存在-->
<%templateskin="模板目录名"%> 

嵌入C#代码标签

如果其它标签无法实际你想要的效果,你可以试一下直接写C#代码,如意不能使用Response.Write

<%csharp%>
  //C#代码
<%/csharp%> 

引用命名空间标签

如果需要引用命名空间则需要使用该标签,注意此标签不能放在嵌套的页面且需要放置在模板页的最顶部

<!--示例:<%namespace "DTcms.BLL"%>-->
<%namespace "命名空间"%>  

普通变量标签

模板页的变量概念实际上就是C#的变量,在模板页调用时需加上大括号,这里往往和模板页的JS的方法体互相冲突,所以在写JS时,遇到大括号一定要换行。

<!--直接变量-->
{varname}

<!--实体变量,如:{config.webname}-->
{var.item}

数据变量标签

数据变量一般在循环列表时使用到,另外在显示内容时也会用到

<!--循环列表时的数据变量,如:{dr[title]}-->
{var[...]}

<!--显示实体数据变量,如:model.fields[title]-->
{var.item[...]}

loop循环标签

loop循环标签主要是数据列表中使用的,其中自带有行号变量datarow__loop__id,该变量是从1开始

参数说明:

datarow:DataRow类型的变量,同一页面内不可重复,否则编译出错

datatable:DataTable类型的变量,使用前请确保该参数已声明赋值

<!--loop循环标签-->
<%loop datarow datatable%>
  ...
<%/loop%>

foreach循环标签

foreach标签和C#的语法是一样的,写法也差不多,相信技术人员一看就懂。注意与loop标签不同的是它没有自带的行号变量,需要手动声明。

参数说明:

type:数据类型,如DataRow

item:数据类型的变量名,自定义变量名

list:数组、结构、对象、引用类型

<!--foreach循环标签-->
<%foreach(type item in list)%>
  ...
<%/foreach%>

for循环标签

for标签和C#的语法也是一样的,一般很少用到。

参数说明:

i:整型变量

count:整型变量

<!--for循环标签-->
<%for(int i=0;i<=count;i++)%>
  ...
<%/for%>

if判断语句标签

if判断语句与C#的语法一样,3.0支持二种写法,保留旧的写法

<!--第一种格式写法(推荐)-->
<%if(...)%>
  ...
<%else if(...)%>
  ...
<%/if%>

<!--第二种格式写法(旧写法)-->
<%if ...%>
  ...
<%else if ...%>
  ...
<%/if%>

continue退出当前循环标签

循环标签中分支用以结束当前循环,直接进入下一次循环的标签,使用方式同传统程序一致。

<!--continue标签-->
<%continue%>

<!--使用示例,当i等于5时退回并进入下一条循环-->
<%for(int i=0;i<=count;i++)%>
  <%if(i==5)%>
    <%continue%>
  <%/if%>
<%/for%>

break结束循环标签

在循环标签中用以结束循环,进入后续程序的标签,使用方式同传统程序一致 。

<!--break标签-->
<%break%>

<!--使用示例,当i大于5时结束循环-->
<%for(int i=0;i<=count;i++)%>
  <%if(i>5)%>
    <%break%>
  <%/if%>
<%/for%>

获取GET传输参数标签

获取URL地址GET传输的参数值

<!--request标签,varname为参数名-->
{request[varname]}

截取字符串长度标签

当一个字符串的长度大于你想要的值时可使用该标签

参数说明:

num:int类型,字符串长度

<!--cutstring标签,{...}为变量-->
<%cutstring({...},num)%>

日期格式转换标签

把日期字符串转换成你想要的格式

参数说明:

strFormat:日期格式

<!--datetostr标签,{...}为变量-->
<%datetostr({...},strFormat)%>

<!--示例一:输出年月日格式的日期-->
<%datetostr({varname},yyyy年MM月dd日)%>

<!--示例二:输出年月日时分秒格式的日期-->
<%datetostr({varname},yyyy年MM月dd日HH时mm分ss秒)%>

整型格式转换标签

当一个字符串的想转换成一个整型的数字时可使用该标签

<!--strtoint标签,{...}为字符串变量-->
{strtoint({...})}

直接输出内容标签

当一个方法返回的是字符串内容,而我们又想直接在模板页中直接输出可使用该标签。该标签支持两种写法,推荐用第一种。

<!--第一种写法(推荐)-->
<%=方法名(参数一,参数二,...)%>

<!--第二种写法(旧写法)-->
<%write 方法名(参数一,参数二,...)%> 

1.5 声明变量与赋值标签

和C#语法基本一致,需要声明或在需要接受一个方法返回的内容时可以使用该标签。

参数说明:

type:可选,变量的类型,如果有type则首先创建对象再赋值,否则直接赋值

ref:变量名,同一页面内不可重复

expression:变量、常量或方法都可以

<!--第一种写法(推荐)-->
<%set [type] ref=expression%>

<!--示例一-->
<%set int num=1%>
<!--再次使用时不用再声明-->
<%set num=2%>

<!--示例二-->
<%set DataTable dt=get_list(参数一,参数二,...)%>
<!--第二种写法(旧写法)-->
<%set [(type)]{ref}=expression%>

<!--示例一-->
<%set (int){num}=1%>
<!--再次使用时不用再声明-->
<%set {num}=2%>

<!--示例二-->
<%set (DataTable){dt}=get_list(参数一,参数二,...)%>

微信扫一扫