编辑“UECMS/模板概述”

{{UECMS top}}

'''模板文件'''

*[[模版]]主题包存放在目录/templets下，用于定制[[网站]]界面，主题包由模板和样式组成，多个主题可以并存，但只能设置一种当前主题风格；

*default是[[系统]]默认的主题包，在任何的用户自定义模版包中找不到配置的模版页，都会在default中查找同名模板文件替补；

*主题名称必须为英文；

'''模板标签'''

*模版页面都由[[HTML]]标准写成。模板[[标签]]（以下简称标签）的语法符合HTML标准，写法如:

<pre><TagPrefix:TagName Param=value></TagPrefix:TagName></pre>

标签决定数据的输出内容和位置。

*注：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"><li>{subject}</li></form>

调用时参数formatkey="test",其效果等同于非跨域名时设置：

<itemformat><li>{subject}</li></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：在文章中输出栏目信息。

<pre><mc:view>栏目：<channel>栏目名称：{channelname},栏目说明：{comment}.</channel></mc:view></pre>

Channel是文章的一个属性。Channelname等是Channel的属性。

例2：文章中调用图片集合：

<pre><mc:view>图片：<imagearray><img src="{imageurl}"/></imagearray ></mc:view></pre>

输出图片组。

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=高"/>

例子：

两种方式分别显示文章标题图片

<pre>
<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>
</pre>

（2）附件下载

使用地址a.ashx?d=附件id

例子：

<a href="/a.ashx?id=6">点击下载</a>


{{UECMS}}

== 参考来源 ==
*http://www.uecms.com/index.aspx

[[category:UECMS|M]]