TagSupport与BodyTagSupport的区别 及自定义标签的高级用法


部分内容来自

from:http://dongguoh.iteye.com/blog/100782

1 TagSupport与BodyTagSupport的区别

 TagSupport与BodyTagSupport的区别主要是标签处理类是否需要与标签体交互,如果不需要交互的就用TagSupport,否则如果需要交互就用BodyTagSupport。

     交互就是标签处理类是否要读取标签体的内容和改变标签体返回的内容。

    用TagSupport实现的标签,都可以用BodyTagSupport来实现,因为BodyTagSupport继承了TagSupport。

 2 doStartTag(),doEndTag()

   doStartTag()方法是遇到标签开始时会呼叫的方法,其合法的返回值是EVAL_BODY_INCLUDE与SKIP_BODY,前者表示将显示标签间的文字,后者表示不显示标签间的文字;doEndTag()方法是在遇到标签结束时呼叫的方法,其合法的返回值是EVAL_PAGE与 SKIP_PAGE,前者表示处理完标签后继续执行以下的JSP网页,后者是表示不处理接下来的JSP网页

    doAfterBody(),这个方法是在显示完标签间文字之后呼叫的,其返回值有EVAL_BODY_AGAIN与SKIP_BODY,前者会再显示一次标签间的文字,后者则继续执行标签处理的下一步。

   预定的处理顺序是:doStartTag()返回SKIP_BODY,doAfterBodyTag()返回SKIP_BODY,doEndTag()返回EVAL_PAGE.

  如果继承了TagSupport之后,如果没有改写任何的方法,标签处理的执行顺序是:

   doStartTag() ->不显示文字 ->doEndTag()->执行接下来的网页

  如果您改写了doStartTag(),则必须指定返回值,如果指定了EVAL_BODY_INCLUDE,则执行顺序是

   doStartTag()->显示文字->doAfterBodyTag()->doEndTag()->执行下面的网页

display.tld 源码

xml 代码
  1. <!---->xml version="1.0" encoding="gbk" ?>  
  2. <!---->
  3.   PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN"   
  4.   "http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd">  
  5. <taglib>  
  6.     <tlibversion>1.0tlibversion>  
  7.     <jspversion>2.4jspversion>  
  8.     <shortname>测试程序shortname>  
  9.     <uri>uri>  
  10.     <info>测试程序info>  
  11.     <tag>  
  12.         <name>displayname>  
  13.         <tagclass>test.DisplayTagtagclass>  
  14.         <!---->  
  15.            
  16.            
  17.     tag>  
  18. taglib>  

DisplayTag.java 源码

java 代码
  1. package test;   
  2.   
  3. import java.io.IOException;   
  4.   
  5. import javax.servlet.jsp.JspException;   
  6. import javax.servlet.jsp.JspWriter;   
  7. import javax.servlet.jsp.tagext.TagSupport;   
  8.   
  9. public class DisplayTag extends TagSupport {   
  10.   
  11.     public int doStartTag() throws JspException {   
  12.         System.out.println("*********  doStartTag()........\n");   
  13.   
  14.         return this.EVAL_BODY_INCLUDE;   
  15.   
  16.     }   
  17.   
  18.     public int doAfterBody() throws JspException {   
  19.         System.out.println("*********  doAfterBody()........\n");   
  20.   
  21.         return this.SKIP_BODY;   
  22.     }   
  23.   
  24.     public int doEndTag() throws JspException {   
  25.         System.out.println("*********  doEndTag()........\n");   
  26.         JspWriter out = this.pageContext.getOut();   
  27.   
  28.         try {   
  29.             out.println("Hello !!!!");   
  30.         } catch (IOException e) {   
  31.             e.printStackTrace();   
  32.         }   
  33.         return super.doEndTag();   
  34.     }   
  35.   
  36. }   
index.jsp 源码
xml 代码
  1.   
  2. <%@ page language="java" import="java.util.*" pageEncoding="GB18030"%>  
  3. <%@ taglib uri="/WEB-INF/classes/test/display.tld" prefix="test"%>  
  4.   
  5. <!---->>  
  6. <html>  
  7.   <head>  
  8.     <title>My JSP 'index.jsp' starting pagetitle>  
  9.   head>  
  10.      
  11.   <body>  
  12.    <test:display >  
  13.         冬国  <br>  
  14.    test:display>  
  15.   body>  
  16. html>  

效果图

注意:这里的汉字 显示在 hello 前面证明啦 它是先执行index.jsp 中标签中的内容后才执行 doEndTag()这个方法的

目录

 

 

1.     栏目置标 ibox:column ,属于单记录置标........................................................................ 4

2.     子栏目列表置标 ibox: columnList,属于多记录置标........................................................ 6

3.     文章置标 ibox:article ,属于单记录置标.......................................................................... 8

4.     文章列表置标ibox:articlelist ,属于多记录置标............................................................. 11

5.     嵌套模板置标 ibox:template............................................................................................. 15

6.     文章置标 ibox:site ,属于站点置标................................................................................ 16

7.     文章置标 ibox:position ,当前位置置标......................................................................... 17

8.     文章置标 page:pager ,分页置标,属于多记录置标...................................................... 18

9.     内容置标 ibox:search........................................................................................................ 19

10.       自定义表单置标ibox:form,需要配合ibox:formData等使用...................................... 21

11.       自定义表单置标ibox:formData..................................................................................... 24

12.       流量统计置标ibox:traffic.............................................................................................. 26

13.       流量统计置标ibox:comment......................................................................................... 27

14.       自定义读取内容更置标ibox:custom,是个list标签,需要配合其他单标签使用.... 28

15.       图片置标ibox:picture,属于单记录置标......................................................................... 29

16.       图片列表置标ibox:pictureList,属于多记录置标............................................................ 31

17.       视频置标ibox:video,属于单记录置标........................................................................... 33

18.       视频置标ibox:videoList,属于多记录置标..................................................................... 35

19.       音频置标ibox:song,属于单记录置标............................................................................. 37

20.       音频置标ibox:songList,属于多记录置标....................................................................... 39

21.       音视频置标ibox:player.................................................................................................. 41

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

1.       栏目置标 ibox:column ,属于单记录置标

 

语法:

 

<ibox:column[recId   =栏目编号] [property =栏目属性名称] [name =栏目名称] [len =字符长度] [itemType =父栏目级别] [level =数据项类型] [code =栏目code] >

</ibox: column>

 

描述

 

获取一个栏目的一个或多个属性

 

置标属性说明

 

属性

描述

类型

取值

值说明

 

 

 

 

 

recId 

栏目 ID

数字

0

当前栏目

 

 

 

 

 

 

 

 

大于 0 的整数

必须跟内容管理

 

 

 

 

系统的栏目  ID

 

 

 

 

一致

 

 

 

 

 

property

栏目属性

字符串

详细参考栏目属性列表

 

 

 

 

 

 

name

栏目属性名

字符串

属性名称

参考栏目属性列

 

 

 

 

表的属性名称

 

 

 

 

 

len

字符长度

数字

大于 0 的整数

仅当取单个字符

 

 

 

 

类型的属性时有

 

 

 

 

 

 

 

 

 

itemType

数据项类型

枚举型

CURRENT

当前栏目

 

 

 

 

 

 

 

 

PREVIOUS

