JEECMS标签使用.docx
- 文档编号:18223403
- 上传时间:2023-08-14
- 格式:DOCX
- 页数:24
- 大小:379.77KB
JEECMS标签使用.docx
《JEECMS标签使用.docx》由会员分享,可在线阅读,更多相关《JEECMS标签使用.docx(24页珍藏版)》请在冰点文库上搜索。
JEECMS标签使用
以下部分标签仅供JEECMSv1.x系列版本参考使用
标签是JEECMS中的重要概念,上一讲中,我们介绍了模板,并且说模板就像试卷,不同的考生填入不同的内容,就形成了不同的页面。
这一点在模板中是怎么实现的呢?
简单起见,我们先考虑一下内容页模板,下面是一个简单的内容页模板:
${新闻标题}
${新闻内容}
这是不是有点像考试卷呢?
在${}中就是考生要填入的内容,在JEECMS中这部分内容会根据您录入的新闻,自动填入。
下面是一个真正的模板:
${arti.titleContent}
${arti.content}
是不是很简单呢?
是的,使用JEECMS建站,一切都是那么简单。
现在来看看栏目页模板,栏目页是一个栏目的封面,其中最基本的一个需求就是,能够显示这个栏目的新闻列表;否则浏览者无法看到这个栏目的实际内容。
看一个最简单的栏目页:
超强台风蔷薇逼近台湾 神七将进行卫星数据中继试验 美国国会解除近海石油开采禁令
下面是实现这个效果的模板:
[@u.ArtiListcount='3'/]
其中[@u.ArtiListcount='3'/]是我们看到的第二种标签,这种标签具有强大的能力,可以传递参数,count='3'是指读取本栏目最新的三条新闻。
【标签名】:
[@u.include'参数-1'/]
【作 用】:
包含公用页面(如页头,页脚)
【参 数】:
“包含模板”的名称
【示 例】:
//包含页头:
[@u.include'head'/]
//包含页脚:
[@u.include'foot'/]
【备 注】:
调用此标签前必须先建立“包含模板”
【标签名】:
[@u.ArtiHrefid='参数-1'isRaw='参数-2'/]
【作 用】:
根据文章ID获取文章url地址
【参 数】:
1、 id—-文章ID
2、 isRaw---是否只生成文章url地址,0为生成链接及文章标题,1为只生成文章url地址,默认为0
【示 例】:
//只生成文章url地址:
//生成链接及文章标题:
[@u.ArtiHrefid='123'isRaw='0'/]
【备 注】:
此标签前必须在代码编辑模式下操作,参数带单引号
【标签名】:
[@u.ArtiListid='参数-1’count='参数-2’length='参数-3’listStyle='参数-4’isTopic='参数-5’isPage='参数-6’target='参数-7’/]
【作 用】:
根据文章类别ID获取文章列表
【参 数】:
1、 id—-文章类别id,该参数若不填写则自动取当前栏目数据,该参数为-1则读取全站数据,读取多个栏目用逗号分割。
id为一个时,会读取该栏目下子栏目数据;有多个ID时,不读取子栏目数据。
2、 count---每页显示数量,默认为10条
3、 length---文章标题长度,默认显示20个字符
4、 isTopic---是否专题。
用于专题页。
【0:
否;1:
是】(默认0)
5、 isPage---是否显示分页【0:
否;1:
是】(默认0)
6、 target---链接打开方式。
【0:
在当前页打开;1:
在新页面打开】(默认1)
7、 listStyle---文章显示样式【1:
标题列表;2:
图文列表;3:
标题列表向上滚动;4:
图文列表向上滚动;5:
列表跑马灯;6图文跑马灯】(默认1)
标题列表:
【listSytle=1】
ico:
标题图标;
headMark:
标题头;有ico时,该参数忽略。
【0:
无;1:
小方点;2:
单箭头;3:
双箭头】(默认1)
headMarkColor:
标题头颜色;主要用于小方点。
(默认000000)
lineHeight:
行高;单位为像素。
(默认5)
bottomLine:
标题底部是否有线条【0:
无线条;1:
有线条】(默认0)
dateStyle:
文章时间显示样式(默认显示完整时间;0:
不显示日期时间;1:
按"yy-MM-dd"样式显示日期,2:
按"HH:
mm:
ss"样式显示时间,3:
按"MM-dd"样式显示日期);
ctgForms:
文章类别形式【0:
不显示文章类别;1:
显示栏目类别;2:
显示站点名称】(默认0);
ctgClass:
文章类别的css-class;
图文列表:
【listSytle=2】
picWidth:
按百分比显示图片宽度(默认为25;即每个图片占总宽度的25%,每行可放四张图片);
picHeight:
每行图片显示高度。
(默认180);
带显示效果的文章列表【listSytle=3|4|5|6】
listSytle=3、4
cols:
列数。
一行中包含几列。
(默认1)
rlineHeight:
行高。
(默认28)
rdisplayHeight:
显示区高度。
(默认28)
speed:
速度。
越小越快,最小为1。
(默认50)
isSleep:
是否停顿。
【0:
不停顿;1:
停顿】(默认1)
sleepTime:
停顿时间。
越大越久。
(默认50)
rollCount:
一次滚动的行数。
(默认1)
rollSpan:
一次滚动的像素。
(默认1)
#listSytle=3(ico,headMark,headMarkColor,dateStyle有效)
#listSytle=4()
#listSytle=5(dateStyle,rollListId,speed,rollSpan有效)
#listSytle=6(rlineHeight,rollListId,speed,rollSpan有效)
picDistance:
图片间距。
(默认20)
【示 例】:
//文章标题列表:
[@u.ArtiListid='326'lineHeight='3'headMark='2'count='5'length='30'dateStyle='3'bottomLine='1'listStyle='1'isPage='0'target='1'/]
//带自定义图标的文章标题列表:
[@u.ArtiListico="${root}/br.jpg"count='10'length='30'dateStyle='3'bottomLine='1'listStyle='1'isPage='1'target='1'/]
//文章图文列表:
[@u.ArtiListid='325'count='4'length='10'dateStyle='0'listStyle='2'picWidth='25'picHeight='100'/]
【备 注】:
此标签前必须在代码编辑模式下操作,各参数排列不分先后
【标签名】:
[@u.ChnlListid='参数-1'isContainSelf='参数-2'listStyle='参数-3'parentClass='参数-4'childClass='参数-5'parentTarget='参数-6'childTarget='参数-7'custom='参数-8'listStyle='参数-9'/]
【作 用】:
根据栏目ID获取子栏目链接
【参 数】:
1、 id—-栏目ID
2、 isContainSelf---是否包含父栏目。
【0:
不包含;1:
包含】(默认0)
3、 parentClass---父栏目class
4、 childClass---子栏目class
5、 parentTarget---父栏目链接打开方式
6、 childTarget---子栏目链接打开方式
7、 custom---自定义样式。
主要用于片段模板自定义(默认0)
8、 listStyle---列表样式【1:
下拉菜单】(默认1),当listStyle=1时必须使参数isContainSelf=1
【示 例】:
//获取栏目ID为123的子栏目链接:
[@u.ChnlListid='123'isContainSelf='0'parentClass='style1'childClass='style2'parentTarget='_self'childTarget='_self'custom='0'listStyle='1'/]
【备 注】:
此标签前必须在代码编辑模式下操作,参数排列不分先后
【标签名】:
[@u.ChnlHrefid='参数-1'linkBody='参数-2'isRaw='参数-3'target='参数-4'title='参数-5'class='参数-6'style='参数-7'/]
【作 用】:
根据栏目ID获取栏目链接
【参数】:
1、 id—-栏目ID
2、 linkBody---是否有链接体。
没有,使用栏目名为链接体;1:
有,使用标签体作为链接体】(默认0)
3、 isRaw:
是否纯链接。
【0:
不是,带有a标签;1:
是,只显示链接地址】(默认0)
4、 target:
打开方式。
【0:
原窗口打开;1:
新窗口打开】(默认0)
5、 title、style、class---这三个参数与html标签中的title、style、class属性作用相同
【示例】:
//获取栏目ID为123的栏目链接:
[@u.ChnlHrefid='123'isRaw='0'linkBody='0'target='1'title='关于我们'class='style2'style='border:
#ccc1pxsolid;'/]
【备注】:
此标签前必须在代码编辑模式下操作,参数排列不分先后
【标签名】:
1、 栏目名称:
${chnl.name}
2、 文章标题:
${arti.titleContent}
3、 作 者:
${arti.author}
4、 发布日期:
${arti.releaseDate}
5、 查看次数:
${arti.visitTotal}
6、 文章内容:
${arti.content} --------(不分页)
${arti.artiPage.content}--------(分页)
分页栏:
[@u.ContentPage/]
7、文章页传递参数:
${arti.param1!
}、${arti.param2!
}、${arti.param3!
}
【示 例】:
//利用标签组成一个常用的页面导航:
当前位置:
【备 注】:
此标签前必须在代码编辑模式下操作,参数排列不分先后
【标签名】:
[@u.Flashpath='参数-1'width='参数-2'height='参数-3'/]
【作 用】:
显示flash,并且消除flash的虚边框
【参 数】:
1、 path—-flash文件的资源路径(${root}表示网站资源根目录)
2、 width---flash显示的宽度
3、 height---flash显示的高度
【示 例】:
//显示资源根目录下名为qq.swf的flash文件,宽度为748像素,高度为120像素:
[@u.Flashpath='${root}/qq.swf'width='748'height='120'/]
【备 注】:
此标签前必须在代码编辑模式下操作,参数排列不分先后
【标签名】:
[@u.CurrentPositionhomepage='参数-1'title='参数-2'split='参数-3'isParentWebsite='参数-4'target='参数-5'class='参数-6'style='参数-7'/]
【作 用】:
显示页面的当前位置,效果:
“当前位置:
首页>JEECMS教程>环境搭建>正文”
【参 数】:
1、 homepage—-首页显示方式。
【1:
站点简称;自定义】(默认:
首页)
2、 title---内容页显示方式。
【0:
不显示;1:
显示内容标题;自定义】(默认:
正文)
3、 split---分割符号。
(默认:
“>”)
4、 target---是否原窗口打开。
【0:
原窗口打开;1:
新窗口打开】(默认:
原窗口打开)
5、 class---链接外部样式,等同于html中的class属性
6、 style---自定义标签样式,等同于html中的style属性
【示 例】:
//显示内容页的当前位置:
[@u.CurrentPosition/]
最终效果:
当前位置:
首页>JEECMS教程>环境搭建>正文
【备 注】:
此标签前必须在代码编辑模式下操作,参数排列不分先后,只能用于栏目页和内容页,对于搜索、留言这样的页面此标签无效。
【文章导航】:
[@cms.Position/]
【文章标题】:
${arti.title}
【简短标题】:
${arti.shortTitle}
【文章作者】:
${arti.author}
【发布日期】:
${arti.releaseDate}
【查看次数】:
${arti.visitTotal}
【文章来源】:
${arti.origin}
【文章摘要】:
${arti.description}
【文章内容】:
[@cms.ArtiContent/]
【内容分页】:
[@cms.SysPagestyle=’2’/]
【ArtiList标签】在JEECMS中使用的频率可以说是最高的,通过这个标签,你不仅可以得到一个文章列表,而且可以通过不同的参数组合得到不同的显示效果。
比如文章图文列表、文字或图片跑马灯、文字或图片上下循环滚动等等。
这里我们还是使用空白的首页模板(index_demo.html)来演示标签的用法。
一、 标签原型说明
【标签名】:
[@cms.ArtiList属性='值'/]
【作 用】:
获取文章列表数据
【参 数】:
属性名称
属性说明
默认值
可选值
chnlId
栏目ID,栏目页中可不设置,系统会自动获取当前栏目ID
当前栏目ID
空:
显示全站文章列表;
栏目ID:
指定栏目文章列表
attr
文章属性ID
空
后台自定义
sysContent
列表显示方式
1-1
1-1:
普通标题列表显示;
1-2:
图文列表显示;
3-1:
焦点图显示;
2-1:
标题列表翻滚显示
2-2:
图文列表翻滚显示
orderBy
排序方式
0
0:
发布时间降序;
1:
发布时间升序;
2:
点击次数降序;
3:
点击次数升序
recommend
是否推荐
0
0:
所有文章
1:
推荐文章
titLen
标题长度
20
自定义
target
链接打开目标
0
0:
原窗口打开
1:
新窗口打开
headMark
文章标题图标
0
0:
无图标
1:
黑色小圆点
2:
红色小圆点
3:
蓝色单箭头
4:
蓝色双箭头
自定义图标:
填写图标路径
lineHeight
文章列表每行的行高
空
自定义
bottomLine
每行标题下是否带分隔线
0
0:
无分隔线
1:
有分隔线
ctgForm
文章类别形式
0
0:
不显示文章类别;
1:
显示栏目类别;
2:
显示站点名称
ctgClass
文章类别的css-class
空
自定义css样式的class名称
dateFormat
文章发布日期显示格式
0
0:
不显示日期
1:
”年-月-日时-分-秒”格式
2:
”年-月-日”格式
3:
”月-日时-分”格式
4:
”月-日”格式
datePosition
日期排列位置
1
1:
紧跟标题之后
2:
右对齐
3:
左对齐
isPage
是否显示分页
0
0:
否;1:
是
count
每页列表显示数量
20
自定义
仅当sysContent=2(图文列表)时,以下标签属性才有效
picWidth
按百分比显示图片宽度
25(即每个图片占总宽度的25%,每行可放四张图片)
自定义
picHeight
每行图片显示高度
110
自定义
仅当sysContent=3(焦点图)时,以下标签属性才有效
flashWidth
焦点图宽度
296(px)
自定义
flashHeight
焦点图总高度
200(px)
自定义
textHeight
焦点图文本高度
20(px)
自定义
仅当sysContent=4或5(文字、图片滚动)时,以下标签属性才有效
rollDisplayHeight
显示区高度
28
自定义
rollLineHeight
行高
28
自定义
rollCols
列数(一行中包含几列)
1
自定义
rollSpeed
滚动速度,值越小越快,最小为1
1
自定义
isSleep
是否停顿
1
0:
不停顿;
1:
停顿
rollSleepTime
停顿时间,值越大停顿越久
50
自定义
rollCount
一次滚动的行数
1
自定义
rollSpan
一次滚动的像素
1
自定义
其它高级标签属性(用于用户个性设置)
searchKey
在标题、tags和描述中搜索指定关键字的文章列表,用于搜索页模板
空
自定义关键字
style
标签内部样式,如果指定sysContent或userContent,则该项无效
1
1:
普通列表
sysTpl
指定系统模板
1
自定义
sysContent
系统内容样式
0
自定义
userContent
用户内容样式,当sysContent=1时有效
空
自定义
sysPage
系统分页样式
0
自定义
userPage
用户分页样式,当sysPage=1时有效
空
自定义
upSolution
指定其它模板方案样式
空
自定义
upWebRes
指定其它站点样式
空
自定义
pageClass
分页栏css样式的class名称
空
自定义
pageStyle
分页栏css自定义style样式
空
自定义
custom
用户扩展属性集合
空
自定义
【示 例】:
[@cms.ArtiListchnlId=''count='5'sysContent='1-1'titLen='25'lineHeight='1'dateFormat='4'datePosition='2'headMark='2'target='1'/]
【备 注】:
在代码模式下编辑,各属性值必须使用单引号,属性排列顺序不分先后。
二、 明确标签使用范围
我们在使用任何标签的之前,都必须明确其使用的范围,否则可能无法正常使用该标签。
【ArtiList标签】的使用范围是:
首页模板,栏目页模板,内容页模板,
即对应\WEB-INF\user_base\jeecms_com_www\template\article\default\文件夹下的index_识别ID.html模板、channel_识别ID.html模板、content_识别ID.html模板
三、 调试标签了解其使用方法
default”,点击修改开始时建立的index_demo.html模板(如果没有此模板则按照本文开头的说明创建),在模板内容处填写如下标签代码(为了演示效果美观,本处代码中引入了系统默认css,可去除):
articletemplate登录JEECMS后台,进入“模板管理
(1).文章列表
[@cms.ArtiListchnlId=''count='5'sysContent='1'titLen='25'lineHeight='1'dateFormat='4'datePosition='2'headMark='2'target='1'/]
点保存按钮,然后返回前台站点首页刷新,得到如下效果:
(2).图文列表
[@cms.ArtiListchnlId=''attr='5'count='5'sysContent='2'titLen='25'target='1'picWidth='25'picHeight='110'/]
点保存按钮,然后返回前台站点首页刷新,得到如下效果:
如果对本教程还是有疑问的地方,请到JEECMS交流群中大家一起讨论。
在JEECMS中自带一个投票系统,用户可以自定义投票主题及投票方式。
投票系统和留言板都属于JEECMS的辅助系统(auxiliary),在后台都有对应的模板可以控制显示样式。
投票系统有投票列表显示模板和投票结果显示模板,分别对应后台管理中“模板管理->template->auxiliary->default->tag_VoteTopic.html”、“模板管理->template->auxiliary->default->sys_VoteResult.html”,用户可自行修改显示样式。
一、标
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- JEECMS 标签 使用