OpenCms的JSP标签详解

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属性表示将内容进行编码 在查看页面的 源代码时看到的是类似于塑料网的编码方式 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:linkindex.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:labelflex.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:linkc: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:paramcmsparam 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" /