前一个栏目

 

 

 

 

 

 

 

 

NEXT

后一个栏目

 

 

 

 

 

 

 

 

PARENT

上级栏目

 

 

 

 

 

level

第 n 级父级栏目

数字

0

当前栏目的父级

 

 

 

 

 

 

 

 

大于 0 的整数

从顶级开始,获

 

 

 

 

取当前栏目树指

 

 

 

 

定级别的父栏目

 

 

 

 

 

code

栏目code

字符串

栏目code的值

 

 

 

 

 

 

 

 

 

栏目属性列表

 

属性名称

类型

描述

 

 

 

fdColuId

数字

栏目编号

 

 

 

fdColuName

字符串

栏目名称

 

 

 

fdColuDesc

字符串

栏目描述

 

 

 

fdColuSort

数字

栏目排序

 

 

 

fdColuVirtualPath

字数串

栏目目录路径

 

 

 

以下为数据字典的扩展属性

 

 

 

 

 

fullName

字符串

栏目完整名称,如:

 

 

新闻中心‐今日要闻

 

 

 

url

字符串

访问路径(相对)

 

 

 

absUrl

字符串

访问路径(绝对)

 

 

 

image

字符串

栏目图片(不压缩)

 

 

 

icon

字符串

栏目图标(80×80)

 

 

 

level

数字

栏目级别

 

 

 

 

应用举例:

 

1.      获取指定栏目(id:123)的名称

 

a)        <ibox: column recId   =“123”property =“fdColuName” />

 

2.      获取“新闻中心”栏目的描述

 

<ibox: column          NAME=”新闻中心”>

 

 

</ibox: column>

 

3.      获取指定栏目(id:123)的名称,取前 6 个字符

 

a)        <ibox: column recId   =“123”property=“fdColuName” len=“6”/>

 

4.      获取当前栏目的名称

 

a)        <ibox: column property =“fdColuName” />

 

5.      获取新闻中心栏目(id:123)的链接

 

a)        相对链接: <ibox: column recId =“123” property =“url” />

 

b)        绝对链接: <ibox: column recId =“123” property =“absUrl” />

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

2.       子栏目列表置标 ibox: columnList,属于多记录置标

语法

 

< ibox: columnList [columnId=栏目编号] [columnName=栏目编号] [columnCode=栏目编码] [topCount=获取记录数] [startPos=起始位置] [siteId=站点编号] [siteName=站点名称] [type=栏目类型] [ensureChildLevel=级别] [pageId=分页编号] [pageSize=分页大小] [where=额外检索条件] [order=自定义排序条件] >

           <ibox:column  property ="fdColuName" />  <!-- 这个column标签用法不仅限如此,请对应参考-->

</ ibox: columnList >

 

置标属性说明

 

属性

描述

类型

取值

值说明

 

 

 

 

 

columnId

栏目 ID

数字

0

当前栏目

 

 

 

 

 

 

 

 

大于 0 的整数

要获取子栏目的上

 

 

 

 

级栏目 ID

 

 

 

 

 

columnName

栏目名称

字符串

栏目名称

必须确保在当前站

 

 

 

 

点没有同名的栏

 

 

 

 

目,否则将返回第

 

 

 

 

一个具有该名称的

 

 

 

 

栏目的子栏目列表

 

 

 

 

 

siteId

站点 ID

数字

大于 0 的整数

当指定 siteId 后仅

 

 

 

 

获取指定站点下的

 

 

 

 

一级栏目

 

 

 

 

 

siteName

站点名称

字符

站点名称

必须确保系统中没

 

 

 

 

有同名的站点,否

 

 

 

 

则将返回第一个具

 

 

 

 

有该名称的站点的

 

 

 

 

一级栏目

 

 

 

 

 

topCount

获取记录数

数字

0

获取所有符合条件

 

 

 

 

的栏目

 

 

 

 

 

 

 

 

大于 0 的整数

获取指定数量的栏

 

 

 

 

 

 

 

 

 

type

栏目类型

数字

0

返回所有栏目

 

 

 

 

 

 

 

 

1

文章类型

 

 

 

 

 

 

 

 

2

图片类型

 

 

 

 

 

 

 

 

3

视频类型

 

 

 

 

 

 

 

 

4

音频类型

 

 

 

 

 

ensureChildLevel

级别

数字

整数

当设定这个属性

 

 

 

 

后,如果当前栏目

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

没有下级栏目,并

 

 

 

 

 

且当前栏目的级别

 

 

 

 

 

大  于  或  等  于

 

 

 

 

 

ENSURECHILDLEVEL

 

 

 

 

 

时,将返回同级的

 

 

 

 

 

栏目

 

 

 

 

 

 

 

 

 

 

 

 

 

startPos

开始读取记录

数字

0

从第一条开始

 

 

位置

 

 

 

 

 

 

大于 0 的整数

从指定位置读取

 

 

 

 

 

 

 

 

 

 

 

where

额外的检索条

字符串

SQL 表达式

如果设定  WHERE

 

 

 

 

条件,将根据表达

 

 

 

 

 

式作额外筛选

 

 

 

 

 

 

 

order

额外的排序条

字符串

SQL 表达式

如果指定 ORDER,

 

 

 

 

将根据指定的排序

 

 

 

 

 

条件进行排序

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

栏目属性见 ibox:column 置标

 

应用举例:

 

1.      获取当前栏目的下级栏目列表

 

     <ibox: columnList>

      <ibox:propertyname ="fdColuName" /><br/>

</ibox: columnList>

2.      获取当前栏目下级栏目列表,如果没有下级,且当前栏目级别大于 1 则返回同级

 

<ibox:columnList  ensureChildLevel=“2”>

          <ibox:property name ="fdColuName"/><br/>

    </ibox:columnList>

3.      获取新闻中心的下级栏目列表

 

<ibox:columnList  columnName=“国际新闻”>

           <ibox:property name ="fdColuName"/><br/>

    </ibox:columnList>

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

3.       文章置标 ibox:article ,属于单记录置标

 

 

语法:

 

<ibox:article[recid  =文档编号] [property=属性名称] [pageid=内容页码] [format =修饰属性的格式] [itemType=数据项类型] [len=字符长度] [remark=注释] >

</ibox:article >

 

置标属性说明

 

属性

描述

类型

取值

值说明

 

 

 

 

 

recid 

文档 ID

数字

0

当前文档

 

 

 

 

 

 

 

 

大于 0 的整数

必须跟内容管理

 

 

 

 

系统的文档  ID

 

 

 

 

一致

 

 

 

 

 

property

文档属性名

字符串

属性名称

参考文档属性列

 

 

 

 

表的属性名称

 

 

 

 

 

pageId

内容页码

数字

大于 0 的整数

当内容含分页

 

 

 

 

时,取指定页面

 

 

 

 

的内容

 

 

 

 

 

format

修饰属性的格式

字符串

yyyy-MM-dd HH:ss

修饰property的日期格式

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

len

字符长度

数字

大于 0 的整数

仅当取单个字符

 

 

 

 

类型的属性时有

 

 

 

 

 

 

 

 

 

itemType

数据项类型

枚举型

CURRENT

当前文章

 

 

 

 

 

 

 

 

PREVIOUS

上一篇文章

 

 

 

 

 

 

 

 

NEXT

下一篇文章

 

 

 

 

 

remark

