无标题文档

元件(symbol)使用指南：文章列表　/symbol/article/list1.jsp
http://www.cms4j.com 2006-07-16

元件介绍

名称 | 标准文章列表显示元件
路径 | /symbol/article/list_1.jsp
继承 | cms4j:article
用途 | 与 cms4j:article 一样，此元件都能够让您显示某栏目的文章，而不同的是。此元件是对 cms4j:article 的再一次包装，她可以使您快速的将一个栏目的文章列表显示在指定的位置，而无须再去频繁调用cms4j:article标签，从而可以使得您的建站速度大大提升。

示例

<!--病毒公告-->
<jsp:include page="/symbol/article/list_1.jsp">
<jsp:param name="CLASS_ID" value="aqgg_xtldgg"></jsp:param>
<jsp:param name="PAGE_SIZE" value="4"></jsp:param>
<jsp:param name="ROW_HEIGHT" value="20"></jsp:param>
<jsp:param name="TITLE_LENGTH" value="20"></jsp:param>
<jsp:param name="IS_NEW_IMG" value="images/new.gif"></jsp:param>
<jsp:param name="ADD_DATE_FORMAT" value="MM-dd"></jsp:param>
<jsp:param name="SHOW_ADD_DATE_COLUMN" value="true"></jsp:param>
<jsp:param name="IS_SHOW_CLASS_NAME_COLUMN" value="false"></jsp:param>
<jsp:param name="IS_SHOW_PAGE" value="false"></jsp:param>
</jsp:include>

使用详解

1. | CLASS_ID 属性 | 指定显示某栏目的文章

<jsp:include page="/symbol/article/list_1.jsp"> <jsp:param name="CLASS_ID" value="栏目ID"></jsp:param> </jsp:include>

2. | FILTER 属性 | 条件过滤

属性可选值 | 功能
myadded | 我添加的文章
audited | 已审核的
auditing | 未审核的
ontop | 固顶
hot | 热点（热门）
commend | 推荐
summary_image | 所有带“首页图片”
today | 当日
month | 本月

示例：
<jsp:include page="/symbol/article/list_1.jsp"> <jsp:param name="CLASS_ID" value="栏目ID"></jsp:param> <jsp:param name="FILTER" value="ontop"></jsp:param> </jsp:include>

3. | ORDER 属性 | 排序

属性可选值 | 功能
[默认] | 添加日期降序
date_desc | 添加日期降序
date | 添加日期升序
clicks_desc | 点击量降序
clicks | 点击量升序
id_desc | ID降序
id | ID升序

示例
<jsp:include page="/symbol/article/list_1.jsp"> <jsp:param name="CLASS_ID" value="栏目ID"></jsp:param> <jsp:param name="ORDER" value="clicks"></jsp:param> </jsp:include>

4. | SCOPE 属性 | 过滤不同区域(回收站、正常)的文章

属性可选值 | 功能
[默认] | 取未被删除的文章，即正常的文章
all | 所有文章，包括“回收站”中的
recycle_bin | 回收站中的

示例
<jsp:include page="/symbol/article/list_1.jsp"> <jsp:param name="CLASS_ID" value="栏目ID"></jsp:param> <jsp:param name="SCOPE" value="recycle_bin"></jsp:param> </jsp:include>

5. | ARTICLE_ID 属性 | 指定显示某ID的文章
| <jsp:include page="/symbol/article/list_1.jsp"> <jsp:param name="ARTICLE_ID" value="10001"></jsp:param> </jsp:include>
6. | SPECIAL_ID 属性 | 指定显示哪些专题,多个专题之间用逗号分隔

<jsp:include page="/symbol/article/list_1.jsp"> <jsp:param name="SPECIAL_ID" value="cms4j,cms"></jsp:param> </jsp:include>

7. | KEY 属性 | 关键字过滤
| 在添加文章时，我们通常为文章指定一些关键字，而我们这时在显示的时候，就可以利用她进行显示一些相关文章。只需要在这里提供KEY值，就可以把所有拥有此关键字的文章显示出来 例如： <jsp:include page="/symbol/article/list_1.jsp"> <jsp:param name="KEY" value="内容管理"></jsp:param> </jsp:include>
8. | SEARCH 属性 | 文章查询，与 search_type 配合使用

与 search_type 一起使用，即可组成文章查询功能
例如：
<jsp:include page="/symbol/article/list_1.jsp">
<jsp:param name="SEARCH_TYPE" value="all"></jsp:param>
<jsp:param name="SEARCH" value="cms4j"></jsp:param>
</jsp:include>
上面的例子可以在所有文章中检索此包含“cms4j”的所有文章

9. | SEARCH_TYPE 属性 | 文章查询字段（类别）

属性可选值 | 功能
[默认] | 按标题查询
title | 按标题查询
content | 按内容查询
all | 按标题或内容查询

10. | TITLE_LENGTH 属性 | 新闻标题长度
| <jsp:include page="/symbol/article/list_1.jsp"> <jsp:param name="CLASS_ID" value="栏目ID"></jsp:param> <jsp:param name="TITLE_LENGTH" value="30"></jsp:param> </jsp:include> 即新闻取出后，只截取显示标题的前30个字符（一个汉字等于2个字符）
11. | PAGE_SIZE 属性 | 分页大小，也可视为取出多少条

