Á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 $4den 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 | 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.
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, 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 | 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. En Windows, 4D utiliza automáticamente la versión más reciente del navegador encontrado en la máquina (IE11, MS Edge, etc.). En macOS, 4D utiliza la versión actual de WebKit (Safari). 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, puede notar algunas diferencias de representación entre las implementaciones de Internet Explorer/Edge y las de Web Kit. - marcado -
valor JSON: anidado: en este caso, 4D utiliza el motor Blink de Google. 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). Using the embedded Web engine means that Web area rendering and their functioning in your application are identical regardless of the platform used to run 4D (slight variations of pixels or differences related to network implementation may nevertheless be observed).
Tenga en cuenta que el motor Blink tiene las siguientes restricciones:
* [WA SET PAGE CONTENT](https://doc.4d.com/4Dv18/4D/18.4/WA-SET-PAGE-CONTENT.301-5232965.en.html):utilizar este comando requiere que al menos una página ya esté cargada en el área (a través de una llamada a [WA OPEN URL](https://doc.4d.com/4Dv18/4D/18.4/WA-OPEN-URL.301-5232954.en.html) o una asignación a la variable URL asociada al área).
* La ejecución de JavaScript está siempre activada; la ejecución de applets y plug-ins Java está siempre desactivada. Estos parámetros no pueden ser modificados en Blink. Los siguientes selectores de los comandos [WA SET PREFERENCE](https://doc.4d.com/4Dv18/4D/18.4/WA-SET-PREFERENCE.301-5232962.en.html) y [WA GET PREFERENCE](https://doc.4d.com/4Dv18/4D/18.4/WA-GET-PREFERENCE.301-5232945.en.html) se ignoran:
* `WA enable Java applets`
* `WA enable JavaScript`
* `WA enable plugins`
* Cuando se activa soltar URLs mediante el selector `WA enable URL drop` del comando [WA SET PREFERENCE](https://doc.4d.com/4Dv18/4D/18.4/WA-SET-PREFERENCE.301-5232962.en.html), la primera soltada debe ir precedida de al menos una llamada a [WA OPEN URL](https://doc.4d.com/4Dv18/4D/18.4/WA-OPEN-URL.301-5232954.en.html) o una asignación a la variable URL asociada al área.
Gramática JSON
| Nombre | Tipos de datos | Valores posibles |
|---|---|---|
| webEngine | string | "embedded", "system" |