元件(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 版网站内容管理系统