注释信息

字符串

 

置标注释信息

 

 

 

 

 

 

 

 

文章属性列表

 

属性名称

类型

描述

 

 

 

fdArtiid

数字

文章编号

 

 

 

fdArtiCreateAt

时间

文章创建时间

 

 

 

fdArtiLink

字符串

连接,用于连接/文件类型的

 

 

文章 1000 nvarchar

 

 

 

10 / 54

 

 


 

 

 

IBOX 置标说明

 

 

 

 

 

 

 

 

 

 

 

 

 

fdArtiTitle

字符串

文章标题

 

 

 

 

 

 

 

fdArtiIndexTitle

字符串

首页标题,当其为空时,将会

 

 

 

 

取文章标题的内容。

 

 

 

 

 

 

 

Dartisubtitle

字符串

副标题

 

 

 

 

 

 

 

fdArtiContent

字符串

内容

 

 

 

 

 

 

 

fdArtideScription

字符串

摘要 4000 nvarchar

 

 

 

 

 

 

 

fdArtiKeyWord

字符串

关键字

 

 

 

 

 

 

 

fdARtiFromLink

字符串

参考链接,一般用于非原创文

 

 

 

 

章 510 nvarchar

 

 

 

 

 

 

 

fdArtiFrom

字符串

文档出处,一般用于非原创文

 

 

 

 

 

 

 

 

 

 

 

author.fdUserName

字符串

原创作者或者编辑人员。

 

 

 

 

 

 

 

fdArtiFromAuthor

字符串

文档作者,一般用于非原创文

 

 

 

 

 

 

 

 

 

 

 

fdArtiSort

数字

排序

 

 

 

 

 

 

 

以下为数据字典扩展字段

 

 

 

 

 

 

 

 

 

orginalTitle

原始标题

当 设 置 标 题 截 取 后 ,

 

 

 

 

fdArtiTitle 为截取后的标题,

 

 

 

 

使用 OrginalTitle 可获得文章

 

 

 

 

原标题

 

 

 

 

 

 

 

url

字符串

文章访问路径(相对)

 

 

 

 

 

 

 

absUrl

字符串

文章访问路径(绝对)

 

 

 

 

 

 

 

image

字符串

获取文章图片(附件中的最新

 

 

 

 

图片附件的路径)

 

 

 

 

 

 

 

用户自定义字段

字符串

用户自定义的字段名,可以在

 

 

 

 

栏目中显示。其用法跟普通文

 

 

 

 

章字段一样。

 

 

 

 

 

 

 

注:用户自定义字段,其用法跟普通文章属性一样。例如,用户自定义了一个 fdExtDepartment (所属部门)字段。在 article 置标内写为:<FIELD NAME=“fdExtDepartment”></FIELD>,其用法与图片自定义字段、视频自定义字段、音频自定义字段用法一样。

 

 

 

应用举例:

 

1.      获取指定文章(id:123)的标题

 

a)        <ibox: article recId  =“123”property=“fdArtiTitle” />

 

2.      获取指定栏目(id:123)的标题和摘要

 

标题:<ibox:article    recId   =“123” property =“ fdArtiTitle”/>

摘要: <ibox:article   recId   =“123” property =“fdArtiDesc”/>

 

 

3、获取当前文章的链接

 

a)        相对链接: <ibox: article recId  =“123” property =“url” />

 

b)        绝对链接: <ibox: article recId  =“123” property =“absUrl” />

 

 

4、获取上一篇,一下篇文档,显示文档标题和链接。

 

<ibox:article       itemtype="previous"property=“url”>上  一  篇 

 

<ibox:article       itemtype="next"property =“url”>下      一  篇 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

4.       文章列表置标ibox:articlelist ,属于多记录置标

 

 

语法:

 

<ibox:articleList[columnnId=栏目编号] [columnnName=栏目名称] [topCount=获取记录数] [titleLen=标题长度] [startPos=起始位置] [type=文章类型] [getChild=是否获取下级栏目的文章] [matchtype=条件匹配模式(java版自定义标签无此字段)][pageId=分页置标的 id] [where=额外检索条件] [order=自定义排序条件] [remark=注释(java版自定义标签无此字段)] >

 

 

<ibox:article property="文章属性名称"recId  ="0"/>

 

</ibox: articleList>

 

置标属性说明

 

属性

描述

类型

取值

值说明

 

 

 

 

 

columnnId

栏目 ID

数字

不填此项

当前栏目

 

 

 

 

 

 

 

 

大于 0 的整数

必须跟内容管理

 

 

 

 

系统的栏目  ID

 

 

 

 

一致

 

 

 

 

 

columnnName

栏目名称

字符串

栏目名称

必须确保在当前

 

 

 

 

站点没有同名的

 

 

 

 

栏目,否则将返

 

 

 

 

回第一个具有该

 

 

 

 

名称的栏目的子

 

 

 

 

栏目列表

 

 

 

 

 

Extfields(java无)

扩展字段列表

字符串

字符串

逗号分割字段名

 

 

 

 

 

 

 

 

 

topCount

显示多少条文章

数字

大于 0 的整数

设置了多少条,

 

 

 

 

则显示多少。

 

 

 

 

 

titleLen

文章标题的长度

数字

大于 0 的整数

这里以字符表

 

 

 

 

示,一个汉字等

 

 

 

 

于二个字符。如

 

 

 

 

TITLELEN=6,显

 

 

 

 

示 3 个汉字。

 

 

 

 

 

startPos

文章显示的起始

数字

大于 0 的整数

文章最开始位置

 

位置

 

 

为 1,从 1 开始。

 

 

 

 

 

type

文章类型

数字

0

返回所有文章

 

 

 

 

 

 

 

 

1

普通 HTML

 

 

 

 

 

 

 

 

2

纯文本

 

 

 

 

 

 

 

 

3

链接型

 

 

 

 

 

 

 

 

4

文件型

 

 

 

 

 

 

 

 

5

引用型

 

 

 

 

 

 

 

 

 

 


 

 

getChild

是否获取下级栏

数字

0

仅查找当前栏目

 

 

 

 

 

 

目的文章

 

1

级联获取下级栏

 

 

 

 

目的文章

 

 

 

 

 

Matchtype(java无)

按栏目查找匹配

枚举

columnnid

按栏目 id 查找

 

模式

 

 

文章

 

 

 

 

 

 

 

 

keyword

将栏目名称作为

 

 

 

 

关键字匹配文章

 

 

 

 

的  标  题  和

 

 

 

 

keyword

 

 

 

 

 

 

 

 

custom

按 where 条件

 

 

 

 

进行自定义查

 

 

 

 

询,不根据栏目

 

 

 

 

id 筛选

 

 

 

 

 

Pagerid

(java版有可能是pageId)

分页置标的关键

字符串

与 pager 相对应

 

 

<ibox:pager>id

使用。

 

 

 

项一名称相同

 

 

 

 

 

 

where

额外检索

字符串

 

条件项

 

 

 

 

 

order

自定义排序

字符串

 

条件项

 

 

 

 

 

Remark(java无)

注释信息

字符串

 

置标注释信息

 

 

 

 

 

 

文章列表属性:参见ibox:article置标。

 

应用举例:

 

1.      获取指定栏目(id:123)最新 10 篇文章,标题长度 12 字符 a)

 

<ul>

