Utilizar unos IDs semánticos para nuestros elementos puede facilitar su identificación.

Pero, ¿qué pasa cuando se inserta un fragmento que tiene un ID que ya utilizo en el formulario?

Webforms contempla ese caso.

Para evitar este tipo de problemas, se ha definido la forma en la que se debe nombrar a estos identificadores en los fragmentos.

Cualificación de nombres

La cualificación de nombres, sólo la debemos hacer cuando hacemos uso de JavaScript (onLoad, Eventos, Validaciones, MostrarSi, etc.)

Fragmentos y subfragmentos

Sólo debemos utilizar la cualificación de nombres en fragmentos y subfragmentos. En los formularios no es necesario.

Ficheros JS

La cualificación de nombres no está habilitada en los ficheros JavaScript.

Entonces, ¿cómo se hace?

Se ha de pasar al método que llames el nombre ya cualificado.

Por ejemplo:  convertirMayusculuas('[[nombreProvincia]]');

A continuación se describe la forma de nombrar las variables en Webforms para poder acceder según el ámbito.

[[  IDENTIFICADOR  ]]    :   El uso de llaves indica que el identificador que contiene se va a sustituir ya que ese elemento forma parte de un fragmento o subfragmento.

Formulario

  • ID del formulario: {ID}
  • ID de un fragmento: {Nombre-Subfragmento}-{ID}
  • ID de un subfragmento: {Nombre-Fragmento}-{Nombre-Subfragmento}-{ID}

Fragmento

  • ID del fragmento: [[{ID}]]

  • ID del subfragmento: [[{Nombre-Subfragmento}-{ID}]]

Subfragmento

  • ID del subfragmento: [[{ID}]]

Ejemplos de uso

Código utilizado

En el ejemplo siguiente, el código estará puesto en el apartado onLoad. No obstante, el código puede localizarse en otras partes del formulario.

Formulario

/* Obtener el valor de un elemento del formulario */
var nombre = wf.obtenerValor("nombre");

/* Obtener el valor de un elemento dentro de un fragmento */
var tipoNotificacion = wf.obtenerValor("Notificacion-tipo_notificacion");

/* Obtener el valor de un elemento dentro de un subfragmento */
var codigoPostal = wf.obtenerValor("Notificacion-DireccionPostal-codigopostal");
JS

Fragmento

/* Obtener el valor de un elemento del fragmento */
var tipoNotificacion = wf.obtenerValor("[[tipo_notificacion]]");

/* Obtener el valor de un elemento dentro de un subfragmento */
var codigoPostal = wf.obtenerValor("[[DireccionPostal-codigopostal]]");
JS

Subfragmento

/* Obtener el valor de un elemento dentro de un subfragmento */
var codigoPostal = wf.obtenerValor("[[codigopostal]]");
JS

Recursos

Descarga los distintos recursos utilizados