Descripción del método

FirmaDescripción
wf.modificarValor(idElemento, valorElemento, idContenedor, indice)

Modifica el valor actual del elemento que tiene el id especificado con el nuevo valor pasado por parámetros (*)

  • idElemento. Corresponde con el Id del elemento de Webforms al que queremos actualizar su valor
  • valorElemento. Corresponde con el nuevo valor que queremos actualizar. Si estamos modificando un elemento de tipo Check tenemos que indicar el valor y no el texto.
  • idContenedor. Corresponde con el Id del contenedor (tabla o iterador) en el que se encuentra el elemento cuyo valor queremos modificar. Este parámetro es opcional
  • indice. Corresponde con el índice de la fila o iteración del contenedor en la que se encuentra el elemento cuyo valor queremos modificar. Este parámetro es opcional

(*) Se utiliza para todos los elemento salvo para los desplegables. Para modificar el valor de un desplegable tenemos que utilizar el método modificarValorDesplegable

Invocar el modificarValor de un campo dispara su evento change. Esto es importante tenerlo en cuenta cuando invocamos el modificarValor desde un evento change, especialmente cuando un campo trata de modificar su propio valor.

Versiones

VersiónCambio sufrido
5.0A partir de esta versión está disponible su uso

Ejemplo de uso

A continuación se muestran los casos de uso más tipos de esta función que nos podemos encontrar cuando estamos trabajando con un formulario 


Código utilizado

En los ejemplos siguientes, el código estará puesto en el apartado onLoad. El código puede localizarse en otras partes del formulario según el tipo de elemento.

Modificar un elemento de tipo input

/* Cambiamos el valor del elemento de tipo Input Nombre con ID nombre por 'Pedro José'*/
wf.modificarValor('nombre', 'Pedro José');

/* Mostramos en la consola el valor del elemento al que le hemos cambiado el valor */
console.log(wf.obtenerValor('nombre'));
JS

Ejemplo de modificar un elemento de tipo radio

/* El elemento radio tiene los siguientes valores
    valor: 1    texto: 2017
    valor: 2    texto: 2018
    valor: 3    texto: 2019
*/

/* Cambiamos el valor del elemento de tipo Radio "Seleccionar año" con ID anyo por '2018'*/

wf.modificarValor('anyo', '2');

/* Si usamos el texto el radio no funcionará correctamente */

/* Mostramos en la consola el valor del elemento al que le hemos cambiado el valor */

console.log(wf.obtenerValor('anyo'));
JS

Ejemplo de modificar un elemento de tipo check


/* El elemento de tipo check sólo puede tener los valores true (marcado) y false (desmarcado)'*/

wf.modificarValor('condiciones', true);

/* Mostramos en la consola el valor del elemento al que le hemos cambiado el valor */

console.log(wf.obtenerValor('condiciones'));
JS

Recursos


Descarga los distintos recursos utilizados