<ibox:articleListcolumnnId="0"topCount="2" titleLen="1">

 

 

<li>

<a href='<ibox:article property="url" recId  ="0"/>'>

<ibox:article property="fdArtiTitle" recId  ="0"/></a>

</li>

</ibox:articlelist>

 

</ul>

 

2.      获取指定栏目(id:123)作者为张三(作者 id:345)的前 10 篇文章,从第二行开始

 

<ul>

 

<ibox:articleListcolumnnId=“123”topCount=“10”startPos=“2” where=“fdartiuserId=345”>

 

<li>

<a href='<ibox:article property="url" recId  ="0"/>'>

<ibox:article property="fdArtiTitle" recId  ="0"/></a>

</li>

</ibox:articleList>

 

</ul>

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

5.        嵌套模板置标 ibox:template

 

语法:

 

<ibox:template name="模板名称"/>模板名称必须是已经建立好的模板的名称,且位置在服务器部署项目下的\IBOX\IBOXData\templates\[项目名称]

 

应用举例:

 

嵌套页头,页头模板名为:通用页头 <ibox: template name="页头"/>

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

6.       文章置标 ibox:site ,属于站点置标

语法:

 

<ibox:site [recId=站点编号] [name=站点名称] [property =属性名称] [len=字符长度] ></ibox:site>

 

置标属性说明

 

属性

描述

类型

取值

值说明

 

 

 

 

 

recId

站点 ID

数字

0

当前站点

 

 

 

 

 

 

 

 

大于 0 的整数

必须跟内容管理

 

 

 

 

系统的站点  ID

 

 

 

 

一致

 

 

 

 

 

name

站点名称

字符

 

必须确保系统中

 

 

 

 

没有同名的站

 

 

 

 

点,否则将返回

 

 

 

 

第一个具有该名

 

 

 

 

称的站点

 

 

 

 

 

property

站点属性名

字符串

属性名称

参考站点属性列

 

 

 

 

表的属性名称

 

 

 

 

 

len

字符长度

数字

大于 0 的整数

仅当取单个字符

 

 

 

 

类型的属性时有

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

站点属性列表

 

属性名称

类型

描述

 

 

 

fdSiteId

数字

站点编号

 

 

 

fdSiteName

字符串

站点名称

 

 

 

fdSiteDesc

字符串

站点描述

 

 

 

fdSiteUrl

字符串

访问地址

 

 

 

fdSiteVirtualPath

字符串

存放位置

 

 

 

fdSiteCreateAt

时间

创建时间

 

 

 

4 / 54

 

 


IBOX 置标说明

 
 
 

 


应用举例:

 

获取当前站点名称

 

<ibox: site  property =“fdSiteName”></ibox:site>

 

 

 

 

 

 

 

 

7.       文章置标 ibox:position ,当前位置置标

语法:

 

<ibox:position [type=显示类型] [currentLink=当前页面链接] [topLevel=首页栏目级别] [homeName=首页显示文字] [splitText=分隔符]

 

</ibox: position>

 

置标属性说明

 

属性

描述

类型

取值

值说明

 

 

 

 

 

type

显示类型

枚举

LINK

显示为链接

 

 

 

 

 

 

 

 

TEXT

仅显示文本

 

 

 

 

 

 

 

 

URL

仅返回 Url 路径

 

 

 

 

 

 

 

 

ABSURL

返回绝对路径

 

 

 

 

 

currentLink

当前页面链接

枚举

COLUMN

返回栏目的链接

 

 

 

 

 

 

 

 

CURRENTURL

返回当前页面的

 

 

 

 

URL

 

 

 

 

 

 

 

 

NULL

不生成链接

 

 

 

 

 

topLevel

首页栏目级别

数字

整数,默认 0

设置首页的位

 

 

 

 

置,当为 0 时,

 

 

 

 

以站点作为首

 

 

 

 

页,否则以第 n

 

 

 

 

级父级栏目作为

 

 

 

 

首页

 

 

 

 

 

homeName

首页文本

字符串

NAME

显示站点名称或

 

 

 

 

栏目名称

 

 

 

 

 

 

 

 

字符串,默认 ”

显示自定义文本

 

 

 

首页”

 

 

 

 

 

 

splitText

分隔符

字符串

默认”>“

设置分隔符

 

 

 

 

 

 

应用举例:

 

获取当前位置”

 

<ibox:position />

 

获取当前位置,设置首页为第 2 级父栏目,首页显示栏目名称,以”-”作为分隔符 <ibox:positiontopLevel="2" homeName="name" splitText="-"></ibox:position>

 

 

 

 

 

 

 

 

 

 

8.       文章置标 page:pager ,分页置标,属于多记录置标

!!!!这个标签暂时无法实现该有的功能

语法:

 

<ibox:pagerid=置标 id [pagesize=每页记录数] [splitsize=每组页码数] [showgo=是否显示 go 按钮] [gotip=页码导航提示文字] [prepagetext=上一页文字] [nextpagetext=下一页文字] [firstpagetext=首页文字] [lastpagetext=末页文字] [summarytext =记录汇总信息文本]></ibox:pager>

 

 

 

置标属性说明

 

属性

描述

类型

取值

值说明

 

 

 

 

 

Id

置标 id

字符串

 

此 id 必须跟列

 

 

 

 

表置标指定的

 

 

 

 

Pagerid 一致才

 

 

 

 

能正常分页

 

 

 

 

 

pagesize

每页记录数

数字

默认 20

每页显示的记录

 

 

 

 

条数

 

 

 

 

 

splitsize

每组页码数

数字

默认 10

 

 

 

 

 

 

prepagetext

上一页文字

字符串

默认”前一页”

分页导航的 ” 上

 

 

 

 

一页 ” 的显示文

 

 

 

 

 

 

 

 

 

nextpagetext

下一页文字

字符串

默认”后一页”

分页导航的 ” 下

 

 

 

 

一页 ” 的显示文

 

 

 

 

 

 

 

 

 

firstpagetext

首页文字

字符串

默认”首页”

分页导航的 ” 首

 

 

 

 

页”的显示文字

 

 

 

 

 

lastpagetext

末页文字

字符串

默认”末页”

分页导航的 ” 末

 

 

 

 

页”的显示文字

 

 

 

 

 

summarytext

汇总信息文本

字符串

默认”共[n]条记

N:总记录数

 

 

 

录 , 当前显示第

C:当前页码

 

 

 

[c]页,共[t]页”

T:总页面数

 

 

 

 

 

 

分页置标必须有 id 属性,需要分页的列表置标如 ibox:articlelist必须设定 pagerid 属性关联这个分页置标的 id 才能正常分页

 

应用举例:

 

1 、 <ibox:pagerid="pager1" pagesize="10" splitsize="2"prepagetext=" 上 一 页 " nextpagetext="下一页" firstpagetext="首页"lastpagetext="未页" summarytext="共[n]条记录"></ibox:pager>


 

注 : id = ”pager1”, 中 的 值 ,


 

 

Pager1


 

 

这 个 值 , 必 须 和 前 面的<ibox:articlelist

 


Pagerid="pager1">中的 pagerid 属性值一致。

 

 

 

 

 

 

 

 

9.       内容置标 ibox:search

 

语法:

 

