编辑“JEECMS的ArtiList标签使用实例”

<span style="text-align:center; border:1px solid #000; float:right; padding:6px;"><strong>导航:</strong> [[JEECMS|上一页]]</span>
<div style="clear:both;"></div>

【ArtiList 标签】在[[JEECMS]]中使用的频率可以说是最高的，通过这个标签，你不仅可以得到一个文章列表，而且可以通过不同的参数组合得到不同的显示效果。比如文章图文列表、文字或图片跑马灯、文字或图片上下循环滚动等等。

这里我们还是使用空白的首页[[模板]]（index_demo.html）来演示标签的用法。

*标签原型说明

【标签名】：[@cms. ArtiList属性='值' /]

【作  用】：获取文章列表数据

【参  数】：

{|border="1" align="center"
|-
! 属性名称||属性说明||默认值||可选值 
|-
| 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：蓝色双箭头 自定义图标：填写图标路径
|-
|lineHeigh
|文章列表每行的行高
|空
|自定义
|-
|ctgForm
|文章类别形式
|0
|0：不显示文章类别； 
1：显示栏目类别； 
2：显示站点名称
|-
|dateFormat
|文章发布日期显示格式
|0
|0：不显示日期 1：”年-月-日 时-分-秒” 格式 2：”年-月-日” 格式 3：”月-日 时-分” 格式
|-
|rollDisplayHeight
|显示区高度
|28
|自定义
|-
|rollLineHeight
|行高
|28
|自定义
|-
|rollCols
|列数（一行中包含几列）
|1
|自定义
|- 
|rollSpeed
|滚动速度，值越小越快，最小为1
|1
|自定义
|- 
|isSleep
|是否停顿
|1
|0：不停顿； 1：停顿
|-
|rollSleepTime
|停顿时间，值越大停顿越久
|50
|自定义
|-
|rollCount
|一次滚动的行数
|1
|自定义
|- 
|rollSpan
|一次滚动的像素
|1
|自定义
|}

其它高级标签属性（用于用户个性设置）
 
{|border="1" align="center"
|-
! 属性名称||属性说明||默认值||可选值 
|-
|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.ArtiList chnlId='' 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模板

*调试标签了解其使用方法

登录JEECMS后台，进入“模板管理templatearticledefault”,点击修改开始时建立的index_demo.html模板（如果没有此模板则按照本文开头的说明创建），在模板内容处填写如下标签代码（为了演示效果美观，本处代码中引入了系统默认[[css]]，可去除）：

'''文章列表'''

<link href="${sysResRoot}/front.css" type="text/css" rel="stylesheet" />
[@cms.ArtiList chnlId='' count='5' sysContent='1' titLen='25' lineHeight='1' dateFormat='4' datePosition='2' headMark='2' target='1'/]

点保存按钮，然后返回前台站点首页刷新，得到如下效果：

[[Image:Jeecms032701.jpg]]
 
'''图文列表'''

<link href="${sysResRoot}/front.css" type="text/css" rel="stylesheet" />
[@cms.ArtiList chnlId='' attr='5' count='5' sysContent='2' titLen='25' target='1' picWidth='25' picHeight='110'/]

点保存按钮，然后返回前台站点首页刷新，得到如下效果：

[[Image:Jeecms032702.jpg]]

[[category:标签|J]]
[[category:JEECMS|J]]
[[category:模板制作|J]]