*<<BACK HOME CNCPT* TTRL JS**	sf.net/projects/validateformjs	`[ U \| s \| m \| ? ]`
`rqd DEC eml int len mcr bss trm sif`		All Concepts
`frm txt pwd txa rdo sl1 chk slm`		All Object Types

`validate_form.js`
Concept: `sMsgTxtDec`

Ensures a string value is a valid decimal,optionally within a range. Summary
sMsgTxtDec All Attributes
txt pwd txa rdo sl1 chk slm Interactive Example Code
Higher [ trm rqd len DEC eml int sif mcr bss ] Lower Precedence

[TOP] sMsgTxtDec attribute: sMsgTxtDec

Value Purpose The error message presented to the user when the value is not a valid decimal,or is out of range.

Value Rules Must be a string at least one character in length.

Object Compatibility text, password

Attribute Compatibility sMsgRequired, sMsgBadLength, bsNoBadSubStrs, asBadSubStrs, sMsgBadSubStr, bsDontTrimSpaces, bsTrimSpaces

Special Strings

~RANGE_MIN~: Translated to dDecMin
~RANGE_MAX~: Translated to dDecMax

Sub-Range

Name	Purpose	Rules
`dDecMin`	The minimum allowable value	Optional. When provided, must be a decimal. When `dDecMax` is also provided, this must be less-than-or-equal-to it.
`dDecMax`	The maximum allowable value	Optional. When provided, must be a decimal. When `dDecMin` is also provided, this must be greater-than-or-equal-to it.

Other `sMsgTxtDec` Notes

The actual validation is done by util_string.isNum().
A legal integer is also a legal decimal, but not vice-versa. While 12345 is both a legal integer and decimal number 12345.54321 is a legal decimal but not a legal integer.
Precision: I've not yet figured this out exactly, but if your number--the string value, in your form's text box, that will be translated to a number--has too many decimal places, it'll be automatically trimmed to a less precise number. For example: "10.55000000000001" (14 decimal places) is a decimal that has few enough decimal places that it is not trimmed when translated from a string to a number. Therefore, it truly equals 10.55000000000001. However, "10.550000000000001" (15) has too many decimal places, and is trimmed to equal 10.55000000000000, and therefore, 10.55. This must also be true for integers, on the other side of the decimal, so be careful if that much precision on either side is important to you.

TOP    
rqd DEC eml int len mcr bss trm sif
<<BACK 
TXT pwd txa rdo sl1 chk slm

Object Type	Concept
`text`	`sMsgTxtDec`

VF-Config Snippet f_orm.fav_dec.sMsgTxtDec = 'Your favorite decimal must be an *decimal*, and between ~RANGE_MIN~ and ~RANGE_MAX~, inclusive.'
Example Element <INPUT TYPE="text" NAME="fav_dec">

The form	Change the vf-configuration
What is your favorite decimal?	`sMsgRequired` `dDecMin` `dDecMax`
[[ [ CIBC CRSH ] `DBG` ]]

TOP    
rqd DEC eml int len mcr bss trm sif
<<BACK 
txt PWD txa rdo sl1 chk slm

Object Type	Concept
`password`	`sMsgTxtDec`

VF-Config Snippet f_orm.secret_dec.sMsgTxtDec = 'Your secret decimal (shhhhh) must be an *decimal*, and between ~RANGE_MIN~ and ~RANGE_MAX~, inclusive.';
Example Element <INPUT TYPE="text" NAME="secret_dec">

The form	Change the vf-configuration
What is your secret decimal (shhhh)?	`sMsgRequired` `dDecMin` `dDecMax`
[[ [ CIBC CRSH ] `DBG` ]]

Ensures a string value is a valid decimal,optionally within a range.	Summary
`sMsgTxtDec`	All Attributes
`txt pwd txa rdo sl1 chk slm`	Interactive Example Code
Higher `[ trm rqd len DEC eml int sif mcr bss ]` Lower	Precedence

VF-Config Snippet	`f_orm.fav_dec.sMsgTxtDec = 'Your favorite decimal must be an decimal, and between ~RANGE_MIN~ and ~RANGE_MAX~, inclusive.'`
Example Element	`<INPUT TYPE="text" NAME="fav_dec">`

VF-Config Snippet	`f_orm.secret_dec.sMsgTxtDec = 'Your secret decimal (shhhhh) must be an decimal, and between ~RANGE_MIN~ and ~RANGE_MAX~, inclusive.';`
Example Element	`<INPUT TYPE="text" NAME="secret_dec">`

validate_form.js Concept: sMsgTxtDec

Other sMsgTxtDec Notes

`validate_form.js`
Concept: `sMsgTxtDec`

Other `sMsgTxtDec` Notes