This is the legacy 4D documentation web site. Documentations are progressively being moved to developer.4d.com
- 4D Language Reference
-
- Web Area
-
-
Programmed management of Web Areas
-
WA Back URL available
-
WA Create URL history menu
-
WA Evaluate JavaScript
-
WA EXECUTE JAVASCRIPT FUNCTION
-
WA Forward URL available
-
WA Get current URL
-
WA GET EXTERNAL LINKS FILTERS
-
WA Get last filtered URL
-
WA GET LAST URL ERROR
-
WA Get page content
-
WA Get page title
-
WA GET PREFERENCE
-
WA GET URL FILTERS
-
WA GET URL HISTORY
-
WA OPEN BACK URL
-
WA OPEN FORWARD URL
-
WA OPEN URL
-
WA OPEN WEB INSPECTOR
-
WA REFRESH CURRENT URL
-
WA Run offscreen area
-
WA SET EXTERNAL LINKS FILTERS
-
WA SET PAGE CONTENT
-
WA SET PREFERENCE
-
WA SET URL FILTERS
-
WA STOP LOADING URL
-
WA ZOOM IN
-
WA ZOOM OUT
-
WA EXECUTE JAVASCRIPT FUNCTION
| WA EXECUTE JAVASCRIPT FUNCTION ( {* ;} object ; jsFunction ; result|* {; param}{; param2 ; ... ; paramN} ) | ||||||||
| Parameter | Type | Description | ||||||
| * | Operator |
|
If specified, object is an object name (string) If omitted, object is a variable | |||||
| object | Form object |
|
Object name (if * is specified) or Variable (if * is omitted) | |||||
| jsFunction | String |
|
Name of JavaScript function to execute | |||||
| result|* | Variable |
|
* for a function with no result or | |||||
|
Function result (if expected) | |||||||
| param | String, Number, Date, Object, Collection |
|
Parameter(s) to pass to function | |||||
The WA EXECUTE JAVASCRIPT FUNCTION command executes, in the Web area designated by the * and object parameters, the JavaScript function jsFunction and optionally returns its result in the result parameter.
If the function does not return a result, pass * in the result parameter.
You can pass one or more parameters containing the parameters of the function in param.
The command supports several types of parameters for both input (param) and output (result). You can pass and retrieve data of the string, number, date, object and collection types. If the parameter type is not defined, the text type is used by default.
Warning: Using this command to call directly a JavaScript function that displays a dialog (alert(), print()...) is not recommended since the user cannot interact with the Web area while the 4D code is running. If you need to implement such interface, for example you can call setTimeout(function(){alert();}, 50)) to let the execution of the 4D code finish and allow user interaction.
Calling a JavaScript function with 3 parameters:
$JavaScriptFunction:="TheFunctionToBeExecuted"
$Param1:="10"
$Param2:="true"
$Param3:="1,000.2" `note "," as thousands separator and "." as the decimal separator
WA EXECUTE JAVASCRIPT FUNCTION(MyWArea;$JavaScriptFunction;$Result;$Param1;$Param2;$Param3)The "getCustomerInfo" JavaScript function receive a number ID as parameter and returns an object:
C_OBJECT($Result)
C_LONGINT($ID)
$ID:=1000
WA EXECUTE JAVASCRIPT FUNCTION(*,"WA";"getCustomerInfo";$Result;$ID)
Product: 4D
Theme: Web Area
Number:
1043
Created: 4D v11 SQL Release 2
Modified: 4D v14
Modified: 4D v16 R4
4D Language Reference ( 4D v20 R7)
