La acción OnLoad nos va a permitir introducir código JavaScript en nuestro formulario, haciendo uso de las diferentes utilidades que nos proporciona Webforms.

Este código se ejecutará una vez se complete la carga inicial del formulario, siguiendo el siguiente orden:

¿Cómo se relacionan estos objetos?

Te recomendamos consultar la página Relación entre formularios, fragmentos y subfragmentos si no tienes clara la relación entre ellos.

Una vez que seleccionamos OnLoad se nos abre una ventana que se corresponde con el editor de código que incorpora Webforms.

Este editor de código nos va a indicar el número de línea de código (mejorando la depuración) así como el resaltado de colores con las palabras reservadas y la autoidentación.

Aparte de lo anterior, el editor incorpora tres botones en la parte superior:

  • Mostrar todos los IDs: Nos va a mostrar una lista con todos los IDs de nuestro formulario. Haciendo click sobre cualqueir ID se copia directamente al portapapeles
  • Mostrar las utilidades: Nos muestra la lista de utilidades que tenemos acceso
  • Mostrar ayuda: Nos enseña una serie de ejemplos típicos con los casos más utilizados. Varía dependiendo de la opción de Webforms en la que estemos añadiendo el código JavaScript

Uso recomendado

Como se puede observar en el diagrama, el código en OnLoad es ejecutado al final de todo el proceso de visualización del formulario.

Esto implica una serie de recomendaciones de uso:

  • Código para modificar partes o funcionamiento del formulario (tick)
  • Código para añadir funciones (error)
  • Código para añadir lógica que vaya a ser utilizada en el diseñador (error)
  • Código a ejecutar cuando el usuario esté rellenando el formulario (error)
    • Mejor en el propio formulario. Ver Eventos.
  • Código para revisar los valores de los campos (error)

Ejemplo

Ejemplo

// Oculto los campos que no necesito de mi fragmento

wf.ocultarCampo("[[municipio]]");
wf.ocultarCampo("[[via]]");
wf.ocultarCampo("[[bloque]]");

// No quiero que al generar un PDF en blanco tenga el campo municipio
if (renderMode == "BLANK_PDF") {
   wf.ocultarCampo("[[municipio]]");
}
JS