<ibox:search[siteId=站点编号] [columnId=栏目编号] [getchild=是否检索下级栏目] [searchBar=是否在结果页显示搜索框] [resultBar=否在结果页显示结果统计] [mode=表示结果显示模式] [width= Iframe 的宽度] [height= Iframe的高度]>

 

</ ibox:search >

 

置标属性说明

 

属性

 

描述

 

类型

取值

值说明

 

 

 

 

 

 

 

 

siteId

站点编号

 

数字

0

所有站点(默认)

 

 

 

 

 

 

 

 

 

 

 

 

 

 

-1

当前站点

 

 

 

 

 

 

 

 

 

 

 

 

 

 

指定 ID

指定站点

 

 

 

 

 

 

 

 

columnId

栏目编号

 

数字

0

所有栏目(默认)

 

 

 

 

 

 

 

 

 

 

 

 

 

 

-1

当前栏目

 

 

 

 

 

 

 

 

 

 

 

 

 

 

指定 ID

指定栏目

 

 

 

 

 

 

 

getchild

是否检索下级栏

数字

0

 

 

 

 

 

 

 

 

 

 

 

 

 

columnId=”指

 

1

 

 

定栏目 ID”连用)

 

 

 

 

 

 

 

 

 

 

searchBar

否在结果页显示

数字

0

 

 

搜索框

 

 

 

 

 

 

 

 

1

 

 

 

 

 

 

 

 

 

 

 

 

 

resultBar

是否在结果页显

数字

0

 

 

 

 

 

 

 

 

 

示结果统计

 

 

1

 

 

 

 

 

 

 

 

mode

结果显示模式

 

字符串

Iframe

Iframe 模式显示

 

 

 

 

 

 

 

 

 

 

 

 

 

 

ajax

ajax 模式显示

 

 

 

 

 

 

 

width

设置 Iframe 模式

数字

 

 

 

 

时的宽度(对

 

 

 

 

 

ajax

模式无效)

 

 

 

 

 

 

 

 

 

 

 

 

MODE=“Iframe”

 

 

 

 

 

连用

 

 

 

 

 

 

 

 

 

 

 

 

height

Iframe 模式的高

数字

 

 

 

 

度(对 ajax 模式

 

 

 

 

 

效  )

 

 

 

 

 

mode=“ Iframe”

 

 

 

 

 

连用

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

52 / 54


IBOX 置标说明

 
 
 

 

 


应用举例:

 

1、前台页面搜索功能实现方式,为二步骤:

 

a)          在文章搜索结果页添加置标:

 

<div class="news">

 

<ibox:searchsiteid="‐1" mode="ajax"/> </div>

b)          搜索文本框中,添加引用代码:

 

<form method="get" action="/site/sjj/search/"target="_blank"> <input type="text"name="k" class="txt" />

 

<inputtype="submit" value="" class="btn"name="" /> </form>

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

10. 自定义表单置标ibox:form,需要配合ibox:formData等使用

 

 

语法:

 

<ibox:form   [tablename=创建的表单名称]   [ generatesubmit=是否自动生成”提交”按

 

钮  ]   [ message=表单提交后提示信息]    [target=提交窗口默认样式]   [ remark=表单标题]>

 

 

</ibox:form>

!!注意,这里部分属性,在代码开发者,并没有完全依照驼峰命名法,请依照之使用

 

置标属性说明

 

属性

描述

类型

取值

值说明

 

 

 

 

 

tablename

你所创建的表

字符

 

在所有的表单列

 

单名称

 

 

表中,其名称唯

 

 

 

 

一。

 

 

 

 

 

generatesubmit

是否自动生成”

数字

0

 

提交”按钮

 

 

 

 

 

 

 

 

 

 

 

1

是(默认)

 

 

 

 

 

message

点击了提交按

字符串

 

 

 

钮后的

 

 

 

 

 

 

 

 

target

提交窗口

字符串

 

默认是"_self",

 

 

 

 

跟 a 的提交属性

 

 

 

 

一致

 

 

 

 

 

remark

表单标题,显示

字符串

 

一方面是方便在

 

在前台表单列

 

 

模板里面辨认,

 

表上。

 

 

另一方面的作用

 

 

 

 

是它会生成在静

 

 

 

 

态文件的 html

 

 

 

 

文件中

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

应用举例:

 

1)第一种用法使用:fdf1 - fdf11为自定义属性,分别代表了控件类型:

1单行文本

2多汗文本

3 HTML

4下拉框

5单选

6多选

7是/否(复选框)

8图片

9文件

10比例

11验证码

注意点:必须引入jq的库才能正常工作标签<ibox:div>必须由属性为id的div包裹着,必须操作js/jq相关操作方能显示验证码图像

    <script type="text/javascript" src="js/jquery.js"></script>

    <h1>ibox:form 使用:</h1>

    <br>

    <ibox:form tablename="FO_DS_aofei" generatesubmit="1"

        message="感谢您的意见,我们会尽快联系您的!">

        <div id="fdf1"><ibox:formfield fieldname="fdf1"/></div>

        <div id="fdf2"><ibox:formfield fieldname="fdf2"/></div>

        <div id="fdf3"><ibox:formfield fieldname="fdf3"/></div>

        <div id="fdf4"><ibox:formfield fieldname="fdf4"/></div>

        <div id="fdf5"><ibox:formfield fieldname="fdf5"/></div>

        <div id="fdf6"><ibox:formfield fieldname="fdf6"/></div>

        <div id="fdf7"><ibox:formfield fieldname="fdf7"/></div>

        <div id="fdf8"><ibox:formfield fieldname="fdf8"/></div>

        <div id="fdf9"><ibox:formfield fieldname="fdf9"/></div>

        <div id="fdf10"><ibox:formfield fieldname="fdf11"/></div>

        <div id="fdf11"><ibox:formfield fieldname="fdf11"/></div>

    </ibox:form>

    <script type="text/javascript">

        $(function() {

            //验证码

            $('#imgValcode').attr("src", "https://www.baidu.com/handsomboy.png");

            $('#imgValcode').css({

                "display":"block"

            });

        });

    </script>

 

2)第二种用法使用:fdf1 - fdf11为自定义属性,分别代表了控件类型:

1单行文本

2多汗文本

3 HTML

4下拉框

5单选

6多选

7是/否(复选框)

8图片

9文件

10比例

11验证码

注意点:必须操作js/jq相关操作方能显示验证码图像

 

    <h1>ibox:ctl 使用:</h1>

    <br>

    <ibox:form tablename="FO_DS_aofei" generatesubmit="1"

        message="感谢您的意见,我们会尽快联系您的!">

        <div id="fdf1"><ibox:ctl fieldName="fdf1"formid="28"/></div>

        <div id="fdf2"><ibox:ctl  fieldName="fdf2" formid="28"/></div>

        <div id="fdf3"><ibox:ctl  fieldName="fdf3" formid="28"/></div>

        <div id="fdf4"><ibox:ctl  fieldName="fdf4" formid="28"/></div>

        <div id="fdf5"><ibox:ctl  fieldName="fdf5" formid="28"/></div>

        <div id="fdf6"><ibox:ctl  fieldName="fdf6" formid="28"/></div>

        <div id="fdf7"><ibox:ctl  fieldName="fdf7" formid="28"/></div>

        <div id="fdf8"><ibox:ctl  fieldName="fdf8" formid="28"/></div>

        <div id="fdf9"><ibox:ctl  fieldName="fdf9" formid="28"/></div>

        <div id="fdf10"><ibox:ctl  fieldName="fdf11" formid="28"/></div>

        <div id="fdf11"><ibox:ctl  fieldName="fdf11" formid="28"/></div>

    </ibox:form>

    <script type="text/javascript">

        $(function() {

            //验证码

            $('#imgValcode').attr("src", "https://www.baidu.com/handsomboy.png");

            $('#imgValcode').css({

                "display":"block"

            });

        });

    </script>

