JEECMS的ArtiList标签使用实例
导航: 上一页
【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：蓝色双箭头 自定义图标：填写图标路径 |
| 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 | 自定义 |
其它高级标签属性（用于用户个性设置）
| 属性名称 | 属性说明 | 默认值 | 可选值 |
|---|---|---|---|
| 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后台，进入“模板管理templatearticledefault”,点击修改开始时建立的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'/]
点保存按钮，然后返回前台站点首页刷新，得到如下效果：
图文列表
<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'/]
点保存按钮，然后返回前台站点首页刷新，得到如下效果：
