Visualforce Page 中的 <apex: actionSupport> 组件

2025年3月17日 | 阅读 3 分钟

<apex:actionSupport> 组件是另一个重要的组件,用于为另一个组件添加 AJAX 支持。它允许组件在特定事件发生时被服务器异步刷新。

与其他组件一样,<apex:actionSupport> 组件也具有以下属性

1. action

action 属性的类型为 "ApexPages.Action",用于定义由发送到服务器的 AJAX 请求调用的 action 方法。当用户未指定 action 时,页面只需刷新。

语法

2. disabled

disabled 属性的类型为 Boolean,用于指定组件是否已禁用。当其值设置为 true 时,不会调用定义的 action。

语法

3. disableDefault

disableDefault 属性的类型为 Boolean,用于指定是否应跳过关联事件的默认浏览器处理。默认情况下,其值设置为 true。

语法

4. event

event 属性的类型为 String,用于定义用于生成 AJAX 请求的 DOM 事件。 onclick、ondbclick、onkeyup 等是此属性的可能值。

语法

5. focus

event 属性的类型为 String,用于定义在 AJAX 请求完成后处于焦点状态的组件的 ID。

语法

6. id

event 属性的类型为 String,用于定义标识符。 它允许页面上的另一个组件引用该组件。

语法

7. immediate

immediate 属性的类型为 Boolean。如果其值为 true,则与组件关联的 action 将立即发生。与页面上的字段关联的验证规则将不会被该函数处理。

语法

8. oncomplete

String 类型的属性,用于定义当客户端完成 AJAX 更新请求的结果时调用的 JavaScript 方法。

语法

9. onbeforedomupdate

另一个字符串类型属性,用于定义当 onbeforedomupdate 事件发生时调用的 JavaScript 方法。

语法

10. onsubmit

onsubmit 属性的类型为 string,用于指定在将 AJAX 更新请求发送到服务器之前要执行的 JavaScript 方法。

语法

11. timeout

timeout 属性的类型为 Integer,用于定义 AJAX 更新请求应超时的超时时间。

语法

12. status

status 属性的类型为 string,用于定义关联组件的 ID,该组件显示 AJAX 更新请求的状态。

语法

13. reRender

reRender 属性的类型为 Object,它基本上是一个或多个组件的 Id,我们需要在客户端收到 action 方法的结果时重绘这些组件。

其值可以是单个 Id、逗号分隔的 Id 或 Id 的集合。

语法

14. rendered

一个 Boolean 属性,用于指定组件是否在页面上呈现。默认情况下,其值设置为 true。

语法

让我们举一个例子来了解如何在 VF 中使用 <apex:actionSupport> 组件

ApexActionSupportExample.vfp

ApexActionSupportController.apxc

输出

apex:actionSupport component in Visualforce Page