聚集标记库属性
聚集标记库用于将多个 Portlet 聚集在一个页面上。
支持的自变量包括:
- init
- 此标记初始化 Portlet 框架,必须用于 JSP 的开始处。本节中描述的所有其他标记仅在此标记的主体中有效,因此,JSP 的整个主体通常包围于
init 标记中。如果当前 URL 包含操作标志,那么会调用相应 Portlet 的操作方法。state 和 insert 标记是
init 标记的子标记。init 标记有以下属性:
- portletURLPrefix = ”<any string>”
此 URL 定义用于 PortletURL 的前缀。Portlet URL 是通过 state 标记或在 Portlet 的呈示方法中创建的,使用 insert 标记可以调用该方法。这是一个必需属性。
- portletURLSuffix = ”<any string>”
此 URL 定义用于 PortletURL 的后缀。Portlet URL 是通过 state 标记或在 Portlet 的呈示方法中创建的,使用 insert 标记可以调用该方法。此属性是可选的。
- portletURLQueryParams = ”<any string>”
此 URL 定义用于 PortletURL 的查询参数。Portlet URL 是通过 state 标记或在 Portlet 的呈示方法中创建的,使用 insert 标记可以调用该方法。此属性是可选的。
- portletURLPrefix = ”<any string>”
- scope, portlet
- 使用作用域标记和 Portlet 标记提供在多部分上下文根(如 /context1/context2)下安装 Portlet 应用程序时所必需的信息。这些标记还会定义哪些 Portlet 窗口通过公共呈示参数参与 Portlet 协调,并将呈示参数添加到新创建的 URL。urlParam 标记有以下属性:
- context = "/<context1>/<context2>"
指定在其中部署 Portlet 的 Portlet 应用程序的上下文根。此属性是必需的。
- portletname = "<portlet-name>"
指定 portlet-name。此属性是必需的。
- windowId = ”<any string>”
定义具体 Portlet 实例的窗口标识。此属性是必需的。
以下是如何使用作用域和 Portlet 标记的示例:<%@ taglib uri="http://ibm.com/portlet/aggregation" prefix="portlet" %> <portlet:scope> <portlet:portlet context="/myportletcontext1/myportletcontext2” portletname="MyPortlet" windowId="sample"/> </portlet:scope> <portlet:init portletURLPrefix="/myportalcontext/ "> …. </portlet:init>
- context = "/<context1>/<context2>"
- state
- state 标记使用给定的状态创建指向给定 Portlet 的 URL。可以将此 URL 放置在由
var 属性指定的变量中,也可以将它直接写到输出流。此标记可用于为 HTML 按钮、图像和其他各项创建
URL,以便在调用该 URL 时,在该 URL 中定义的状态更改会应用于给定的
portlet。state 标记有以下属性:
- url = ”<context>/<portlet-name>”
通过使用上下文和 Portlet 名来确定 Portlet 的地址以对此标记标识 portlet。此属性是必需的。
- windowId = ”<any string>”
定义此标记创建的 Portlet URL 的窗口标识。此属性是可选的。
- var = ”<any string>”
如果定义了此属性,那么 URL 将写到具有给定作用域和名称的变量中,而不是写到输出流中。此属性是可选的。
- scope = ”page|request|session|application”
此属性仅在指定了 var 属性后才有效。如果定义了此属性,那么不会将 URL 写到输出流中,但会以给定的名称在给定的作用域中创建一个变量。缺省值为 page。此属性是可选的。
- portletMode = ”view|help|edit|<custom>”
此属性设置 Portlet 方式。
- portletWindowState = ”maximized|minimized|normal|<custom>”
此属性设置窗口状态。
- action = ”true/false”
此属性定义这是否是操作 URL。此属性是可选的。缺省值为 false。
- url = ”<context>/<portlet-name>”
- urlParam
- 将一个呈示参数添加到新创建的 URL 中。urlParam 标记有以下属性:
- name = ”<any string>”
指示参数的名称。此属性是必需的。
- value = ”<any string>”
指示参数的值。此属性是必需的。
- name = ”<any string>”
- insert
- 此标记调用 Portlet 的呈示方法并检索内容以及标题。通过使用
contentVar 和 titleVar 属性,您可以有选择地将指定 Portlet 的内容和标题放置在变量中。insert 标记有以下属性:
- url = ”<context>/<portlet-name>”(必需的)指示使用上下文和 portlet-name 来定位 Portlet 的此标记的 portlet
此属性是必需的。
- windowId = ”<any string>”
定义 Portlet r 窗口标识。此属性是可选的。
- contentVar = ”<any string>”
如果定义了此属性,那么不会将 Portlet 的内容写到输出流中,而是会写到具有给定作用域和名称的变量中。此属性是可选的。
- contentScope = ”page|request|session|application”
此属性仅在使用了 contentVar 标记后才有效。如果定义了此属性,那么 Portlet 的内容将写到具有给定作用域和名称的变量中,而不是写到输出流中。缺省值为 page。此属性是可选的。
- titleVar = ”<any string>”
如果定义了此属性,那么 Portlet 的标题将写到具有给定作用域和名称的变量中。如果未定义此属性,那么标题会被忽略且不会写到输出流中。此属性是可选的。
- titleScope = ”page|request|session|application”
此属性仅在使用了 titleVar 标记后才有效。如果定义了此属性,那么 Portlet 的标题将写到具有给定作用域和名称的变量中,而不是写到输出流中。缺省值为 page。此属性是可选的。
- url = ”<context>/<portlet-name>”(必需的)指示使用上下文和 portlet-name 来定位 Portlet 的此标记的 portlet