每当对组件父面板运行 JWL GET 操作时,例如,作为按钮单击结果运行此操作时,客户机将请求获取面板的备用内容。如果有可用的备用内容,新内容将替换现有的面板内容。GET 并不会替换包含该面板的页面,而是,此标记允许替换该页面的部分内容。将从提供原始内容的 JSP 检索修改后的页面内容。此页面的服务器生命周期副本与客户端页面将保持同步。将使用 HTTP GET 请求操作来检索新页面内容,这与执行同一操作但使用 HTTP POST 请求的 ajaxRefreshSubmit 不同。执行 GET 时,会将服务器上正确计算内容所需的值作为参数添加到 URL 中。
<factory> <faces-context-factory> com.ibm.faces.context.AjaxFacesContextFactory </faces-context-factory> <render-kit-factory> com.ibm.faces.renderkit.AjaxRenderKitFactory </render-kit-factory> </factory>
<h:panelGroup id="panel1"> <hx:ajaxRefreshRequest onerror="return doError(this, event);"/> </h:panelGroup>
<h:outputText id="otext2" escape="false" rendered="#{param.text1 != null}" value="You typed:<b> #{param.text1}</b>"/>
<hx:ajaxRefreshRequest onerror="return doError(this, event);" params="text1"/>
<hx:commandExButton type="button" value="Enter" id="button1"> <hx:behavior event="onclick" behaviorAction="get;stop" targetAction="panel1"/> </hx:commandExButton>
组件的“属性”视图显示可以对组件设置的最常见属性集,并且根据组件的不同,您还可以看到用于添加控件、操作或其他组件的选项。要打开“属性”视图,请单击
。下表列示了“获取内容”组件的常用属性。
“全部属性”视图显示可以对组件设置的全部属性的表,包含可以从“属性”视图访问的那些属性。要切换至“全部属性”视图,请单击“属性”视图右上角的全部属性图标 。
属性名称 |
描述 |
---|---|
binding |
该表达式将组件的实例(通常为用户界面组件)与 Bean 属性(通常在备份文件中)绑定。 |
id |
对组件指定一个名称。它在 JSP 内应该是唯一名称。 |
inProgress |
属性尚不可用。 |
rendered |
可设置为 true 或 false:
|
params |
这些标记的值将检索并作为 params 追加至用于获取新内容的 URL。param 的名称将是提供的简单 ID。例如,如果 ID 是“text1”,则 param 将命名为“text1”而不是“form1:text1”。 |
target |
指定当单击超链接时应将页面装入至的框架集中的目标框架:
|
title |
指定标题文本,它在运行时以工具提示的形式显示在浏览器中。如果未指定备用文本,则浏览器将使用标题文本作为组件的备用文本。 |
oncomplete |
如果请求成功,则替换面板的内容后,将执行此 JavaScript™ 函数。此函数没有任何有意义的参数。 |
onerror |
如果提供,则当 onblur 触发且字段值验证失败时,将执行 JavaScript 函数。该函数在操作执行之前执行。如果该函数返回 false,则不运行操作并中止事件处理(如果 DOM 中止事件处理)。 |
onstart |
当行为开始执行时,将执行此 JavaScript 函数。此函数没有任何有意义的参数。如果它返回 false,则将中止执行。此函数可以与 oncomplete 配合使用来定制执行请求过程中所显示的内容。 |