Área Web
Acceder a los métodos 4D
Puede llamar a métodos 4D y funciones de clase desde el código JavaScript ejecutado en un área Web y obtener 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 $4den el área web, que puede utilizar para gestionar las llamadas a los métodos proyecto y funciones 4D.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| methodsAccessibility | string | "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.
A partir de 4D v19 R5, esta variable solo se actualiza en Windows si el área Web utiliza el motor de renderizado Web anidado.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| progressSource | string | 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, correo, archivo, etc.), el área web añade "http://", lo cual no es el caso del 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 | string | 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).
En Windows, si Microsoft Edge WebView2 no está instalado, 4D utiliza el motor integrado como motor de renderizado del sistema. Para saber si está instalado en su sistema, busque "Microsoft Edge WebView2 Runtime" en su panel de aplicaciones.
- marcado -
valor JSON: anidado: en este caso, 4D utiliza 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). 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).
El motor CEF tiene las siguientes limitaciones:
- WA SET PAGE CONTENT: el uso de este comando requiere que al menos una página ya esté cargada en el área (mediante una llamada a
WA OPEN URLo una asignación a la variable URL asociada al área). - Cuando se habilita soltar URL mediante el selector
WA enable URL dropdel comando WA SET PREFERENCE, la primera caída debe ir precedida de al menos una llamada a WA OPEN URL o una asignación a la variable URL asociada al área.
Puede personalizar los parámetros del área de CEF creando un [archivo de configuración 4DCEFParameters.json] local (webArea_overview.md#4dcefparametersjson).
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| webEngine | string | "embedded", "system" |