每当对组件运行 JWL GET 操作时,例如,作为按钮单击结果运行此操作时,客户机将请求获取面板的备用内容。如果有可用的备用内容,新内容将替换现有的面板内容。GET 并不会替换包含该面板的页面,而是,此标记允许替换该页面的部分内容。将从可通过 URL 标识的任何来源检索修改后的页面内容。不会根据对该页面所作的更改对原始页面的服务器生命周期副本进行同步。因此,此标记只应该用于对页面添加只读内容,例如检索特定于上下文的帮助信息。
组件的“属性”视图显示可以对组件设置的最常见属性集,并且根据组件的不同,您还可以看到用于添加控件、操作或其他组件的选项。要打开“属性”视图,请单击
。下表列示了“获取外部内容”组件的常用属性。
“全部属性”视图显示可以对组件设置的全部属性的表,包含可以从“属性”视图访问的那些属性。要切换至“全部属性”视图,请单击“属性”视图右上角的全部属性图标 。
属性名称 |
描述 |
---|---|
binding |
该表达式将组件的实例(通常为用户界面组件)与 Bean 属性(通常在备份文件中)绑定。 |
charset |
超链接所指定的资源的字符编码。 |
href |
对请求作出响应的 JSP 的 URL。对此组件发出 JWL Get 操作时,将使用指定 URL 检索与该组件相关联的面板的新内容。 |
hreflang |
此超链接指定的资源的语言代码。 |
id |
对组件指定一个名称。它在 JSP 内应该是唯一名称。 |
inProgress |
属性尚不可用。 |
rendered |
可设置为 true 或 false:
|
params |
这些标记的值将检索并作为 params 追加至用于获取新内容的 URL。param 的名称将是提供的简单 ID。例如,如果 ID 是“text1”,则 param 将命名为“text1”而不是“form1:text1”。 |
source |
目标 URL 中标记的 ID,该标记的内容将替换此组件所关联的容器的内容。如果未指定 ID,或者在 URL 所引用的页面中找不到该 ID,则将使用容器的 ID。如果在 URL 所引用的页面中找不到此 ID,则将使用主体内容。 |
target |
指定当单击超链接时应将页面装入至的框架集中的目标框架:
|
title |
指定标题文本,它在运行时以工具提示的形式显示在浏览器中。如果未指定备用文本,则浏览器将使用标题文本作为组件的备用文本。 |
oncomplete |
如果请求成功,则替换面板的内容后,将执行此 JavaScript™ 函数。此函数没有任何有意义的参数。 |
onerror |
如果提供,则当 onblur 触发且字段值验证失败时,将执行 JavaScript 函数。该函数在操作执行之前执行。如果该函数返回 false,则不运行操作并中止事件处理(如果 DOM 中止事件处理)。 |
onstart |
当行为开始执行时,将执行此 JavaScript 函数。此函数没有任何有意义的参数。如果它返回 false,则将中止执行。此函数可以与 oncomplete 配合使用来定制执行请求过程中所显示的内容。 |