</body>

</html>

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

11. 自定义表单置标ibox:formData

 

 

语法:

 

<ibox:formData   [tableName=创建的表单名称]   [showReply=前台是否显示表单数据]   [topCount=获取前几条数据]    [pageSize=多少条分页]   [where=获取前几条数据]>

         <itemtemplate>

         {NAME(字段名称1)}

         {NAME(字段名称2)}

         </itemtemplate>

 

 

</ibox:form>

 

注: NAME 格式写法有三种,如下:

  {NAME(field)}

{NAME(field),FORMAT(yyyy‐MM‐dd HH:mm)}

{NAME(field),LEN(20)}

 

置标属性说明

 

属性

描述

类型

取值

值说明

 

 

 

 

 

tablename

你所创建的表

字符

 

在所有的表单列

 

单名称

 

 

表中,其名称唯

 

 

 

 

一。

 

 

 

 

 

showReply

前台是否显示表单数据

数字

0

 

 

 

 

 

 

 

 

 

 

 

 

 

1

是(默认)

 

 

 

 

 

topCount

获取前几条数据

字符串

 

 

 

 

 

 

 

 

 

 

 

 

pageSize

多少条分页

字符串

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

where

获取前几条数据

字符串

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

应用举例:

 

1) 创建了一个表单表名为:FO_DS_ework。在页面显示提交。并将其结果显示出来,分别

显示:fdxinke、fdxinzi、fdwage、fdsex 字段的内容。并显示系统自带的管理员回复。编号,

表单状态,提交者 IP,提交时间等等信息。

<ibox:form tablename=" FO_DS_ework"/>

<ibox:formData tablename="Fo_Ds_ework" showReply=1 pageSize="4">

<itemtemplate>

<ul>

<li>{ NAME (fdXinKe)}</li>

<li>{ NAME (fdXinZi)}</li>

<li>{NAME(fdWage)}</li>

<li>{NAME(fdSex)}</li>

<li>{NAME(fdReply)}</li>

<li>{NAME(fdId)}</li>

<li>{NAME(fdStatus)}</li>

<li>{NAME(fdIp)}</li>

<li>{NAME(fdCreateat)}</li>

</ul>

</itemtemplate>

</ibox:formData>

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

12. 流量统计置标ibox:traffic

 

语法:

 

<ibox: traffic[showdata =统计源对象类型][ addclick=是否记入流量] [range=统计的时

 

间范围] [datatype=统计 pv 还是ip]></ibox: traffic >

 

置标属性说明

 

属性

描述

类型

取值

值说明

 

 

 

 

 

showdata

统计源对象类型

字符串/数字

Site /1

当前站点

 

 

 

 

 

 

 

 

Channel /2

当前频道

 

 

 

 

 

 

 

 

Column /3

当前栏目

 

 

 

 

 

 

 

 

Null /4

不显示数据

 

 

 

 

 

addclick

是否记入流量

数字

1

记入流量

 

 

 

 

 

 

 

 

0

不记流量

 

 

 

 

 

range

统计的时间范围

数字

0

全部流量

 

 

 

 

 

 

 

 

1

今日

 

 

 

 

 

 

 

 

2

本周

 

 

 

 

 

 

 

 

3

本月

 

 

 

 

 

 

 

 

4

本年

 

 

 

 

 

 

 

 

5

最近一周

 

 

 

 

 

 

 

 

6

最近一月

 

 

 

 

 

 

 

 

7

最近一年

 

 

 

 

 

datatype

统计 PV 还是 IP

数字

1

统计 PV

 

 

 

 

 

 

 

 

2

统计 IP

 

 

 

 

 

 

应用举例:

 

在站点的首页,给出一个统计当前站点的访问数:

 

<ibox:traffic   showdata="site"/>

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

13. 流量统计置标ibox:comment

 

语法:

 

<ibox: comment />

 

置标属性说明

 

         暂无属性

 

应用举例:

 

评论使用

<ibox: comment />

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

14. 自定义读取内容更置标ibox:custom,是个list标签,需要配合其他单标签使用

 

描述

 

根据数据字典,自定义查询字段、筛选条件以及排序条件,并返回列表结果

 

语法:

 

<ibox:custom [topcount= 获取记 录数 ] [startpos= 起始 位置 ]  sql=sql语句  tableName=表关联 [pageId=当前页id] [pageSize=[当前页大小] >

 

 

</ibox: custom>

 

置标属性说明

 

属性

描述

类型

取值

值说明

 

 

 

 

 

topcount

获取记录数

数字

大于 0 的整数

用法与文章置标

 

 

 

 

一致。

 

 

 

 

 

startpos

起始位置

数字

大于 0 的整数

文章最开始位置

 

 

 

 

为 1,从 1 开始。

 

 

 

 

 

sql

查询sql

字符串

 

Sql语句

 

 

 

 

 

tableName

表映射

字符串

 

数据表关联

 

 

 

 

 

pageId

当前分页id

整型

 

 

 

 

 

 

 

pageSize

分页大小

整型

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

重要:该置标用于解决现有置标不能实现的数据查询,要使用该置标必须对数据结构足够熟悉,并掌握 SQL 语句写法,除非你非常理解你所写的 SQL 表达式对系统造成的性能压力,否则不建议使用该置标

 

应用举例:

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

15. 图片置标ibox:picture,属于单记录置标

语法:

 

<ibox: picture[recid=图片编号] [property =属性名称] [len=字符长度] [format=时间类型格式] >

 

</ibox: picture>

 

图片对象共有 5 张图,包括 1 张原图和 4 个不同大小的缩略图,实际应用中根据需要获取图片内容地址:url

 

原图:image

 

缩略图 1(75×75):image1

 

缩略图 2(124×82):image2

 

缩略图 3(240×160):image3

 

缩略图 4(500×334):image4

 

 

 

置标属性说明

 

属性

描述

类型

取值

值说明

 

 

 

 

 

recid

文档 ID

数字

0

当前文档

 

 

 

 

 

 

 

 

大于 0 的整数

必须跟内容管理

 

 

 

 

系统的文档  ID

 

 

 

 

一致

 

 

 

 

 

property

文档属性名

字符串

属性名称

参考文档属性列

 

 

 

 

表的属性名称

 

 

 

 

 

len

字符长度

数字

大于 0 的整数

仅当取单个字符

 

 

 

 

类型的属性时有

 

 

 

 

 

 

 

 

 

format

时间类型格式

字符串

yyyy-MM-dd HH:mm:ss

时间格式控制

 

 

 

 

 

 

 

 

图片属性列表

 

属性名称

类型

描述

 

 

 

fdPictId

数字

图片编号

 

 

 

fdPictName

字符串

图片名称

 

 

 

fdPictDesc

字符串

图片描述

 

 

 

fdPictUrl

字符串

原始图片 URL(相对当前站

 

 

点)

 

 

 

fdPictPeople

字符串

人物

 

 

 

fdPictPlace

字符串

拍摄地点 200 nvarchar

 

 

 

fdPictAt

时间

拍摄时间

 

 

 

27 / 54

 

 


IBOX 置标说明

 
 
 

 


fdPictHeight

数字

图片原始高度

 

 

 

fdPictWidth

数字

图片原始宽度

 

 

 

以下为数据字典扩展属性

 

 

 

 

 

OrginalName

原始名称

当 设 置 标 题 截 取 后 ,

 

 

fdPictName 为截取后的名称,

 

 

使用 OrginalName 可获得图

 

 

片原名称

 

 

 

url

字符串

图片内容页访问路径(相对)

 

 

 

AbsUrl

字符串

图片内容页访问路径(绝对)

 

 

 

Image

字符串

获取图片原图地址

 

 

 

Image1

字符串

获取图片缩略图 1(75*75)

 

 

 

Image2

字符串

获取图片缩略图 1(124*82)

 

 

 

Image3

字符串

获取图片缩略图 1(240X160)

 

 

 

Image4

字符串

获取图片缩略图 1(500X334)

 

 

 

用户自定义字段

字符串

用户自定义的字段名,可以在

 

 

栏目中显示。其用法跟普通文

 

 

章字段一样。

 

 

 

 

注:用户自定义字段,其用法跟普通文章属性一样。

应用举例:

 

1.      获取指定图片(id:123)的名称

 

a)        <ibox: picture  recid=“123”  property =“fdPictName” />

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

