EvelinaNorton · 发表于 2017-01-10

文章89 · 评论0

OpenCms的JSP标签详解

字数7106 · 浏览 819 · 评论 0

<cms:user>标签


此标签用于访问当前用户的基本信息,用户的基本信息在“管理”视图的“用户管理”中进行维护。


<cms:user property=”firstname”/> 取得当前用户的“名”(firstname)
<cms:user property=”lastname”/> 取得当前用户的“姓”(lastname)
<cms:user property=”name”/> 取得当前用户的“登录名称”(name)
<cms:user property=”email”/> 取得当前用户的“邮件地址”(email)
<cms:user property=”street”/> 取得当前用户的“住址”(street address )
<cms:user property=”zip”/> 取得当前用户的“邮政编码”(zip code )
<cms:user property=”description”/> 取得当前用户的“描述信息”(description)
<cms:user property=”otherstuff”/> 取得当前用户的“其它自定义信息”(otherstuff)


<cms:property>标签 此标签用于访问当前文件或其父文件夹的“属性”(property),“属性”在OpenCms的“浏览”视图的“属性对话框”中进行设置。 <cms:property name=”Title” escapeHtml=”true”/> 读取当前文件的“Title”属性 excapeHtml属性表示将内容进行编码 在查看页面的 源代码时看到的是类似于&#22609;&#26009;&#32593;的编码方式 <cms:property name=”Title” file=”uri” /> 同上 <cms:property name=”locale” file=”search” /> 读取当前文件的“locale”属性,如果没有找到,则向上在其的父亲文件夹中进行查找。 <cms:property name=”Title” file=”search.uri” /> 同上 <cms:property name=”Title” file=”/index.html” /> 读取“/index.html”文件的“Title”属性


<cms:link>标签 此标签用于为内部的VFS资源建立正确的链接,通过这个标签让你省去了在URL中手动增加web名称和servlet名称,另外,如果一个页面设置了静态导出,使用<cms:link>的URL会自动替换为其静态的链接地址。注意:<cms:link>不能被使用于链接到其它域名的外部链接


创建当前文件夹下资源的正确链接: <cms:link>index.html</cms:link>


创建其实文件夹下资源的正确链接: <cms:link>/some/other/folder/index.html</cms:link>


创建根文件夹下资源的正确链接: <cms:link>/index.html</cms:link>


<cms:label>标签


此标签主要用来访问OpenCms工作区本地化文件中的字符串。注意:只用于当你想要扩展OpenCms工作时所用


读取“flex.cache.label.title key”值。 <cms:label>flex.cache.label.title</cms:label>


<cms:include>标签


用于运行中从 OpenCms VFS 动态包含文件,包含的文件被当成一个请求的附加参数


获取文章的正文:<cms:include element=”body”/>


<cms:template>标签


template 标签允许您把一个 JSP 页面分割成多个元素,以便使用 <cms:include> 引入


<cms:contentcheck>标签


用来检测一个XML文件中内容中符合某个属性的一个节点是否存在或者是否有效属性: ifexists:检测内容项是否存在,如果内容项有多个取值,需要增加下标来检测。如elementname[index]。 非必须 ifexistsone:检测一个有逗号分割的内容项的一个值是否存在。当有多个值的时候,需要增加下标识别。非必须 ifexistall:检测一个有逗号分割的内容项的几个值是否全部存在,当有多个值的时候,需要增加下标识别。非必须 ifexistnone:检测一个有逗号分割的内容项的几个值是否全部不存在。当有多个值的时候,需要增加下标识别。非必须


标签体:任何HTML、JSP或者JSTL代码,只有在此标签返回true事才能够被处理。实例:检测一个单独的内容项是否存在 <cms:contentcheck ifexists=”Title”> … </cms:contentcheck> 检测几个内容项是否有一个存在 <cms:contentcheck ifexistsone=”Teaser[0],Teaser[2]”> … </cms:contentcheck>


