UECMS/模板概述
模板文件
- default是系统默认的主题包，在任何的用户自定义模版包中找不到配置的模版页，都会在default中查找同名模板文件替补；
- 主题名称必须为英文；
模板标签
<TagPrefix:TagName Param=value></TagPrefix:TagName>
标签决定数据的输出内容和位置。
- 注：TagPrefix表示标签前缀；TagName表示标签名称；Parem表示参数名称；value表示参数值。
标签语法结构
SXCMS标签由前缀、名称、参数组成，符合HTML标准的附加的方式，和HTML、XML标准兼容，标签不被浏览器解释， 并不会在页面的最终表现上被显示。
1、表示方法：
（1）参数的格式：
a：<TagPrefix:TagName Param=value></TagPrefix:TagName>
例：<mc:cns cid="2"></mc:cns>
b：<TagPrefix:TagName><Param>value</Param></TagPrefix:TagName>
例：<mc:cns><cid>2</cid></mc:cns>
通常，以上2种方式混合使用。如：
<TagPrefix:TagName Param=value><Param>value</Param></TagPrefix:TagName>
例：<mc:cns cid="3"><itemformat>栏目名称：{channelname}</itemformat></mc:cns>
对于复杂的参数使用嵌套方式表示。
在表达式中，嵌套式参数只有一个时，可以不指定参数名称，表示方式如：
<TagPrefix:TagName>value</TagPrefix:TagName>
一般情况下，多用于默认的输出格式参数Format或ItemFormat。
如：<mc:cns cid="3">栏目名称：{channelname}</mc:cns>
（2）多层嵌套:
UECMS标签支持多层嵌套,可以在一个标签内嵌套另一个标签, 如：<TagPrefix:TagName ><TagPrefix:TagName2 ></TagPrefix:TagName2></TagPrefix:TagName>
例，列出所有栏目的最新5个内容的标题：
<mc:cns>
栏目{channelname}最新5条内容：
<mc:list type="art"cids="{channelid}" pagesize="5">
内容标题：{subject}
</mc:list>
</mc:cns>
（3）默认参数：
ID：标签中默认都有ID参数，用以区别同一个模版页中相同类型的标签。
BeginTag和EndTag：
所有标签都包含输出参数BeginTag和EndTag，分别表示输出开始附加部分和输出结束的的附加部分。
Format：
单数据的标签中都包含输出参数Format，用以定义输出数据的字段及格式。
ItemFormat，AlternatingItemFormat
列表数据标签中都包含输出参数ItemFormat，AlternatingItemFormat，分别定义奇数和偶数行输出数据的字段及格式。
（4）跨站调用：
AJAX不支持跨域名的调用。系统提供了JS调用标签。输出格式（ItemFormat或Form）字符窜需要注册到script.config配置中。调用时用"formatkey"参数指定配置的名称
如：配置<form name="test">
</form> 调用时参数formatkey="test",其效果等同于非跨域名时设置： <itemformat>
</itemformat> 2、输出数据 指要输出的对象（文章或原型等）的字段，如标题，作者等。表示方式：{属性名称}。如，要输出标题：{subject}具体的属性名称，由内容模块提供。 （1）参数 输出字段包括4个可选的限定参数，表式格式如： {属性名称[,[l=长度] [r=替换] [t=日期格式化] [n=默认值] ]} 例1： 输出标题，并限定长度为14字，被截断后用"..."表示： {subject,l=28 r=...} 例2：输出发布时间，并指定日期形式： {dateline,t=MM月dd日} （2）特殊输出格式 加"tag=img"，则自动输出为图片格式，可设置参数，如：{subject,tag=img color=000000 family=Arial size=12 w=100 h=30}； 加"tag=js"，则自动输出为使用js方式调用； 加"tag=fun"，则把数据的值作为参数来执行指定的脚本； 加"tag=dat"，则调用数据流； （3）复杂对象属性的调用 一般的输出都是字符窜或可用字符窜来表示的值。对于复杂的输出属性，如在文章中输出栏目对象或图片集合，关键词集合等，可表示为<name></name>。 例1：在文章中输出栏目信息。
<mc:view>栏目：<channel>栏目名称：{channelname},栏目说明：{comment}.</channel></mc:view>
Channel是文章的一个属性。Channelname等是Channel的属性。
例2：文章中调用图片集合：
<mc:view>图片：<imagearray><img src="{imageurl}"/></imagearray ></mc:view>
输出图片组。
3、图片和附件
（1）缩略图显示
系统提缩略图供自动处理功能，4种可选方式，用参数s表示。
S=0表示，按比例缩小到合适的大小；
s=1表示，填充到指定大小，可能导致变形；
s=2表示，按比例缩小，并自动裁剪到指定大小；
s=3表示，按比例缩小到合适的大小，不足部分补白色背景。
通过地址显示图片：
<img src="/t.asxh?src=url&s=0/1/2&w=宽&h=高"/>
通过附件ID显示图片：
<img src="/a.asxh?a=id&s=0/1/2&w=宽&h=高"/>
例子：
两种方式分别显示文章标题图片
<mc:view>
<img src="/t.ashx?src={titleimageurl}&s=2&w=100&h=100"/>
<img src="/a.ashx?a={titleimage}&s=2&w=100&h=100"/>
</mc:view>
（2）附件下载
使用地址a.ashx?d=附件id
例子：
<a href="/a.ashx?id=6">点击下载</a>
UECMS使用手册导航 | |||||
|---|---|---|---|---|---|
|