<jsp:include page="/symbol/article/list_1.jsp">
<jsp:param name="CLASS_ID" value="cms"></jsp:param>
<jsp:param name="TITLE_LENGTH" value="30"></jsp:param>
<jsp:param name="PAGE_SIZE" value="10"></jsp:param>
</jsp:include>
在CMS栏目中，取出前10条新闻，并且截取新闻标题的前30个字符显示

12. | ROW_HEIGHT 属性 | 新闻列表每行高度

<jsp:include page="/symbol/article/list_1.jsp">
<jsp:param name="CLASS_ID" value="cms"></jsp:param>
<jsp:param name="TITLE_LENGTH" value="30"></jsp:param>
<jsp:param name="PAGE_SIZE" value="10"></jsp:param>
<jsp:param name="ROW_HEIGHT" value="20"></jsp:param>
</jsp:include>
在CMS栏目中，取出前10条新闻，并且截取新闻标题的前30个字符显示，每行高度为 20 px

13. | IS_NEW_IMG 属性 | 今日新闻 图标地址，显示在标题的后方，通常是个GIF动画

<jsp:include page="/symbol/article/list_1.jsp">
<jsp:param name="CLASS_ID" value="cms"></jsp:param>
<jsp:param name="TITLE_LENGTH" value="30"></jsp:param>
<jsp:param name="PAGE_SIZE" value="10"></jsp:param>
<jsp:param name="IS_NEW_IMG" value="images/new.gif"></jsp:param>
</jsp:include>
在CMS栏目中，取出前10条新闻，并且截取新闻标题的前30个字符显示，当新闻为今日新闻时，显示 images/new.gif 在标题的后面。

14. | ADD_DATE_FORMAT 属性 | 添加日期显示格式，通常显示在标题的后面

<jsp:include page="/symbol/article/list_1.jsp">
<jsp:param name="CLASS_ID" value="cms"></jsp:param>
<jsp:param name="TITLE_LENGTH" value="30"></jsp:param>
<jsp:param name="PAGE_SIZE" value="10"></jsp:param>
<jsp:param name="ADD_DATE_FORMAT" value="yyyy-MM-dd"></jsp:param>
</jsp:include>

15. | TARGET 属性 | 点击时，显示的目标，如点击时，在新窗口显示

此属性与HTML中的target属性值相同，如 TARGET="_blank" 即在新窗口打开
<jsp:include page="/symbol/article/list_1.jsp">
<jsp:param name="CLASS_ID" value="cms"></jsp:param>
<jsp:param name="TITLE_LENGTH" value="30"></jsp:param>
<jsp:param name="PAGE_SIZE" value="10"></jsp:param>
<jsp:param name="TARGET" value="_blank"></jsp:param>
</jsp:include>

16. | SHOW_ARTICLE_PAGE 属性 | 点击时，显示文章的页面URL

默认情况下，将从系统配置中取得文章查看页面的URL，并进行显示，您也可以指定一个URL进行文章的显示
<jsp:include page="/symbol/article/list_1.jsp">
<jsp:param name="CLASS_ID" value="cms"></jsp:param>
<jsp:param name="TITLE_LENGTH" value="30"></jsp:param>
<jsp:param name="PAGE_SIZE" value="10"></jsp:param>
<jsp:param name="SHOW_ARTICLE_PAGE" value="ShowArticle.jsp"></jsp:param>
</jsp:include>

17. | IS_SHOW_ADD_DATE_COLUMN 属性 | 是否在新闻的标题后显示新闻添加日期

<jsp:include page="/symbol/article/list_1.jsp">
<jsp:param name="CLASS_ID" value="cms"></jsp:param>
<jsp:param name="TITLE_LENGTH" value="30"></jsp:param>
<jsp:param name="PAGE_SIZE" value="10"></jsp:param>
<jsp:param name="IS_SHOW_ADD_DATE_COLUMN" value="true"></jsp:param>
</jsp:include>

18. | IS_SHOW_CLASS_NAME_COLUMN 属性 | 是否在新闻标题前方显示此新闻所属栏目

<jsp:include page="/symbol/article/list_1.jsp">
<jsp:param name="CLASS_ID" value="cms"></jsp:param>
<jsp:param name="TITLE_LENGTH" value="30"></jsp:param>
<jsp:param name="PAGE_SIZE" value="10"></jsp:param>
<jsp:param name="IS_SHOW_CLASS_NAME_COLUMN" value="false"></jsp:param>
</jsp:include>

19. | IS_SHOW_PAGE 属性 | 是否显示分页按钮

<jsp:include page="/symbol/article/list_1.jsp">
<jsp:param name="CLASS_ID" value="cms"></jsp:param>
<jsp:param name="TITLE_LENGTH" value="30"></jsp:param>
<jsp:param name="PAGE_SIZE" value="10"></jsp:param>
<jsp:param name="IS_SHOW_PAGE" value="true"></jsp:param>
</jsp:include>
当需要分页显示文章列表时，请使用此属性

20. | CSS 属性 | 标题的样式
| 此属性于HTML中的CSS属性方式一样，即您只需要将已定义好的CSS样式名称传递进来就可以使用其来显示文章列表。

版权所有： www.cms4j.com | 专业的 JAVA / JSP 版网站内容管理系统