<cms:contentloop>标签


用来循环一个数据项的所有数据值


属性: element:必须的 指定循环的数据项


<cms:contentloop element=”name”><cms:contentshow /> </cms:contentloop>


<cms:contentshow>标签

用于显示XML页面中的一个数据项的值


属性: element:准备显示的数据项的元素名称。当这个元素有多个取值的时候,需要使用下标 <cms:contentshow element=”name”/> <cms:contentshow element=”name[0]”/>等效于<cms:contentloop element=”name” index=”0″/> <cms:contentloop element=”name”> <cms:contentshow/> </cms:contentloop>


<cms:contentload>标签


载入一个 XML 内容资源的 collection ,根据给定的 collector 属性,确定是单个资源还是资源列表


<cms:contentinfo>标签


用来得到一个经过内容收集器得到的结果集的信息。一般用在将结构化内容分页的时候用到。


属性:


var:定义访问的contentinfo bean,必须的属性


scope:定义存储的contentinfo bean的作用范围,默认为page。非必须


value:用来访问这个bean的单独的一个值,非必须


[list][*]name.resultSize: 返回收集到的 XML 内容的总数.[/list][list][*]name.resultIndex: 返回当前xml页面的索引,这个索引是从 1 开始的.[/list]


得到返回的结果集的数量[结果总数] <cms:contentinfo var=”info” /> <!– use “info” for validation –> <c:if test=”${info.resultSize > 0}”>


<cms:info>标签


info 标签显示系统的运行信息以及底层支撑的


opencms.version: 获取opencms的版本


opencms.url:show the URL to the current file


opencms.uri:show the URI to the current file


opencms.webapp:the name of the web application


opencms.webbasepath:absolute path to the web application


opencms.request.uri:the opencms request URI of the current file


opencms.request.element.uri:the opencms request URI of the current element


opencms.request.folder:the opencms reqeust folder


系统环境


java.vm.name:name of the used Java VM


java.vm.version:version of the used Java VM


java.vm.info:information on Java VM java.vm.vendor: vendor of Java VM os.name: name of the current operating system os.version: version of the OS os.arch:architecture of the OS


<cms:param>标签在其他标签中嵌套使用,用来传递参数


属性: name:必须的 用来确定参数名称 value:参数对应的值。此属性和标签体只能选择使用一个


比如: <cms:param name=”eward” value=”eward”/>和 <cms:param name=”eward”>eward</cms:param>等效


常用情形: 1、在使用<cms:img>时,传递相关参数,如:<cms:img width=”450″ scaleType=”1″ scaleQuality=”85″> <cms:param name=”src”><cms:link><c:out value=”${curProp}”></cms:link></cms:param> <cms:param name=”alt”><%=ltb.key(“art.bild.altText”)%></cms:param> </cms:img> 2、在使用<cms:include>时使用 <cms:include file=”../elements/template-nav-top.jsp”><cms:param name=”locale”><%=locale%></cmd:param><cmsparam name=”navpart” value=”toprow” /> </cms:include>


<cms:img>标签用于图片的缩放


src:图片的路径 height:图片缩放后的高度 width:缩放后的宽度 scaleColor:图片缩放后的背景颜色 scaleFilter:图片缩放后背景CSS过滤器filter。 scalePosition:图片缩放后的位置 0 全居中 1:下居左 2 下居右 3 下居中 4 左居中 5 右居中 6 上居中 7 上居左 8上居右 scaleQuality:图片缩放后的保存质量 值为0-100 scaleRenderMode:图片缩放渲染模式。 scaleType:图片缩放类型


<cms:img src=”/opencms/opencms/alkacon-documentation/documentation_taglib/Logo_opencms_png24.png” scaleType=”0″ width=”300″ height=”60″ />

本文系作者 EvelinaNorton 授权问说网发表,并经问说网编辑,转载请注明出处和 本文链接