16. 图片列表置标ibox:pictureList,属于多记录置标

语法:

 

<ibox:picturelist  [topCount=栏目编号]  [startPos=栏目名称] [pageId=获取记录数] [pageSize=标题长度]  [where=起始位置]  [order=分页置标的 id]  [columnId=额外检索条件] [columnName=自定义排序条件]   [columnCode=自定义排序条件]  [titleLen=自定义排序条件]  [titleExt=自定义排序条件]  [getChild =自定义排序条件]  >

                    <ibox: picture property =“fdPictName”/>

 

</ibox: picturelist>

 

置标属性说明

 

属性

描述

类型

取值

值说明

 

 

 

 

 

columnId

栏目 ID

数字

不填此项

大于 0 的整数

当前栏目

必须跟内容管理

系统的栏目  ID

一致

 

 

 

 

 

columnName

栏目名称

字符串

栏目名称

必须确保在当前

站点没有同名的

栏目,否则将返

回第一个具有该

名称的栏目的子

栏目列表

 

 

 

 

 

pageSize

显示多少条文章

数字

大于 0 的整数

设置了多少条,

则显示多少。

 

 

 

 

 

titleLen

图片标题的长度

数字

大于 0 的整数

这里以字符表

示,一个汉字等

于二个字符。如

TITLELEN=6,显

示 3 个汉字。

 

 

 

 

 

startPos

图片显示的起始

位置

数字

大于 0 的整数

图片最开始位置

为 1,从 1 开始。

 

 

 

 

 

pagerId

分页置标的关键

字符串

<ibox:pager>id

项一名称相同

与 PAGER 相对应

使用。

 

 

 

 

 

where

额外检索

字符串

 

条件项

 

 

 

 

 

order

自定义排序

字符串

 

条件项

 

 

 

 

 

columnCode

栏目code

字符串

栏目code

 

titleLen

标题长度

整型

 

 

titleExt

拓展标题

字符串

 

 

getChild

是否级联获取下级栏目的文档

布尔型

true/false

 

 

 

 

 

 

 

 

 

 

 

 

29 / 54


IBOX 置标说明

 
 
 

 

 


图片列表属性列表

 

参考图片属性列表

 

应用举例:

 

    请参考ibox:clumnList标签,类比使用

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

17. 视频置标ibox:video,属于单记录置标

语法:

 

<ibox: video[recid=视频编号] [property=属性名称] [len=字符长度] [format=时间类型格式] >

 

</ibox:video>

 

置标属性说明

 

属性

描述

类型

取值

值说明

 

 

 

 

 

recId

视频编号

数字

0 或不填

当前产品

 

 

 

 

 

 

 

 

大于 0 的整数

必须跟内容管理

 

 

 

 

系统的文档  ID

 

 

 

 

一致

 

 

 

 

 

property

属性名

字符串

属性名称

参考产品属性列

 

 

 

 

表的属性名称

 

 

 

 

 

len

字符长度

数字

大于 0 的整数

仅当取单个字符

 

 

 

 

类型的属性时有

 

 

 

 

 

 

 

 

 

format

时间类型格式

字符串

yyyy-MM-dd

 

 

 

 

 

 

 

 

 

视频属性列表

 

属性名称

类型

描述

 

 

 

fdVideid

数字

视屏编号

 

 

 

fdVideName

字符串

名称

 

 

 

fdVideDesc

字符串

描述

 

 

 

fdVideSize

数字

文件大小

 

 

 

fdVideWidth

数字

视频宽度

 

 

 

fdVideHeight

数字

视频高度

 

 

 

fdVideSnap

图片

视频截图

 

 

 

fdVideTime

字符串

播放时长

 

 

 

以下为数据字典扩展字段

 

 

 

 

 

orginalName

原始名称

当 设 置 标 题 截 取 后 ,

 

 

fdVideName  为截取后的标

 

 

题,使用 orginalName 可获得

 

 

视频原名称

 

 

 

url

字符串

视频内容页访问路径(相对)

 

 

 

absUrl

字符串

视频内容页访问路径(绝对)

 

 

 

image

字符串

获取视频截图路径

 

 

 

31 / 54

 

 


 

 

 

 

IBOX 置标说明

 

 

 

 

 

 

 

 

 

 

 

 

 

 

fileName

字符串

 

获取视频文件路径

 

 

 

 

 

 

 

 

用户自定义字符

字符串

 

用户自定义的字段名,可以在

 

 

 

 

 

栏目中显示。其用法跟普通文

 

 

 

 

 

章字段一样。

 

 

 

 

 

 

 

 

注:用户自定义字段,其用法跟普通文章属性一样。例如,用户自定义了一个 fdExtDepartment (所属部门)字段。在 video 置标内写为:<ibox:video property="fdExtDepartment" />其用法与文章自定义、图片自定义字段、音频自定义字段用法一样。

 

应用举例:

 

1、当前视频名称 :<ibox:video  property=" fdVideName " />

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

18. 视频置标ibox:videoList,属于多记录置标

语法:

 

<ibox: videoList [topCount=栏目编号]  [startPos=栏目名称] [pageId=获取记录数] [pageSize=标题长度]  [where=起始位置]  [order=分页置标的 id]  [columnId=额外检索条件] [columnName=自定义排序条件]   [columnCode=自定义排序条件]  [titleLen=自定义排序条件]  [titleExt=自定义排序条件]  [getChild =自定义排序条件]  >

                    <ibox: vedio  property =“fdVideName” />

 

</ibox: videoList >

 

置标属性说明

 

属性

描述

类型

取值

值说明

 

 

 

 

 

columnId

栏目 ID

数字

不填此项

大于 0 的整数

当前栏目

必须跟内容管理

系统的栏目  ID

一致

 

 

 

 

 

columnName

