部分内容来自
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 源码
DisplayTag.java 源码
效果图
注意:这里的汉字 显示在 hello 前面证明啦 它是先执行index.jsp 中标签中的内容后才执行 doEndTag()这个方法的
目录
2. 子栏目列表置标 ibox: columnList,属于多记录置标........................................................ 6
4. 文章列表置标ibox:articlelist ,属于多记录置标............................................................. 11
8. 文章置标 page:pager ,分页置标,属于多记录置标...................................................... 18
10. 自定义表单置标ibox:form,需要配合ibox:formData等使用...................................... 21
14. 自定义读取内容更置标ibox:custom,是个list标签,需要配合其他单标签使用.... 28
16. 图片列表置标ibox:pictureList,属于多记录置标............................................................ 31
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: 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
应用举例:
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 |
|
|
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: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 |
|
|
栏目中显示。其用法跟普通文
章字段一样。
注:用户自定义字段,其用法跟普通文章属性一样。例如,用户自定义了一个 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"/>