OpenCms JSP标签详解——cms:property标签

 

<cms:property> 标签

　　此标签用于访问当前文件或其父文件夹的 “ 属性 ” （ property ）， “ 属性 ” 在 OpenCms 的 “ 浏览 ” 视图的 “ 属性对话框 ” 中进行设置。

　　标签说明

名称	描述	必须
name	要读取的属性名称，如 “title” 、 “cache” 、 “content-encoding” 等，如果没有找到指定的属性，则返回 “null” 。	是
file	下面的 “ 值 ” 指定了属性的查找方式： uri (default) 　　在用户请求的当前文件中查找属性。 search.uri or search 　　在用户请求的当前文件中查找属性，如果没有找到，则从当前文件开始一级级向上找这个文件的父文件夹的此属性。 element.uri 　　在当前所引用的子元素中查找属性， element.uri 在模板中或是其它包含多个子元素的页面中非常有用。 search.element.uri 　　在当前所引用的子元素中查找属性，如果没有找到，则从这个子元素文件开始一级级向上找这个子元素文件的父文件夹的此属性。 {some-file-uri} 　　在指定的 OpenCms VFS uri 文件中查找属性。	否

实例：

<cms:property name="Title" /> 　读取当前文件的 “Title” 属性
<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” 属性