En este capítulo se describen clases y funciones en JavaScript que proporciona el framework al desarrollador para agilizar el proceso de creación de capturas y presentación de datos e información al usuario final.

Esta clase permite darle formato a los diferentes tipos de datos que pueden ser incluidos dentro de una captura de datos o una vista tal. Está enteramente codificada en javascript usando el framework Prototype. Tiene licencia de uso y modifcación totalmente abierta y hace parte del proyecto de Herramientas JavaScript de uso común en Aplicaciones Web.

Para iniciar el uso de esta herramienta es necesario crear un objeto que definirá las propiedades que se usarán para darle formato a los datos. Esto se logra de la siguiente manera:

<script type="text/javascript">
var format = new Format({
     type: 'numeric',
     properties: { decimals: 2, letNegative: false, blankToZero: false } }, {
     type: 'percent',
     properties: { decimals: 3, complete: 2 } }, {
     type: 'money',
     properties: { decimals: 2, simbMon: 'US$', leftZeros: 1 } 
});
</script>

Puede notar que no todas estas propiedades deben ser definidas, todas poseen valores por defecto que serán usados en principio para el formato. Estas propiedades son determinadas por el tipo, con lo cual se usa la notación type: 'nombre_tipo', properties: {propiedades}.

Los tipos de datos soportados por el Format son: numeric, que define las propiedades para los valores que serán numéricos, tanto enteros como punto flotante; percent, para los valores que tienen un formato de porcentaje; money en el cual se establecen los atributos para los datos tipo moneda.

Opciones del constructor de Format:

Uso del Format:

<div><input id="temp" type="text" /></div>

Númerico:

<input type='boton' onclick='formatoNumerico()' />
<input type='boton' onclick='deFormatoNumerico()' />

<script type="text/javascript">
     function formatoNumerico(){
          $('temp').value = format.numeric($F('temp'));
     }
     function deFormatoNumerico(){
          $('temp').value = format.deFormat($F('temp'),'numeric');
     }
</script>

Nótese que una vez que ha sido creado el objeto format lo único que debe hacerse es usarlo para dar formato a los datos que se tengan, asimismo es posible deshacer dicho formato haciendo uso de la función deFormat. También es importante observar que todos los llamados son dinámicos y debe usarse un objeto definido para ello es decir, antes de usar cualquier función es necesario crear un objeto como se indica en el apartado Instanciando la clase, y una vez hecho esto todas las funciones se deben invocar con variable.función(parámetros).

numeric(number)
Formatea un número que es ingresado como parámetro usando las propiedades definidas para los tipo numeric al instanciar la clase o que hayan sido establecidas con el método changeProperties. Retorna una cadena de caracteres que posee el formato adecuado.

money(number)
Formatea un número que es ingresado como parámetro usando las propiedades definidas para los tipo money al instanciar la clase o que hayan sido establecidas con el método changeProperties. Retorna una cadena de caracteres que posee el formato adecuado, agregando el símbolo de pesos requerido.

percent(number)
Formatea un número que es ingresado como parámetro usando las propiedades definidas para los tipo percent al instanciar la clase o que hayan sido establecidas con el método changeProperties. Retorna una cadena de caracteres que posee el formato adecuado, agregando el símbolo porcentual definido.

changeProperties()
Cambia las propiedades del tipo especificado. Las propiedades que no sean incluidas conservan su valor anterior.

format.changeProperties({type: 'numeric', properties: { letNegative: false } });

deFormat(str,type)
Deformatea una cadena de caracteres. Recibe como parámetros "str" que representa la cadena de texto a procesar; "type" que debe ser el tipo de formato al que fue sometida dicha cadena.

Esta clase permite realizar validaciones a los diferentes datos que pueden ser incluidos dentro de una captura de datos o una vista tal. Está enteramente codificada en javascript usando el framework Prototype. Tiene licencia de uso y modifcación totalmente abierta y hace parte del proyecto de Herramientas JavaScript de uso común en aplicaciones Web.

Antes de hacer uso de esta clase debe instanciarse un objeto que contendrá las propiedades para las validaciones que se requieran. El constructor del objeto acepta tipos predefinidos y otros personalizados que se definen dinámicamente.

Tipos de dato predefinidos en Validator:

<script type="text/javascript">
var val = new Validator();
</script>