Skip to main content

Visualforce actionFunction Component

About Us
Published by admin
11 May 2015
112

ActionFunction is a component, which provides support for invoking controller action methods directly from JavaScript code with the use of AJAX request.

An <apex:actionFunction> component must be a child of an <apex:form> component.

Unlike <apex:actionSupport>, which only provides support for invoking controller action methods from other Visualforce components, <apex:actionFunction> defines a new JavaScript function which can then be called from within a block of JavaScript code.

Beginning with API version 23 you can't place <apex:actionFunction> inside an iteration component — <apex:pageBlockTable>, <apex:repeat>, and so on. Put the <apex:actionFunction> after the iteration component, and inside the iteration put a normal JavaScript function that calls it.

If we want to use actionFunction, the first step is setting off a name (name=”MyActionFunction”). It is the only required attribute in this component. When we want to call our function, we call it by name.

Next step is to set action. The action method is invoked when the actionFunction is called by a DOM event elsewhere in the page markup. Use merge-field syntax to reference the method. For example, action="{!save}" references the save method in the controller. If an action is not specified, the page simply refreshes.

Attribute rendered can be used to activate or to deactivate your actionFunction. You can use a formula here.

Attribute reRender helps us to update only chosen (by id) parts of the page when the action is completed.

With help of oncomplete it is possible to set, what will happen next.

The JavaScript is invoked when the onbeforedomupdate event occurs – that is when the AJAX request has been processed, but before the browser's DOM is updated.

In the timeout we can set the amount of time (in milliseconds) before an AJAX update request should time out.

Attribute namespace helps you to set necessary namespace for your function, but if this attribute is not added, the namespace will be generated automatically.

Like in most other components, you can set id for your actionFunction and allow the actionFunction component to be referenced by other components in the page.

In focus attribute you can put the ID of the component that is in focus after the AJAX request completes.

Attribute status is the ID of an associated component that displays the status of an AJAX update request.

Setting immediate="true" we can specify whether the action associated with this component should happen immediately, without processing any validation rules associated with the fields on the page.

<!-- Page: -->

visualforce

/*** Controller ***/

visualforce


Question to the expert
Related Articles
All articles
Save the dates! Upcoming Salesforce events are here!
Training is an essential part of the person’s growth as a professional. Especially it’s important to learn something new for developers on an ongoing basis because they are the ones who meet unique business issues and create the best solutions that bring to life any client's wishes. Salesforce has always tried to provide all the partners with opportunities to learn and develop. We present you a useful list of upcoming events from Salesforce that can be an interesting and valuable pastime.
08 April 2021
Augmented Reality for Business. FieldXR Project part 3
In the previous articles, the JET BI project, Structure Sensor SDK, and the problem of identifying the scanned object were described. Also, we considered the calculating algorithm of the found 3D model position for displaying in the scanned object coordinates. Today we perform the process of developing the JET BI FieldXR project.
29 March 2021
How to work with the identified 3D objects. FieldXR project part 2
This post is the second article in the series that covers FieldXR app, an extension for Salesforce Field Service with deep visualization functionality.  We have already raised the issue of collecting 3D information about the real world required for the app’s correct operation. In this article, we will highlight the next two pain points: identifying the scanned object and calculating the position of the found 3D model for displaying in the scanned object’s coordinates.
25 March 2021