Área Web
Acceder a los métodos 4D
Puede llamar a los métodos 4D desde el código JavaScript ejecutado en un área web y recibir valores a cambio. Para poder llamar a los métodos 4D desde un área Web, debe activar la propiedad de accesibilidad de los métodos 4D ("todos").
Esta propiedad sólo está disponible si el área web utiliza el motor de renderizado web integrado.
Cuando esta propiedad está activada, se instancia un objeto JavaScript especial llamado $4d
en el área web, que puede utilizar para gestionar las llamadas a los métodos proyecto de 4D.
Gramática JSON
Nombre | Tipos de datos | Valores posibles |
---|---|---|
methodsAccessibility | cadena | "none" (por defecto), "all" |
Objetos soportados
Variable Progression
Nombre de una variable de tipo Longint. Esta variable recibirá un valor entre 0 y 100, que representa el porcentaje de finalización de la carga de la página en el área web. Actualizado automáticamente por 4D, no puede ser modificado manualmente.
As of 4D v19 R5, this variable is no longer updated in Web Areas using the Windows system rendering engine.
Gramática JSON
Nombre | Tipos de datos | Valores posibles |
---|---|---|
progressSource | cadena | Nombre de una variable Longint |
Objetos soportados
URL
La variable URL es de tipo cadena. Contiene la URL cargada o que está siendo cargada por el área web asociada. La asociación entre la variable y el área web funciona en ambas direcciones:
- Si el usuario asigna una nueva URL a la variable, esta URL es cargada automáticamente por el área web.
- Toda la navegación que se realice dentro del área web actualizará automáticamente el contenido de la variable.
Esquemáticamente, esta variable funciona como el área de direcciones de un navegador web. Puede representarlo a través de un área de texto sobre el área Web.
Variable URL y comando WA OPEN URL
La variable URL produce los mismos efectos que el comando WA OPEN URL. No obstante, hay que señalar las siguientes diferencias:
- Para el acceso a los documentos, esta variable sólo acepta URLs que cumplan con el RFC ("file://c:/My%20Doc") y no los nombres de ruta del sistema ("c:\MyDoc"). El comando WA OPEN URL acepta ambas notaciones.
- Si la variable URL contiene una cadena vacía, el área web no intenta cargar la URL. El comando WA OPEN URL genera un error en este caso.
- Si la variable URL no contiene un protocolo (http, mailto, archivo, etc.), el área web añade "http://", lo que no ocurre con el comando WA OPEN URL.
- Cuando el área web no se muestra en el formulario (cuando se encuentra en otra página del formulario), la ejecución del comando WA OPEN URL no tiene ningún efecto, mientras que la asignación de un valor a la variable URL puede utilizarse para actualizar la URL actual.
Gramática JSON
Nombre | Tipos de datos | Valores posibles |
---|---|---|
urlSource | cadena | Una URL. |
Objetos soportados
Utilizar el motor de renderizado web integrado
Esta opción permite elegir entre dos motores de renderizado para el área web, dependiendo de las particularidades de su aplicación:
- no marcado -
valor JSON: sistema
(por defecto): en este caso, 4D utiliza el "mejor" motor correspondiente al sistema. Esto significa que usted se beneficia automáticamente de los últimos avances en la renderización web, a través de HTML5 o JavaScript. Sin embargo, es posible que note algunas diferencias de renderizado entre plataformas. En Windows, 4D utiliza Microsoft Edge WebView2. En macOS, 4D utiliza la versión actual de WebKit (Safari).
On Windows, if Microsoft Edge WebView2 is not installed, 4D uses the embedded engine as system rendering engine. To know if it is installed in your system, look for "Microsoft Edge WebView2 Runtime" in your applications panel.
- checked -
JSON value: embedded
: In this case, 4D uses the Chromium Embedded Framework (CEF). La utilización del motor web integrado significa que la representación de las áreas web y su funcionamiento en su aplicación son idénticos independientemente de la plataforma utilizada para ejecutar 4D (no obstante, pueden observarse ligeras variaciones de píxeles o diferencias relacionadas con la implementación de la red). When this option is chosen, you no longer benefit from automatic updates of the Web engine performed by the operating system; however, new versions of the engines are regularly provided through 4D.
The CEF engine has the following limitations:
- WA SET PAGE CONTENT: using this command requires that at least one page is already loaded in the area (through a call to
WA OPEN URL
or an assignment to the URL variable associated to the area). - Cuando se activa soltar URLs mediante el selector
WA enable URL drop
del comando WA SET PREFERENCE, la primera soltada debe ir precedida de al menos una llamada a WA OPEN URL o una asignación a la variable URL asociada al área.
Gramática JSON
Nombre | Tipos de datos | Valores posibles |
---|---|---|
webEngine | cadena | "embedded", "system" |