栏目名称

字符串

栏目名称

必须确保在当前

站点没有同名的

栏目,否则将返

回第一个具有该

名称的栏目的子

栏目列表

 

 

 

 

 

pageSize

显示多少条文章

数字

大于 0 的整数

设置了多少条,

则显示多少。

 

 

 

 

 

titleLen

视频标题的长度

数字

大于 0 的整数

这里以字符表

示,一个汉字等

于二个字符。如

TITLELEN=6,显

示 3 个汉字。

 

 

 

 

 

startPos

视频显示的起始

位置

数字

大于 0 的整数

视频最开始位置

为 1,从 1 开始。

 

 

 

 

 

pagerId

分页置标的关键

字符串

<ibox:pager>id

项一名称相同

与 PAGER 相对应

使用。

 

 

 

 

 

where

额外检索

字符串

 

条件项

 

 

 

 

 

order

自定义排序

字符串

 

条件项

 

 

 

 

 

columnCode

栏目code

字符串

栏目code

 

titleLen

标题长度

整型

 

 

titleExt

拓展标题

字符串

 

 

getChild

是否级联获取下级栏目的文档

布尔型

true/false

 

 

 

 

 

 

 

 

 

 

 

 

29 / 54


IBOX 置标说明

 
 
 

 

 


视频列表属性列表

 

参考ibox:vedio属性列表

 

应用举例:

 

    请参考ibox:clumnList标签,类比使用

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

19. 音频置标ibox:song,属于单记录置标

语法:

 

<ibox: video[recid=音频编号] [property=属性名称] [len=字符长度] [format=时间类型格式] >

 

</ibox: song>

 

置标属性说明

 

属性

描述

类型

取值

值说明

 

 

 

 

 

recId

音频编号

数字

0 或不填

当前产品

 

 

 

 

 

 

 

 

大于 0 的整数

必须跟内容管理

 

 

 

 

系统的文档  ID

 

 

 

 

一致

 

 

 

 

 

property

属性名

字符串

属性名称

参考产品属性列

 

 

 

 

表的属性名称

 

 

 

 

 

len

字符长度

数字

大于 0 的整数

仅当取单个字符

 

 

 

 

类型的属性时有

 

 

 

 

 

 

 

 

 

format

时间类型格式

字符串

yyyy-MM-dd

 

 

 

 

 

 

 

 

 

音频属性列表

 

属性名称

类型

描述

 

 

 

fdSongId

数字

音屏编号

 

 

 

fdSongName

字符串

音频名称

 

 

 

fdSongSinger

字符串

音频作者

 

 

 

fdSongDesc

字符串

音频描述

 

 

 

fdSongCreateAt

时间

创建时间

 

 

 

fdSongTime

小数类型

播放时长

 

 

 

fdSongIsPub

数字

是否发布

 

 

 

以下为数据字典扩展字段

 

 

 

 

 

OrginalName

原始名称

当 设 置 标 题 截 取 后 ,

 

 

fdSongName 为截取后的标

 

 

题,使用 orginalName 可获得

 

 

音频原名称

 

 

 

Url

字符串

音频内容页访问路径(相对)

 

 

 

AbsUrl

字符串

音频内容页访问路径(绝对)

 

 

 

FileName

字符串

获取音频文件路径

 

 

 

用户自定义字段

字符串

用户自定义的字段名,可以在

 

 

 

35 / 54

 

 


IBOX 置标说明

    
  
 
 
 

 


栏目中显示。其用法跟普通文

 

章字段一样。

 

注:用户自定义字段,其用法跟普通文章属性一样。例如,用户自定义了一个 fdExtDepartment (所属部门)字段。在 SONG 置标内写为: <ibox:song property=" fdExtDepartment " />。其用法与文章自定义、图片自定义字段、音频自定义字段用法一样。

 

应用举例:

 

1、当前音频名称 :<ibox:song  property=" fdSongName " />

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

20. 音频置标ibox:songList,属于多记录置标

语法:

 

<ibox: songList [topCount=栏目编号]  [startPos=栏目名称] [pageId=获取记录数] [pageSize=标题长度]  [where=起始位置]  [order=分页置标的 id]  [columnId=额外检索条件] [columnName=自定义排序条件]   [columnCode=自定义排序条件]  [titleLen=自定义排序条件]  [titleExt=自定义排序条件]  [getChild =自定义排序条件]  >

                    <ibox: vedio  property =“fdVideName” />

 

</ibox: songList >

 

置标属性说明

 

属性

描述

类型

取值

值说明

 

 

 

 

 

columnId

栏目 ID

数字

不填此项

大于 0 的整数

当前栏目

必须跟内容管理

系统的栏目  ID

一致

 

 

 

 

 

columnName

栏目名称

字符串

栏目名称

必须确保在当前

站点没有同名的

栏目,否则将返

回第一个具有该

名称的栏目的子

栏目列表

 

 

 

 

 

pageSize

显示多少条文章

数字

大于 0 的整数

设置了多少条,

则显示多少。

 

 

 

 

 

titleLen

音频标题的长度

数字

大于 0 的整数

这里以字符表

示,一个汉字等

于二个字符。如

TITLELEN=6,显

示 3 个汉字。

 

 

 

 

 

startPos

音频显示的起始

位置

数字

大于 0 的整数

音频最开始位置

为 1,从 1 开始。

 

 

 

 

 

pagerId

分页置标的关键

字符串

<ibox:pager>id

项一名称相同

与 PAGER 相对应

使用。

 

 

 

 

 

where

额外检索

字符串

 

条件项

 

 

 

 

 

order

自定义排序

字符串

 

条件项

 

 

 

 

 

columnCode

栏目code

字符串

栏目code

 

titleLen

标题长度

整型

 

 

titleExt

拓展标题

字符串

 

 

getChild

是否级联获取下级栏目的文档

布尔型

true/false

 

 

 

 

 

 

 

 

 

 

 

 

29 / 54


IBOX 置标说明

 
 
 

 

 


音频列表属性列表

 

参考ibox:vedio属性列表

 

应用举例:

 

    请参考ibox:clumnList标签,类比使用

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

21. 音视频置标ibox:player

语法:

 

<  ibox:player [width=播放器的宽度] [height=播放器的高度] [autostart=是否自动播放] [loop=否循环播放] >

 

</ ibox:player >

 

注:在 video 或 song 置标的应用中,在 itemtemplate 内部嵌入这个置标会自动根据音视频文件的格式生成播放器代码。

 

置标属性说明

 

属性

 

描述

类型

 

取值

 

值说明

 

 

 

 

 

 

 

 

width

 

播放器的宽度

数字

 

 

 

 

 

 

 

 

 

 

 

 

height

 

播放器的高度

数字

 

 

 

 

 

 

 

 

 

 

 

 

autoStart

 

是否自动播放

数字

1

 

 

自动播放

 

 

 

 

 

 

 

 

 

 

 

 

0

 

 

不自动播放

 

 

 

 

 

 

 

 

loop

 

否循环播放

字符

1

 

 

自动循环

 

 

 

 

 

 

 

 

 

 

 

 

0

 

 

不循环

 

 

 

 

 

 

 

 

应用举例:

 

 

 

 

 

 

 

 

 

 

1、一个player播放器

<ibox:player width="300"height="48"/>

 

 

 

 

 




评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值