autoNumeric-2.0-BETA
last update 2014-08-02 GMT 11:00 AM
New methods
"unSet" - displays the raw value of the input.
- $(selector).autoNumeric('unSet'); - returns a numeric string as 'nnnn.nn' with the period '.' as the decimal character
- $(selector).autoNumeric('unSet', 'asKomma'); - returns numeric string 'nnnn,nn' with the comma / Komma ',' as the decimal character
- $(selector).autoNumeric('unSet', 'checkOptions'); - checks the options for the input and returns numeric string 'nnnn.nn' or 'nnnn,nn' based on the settings.
- This displays unformatted (xxxx.xx) numeric strings in the form inputs that are controlled by autoNumeric.
- autoNumeric is not "destroyed" allowing you to easily reformat the field after the form has been posted via the "reSet" option of the "set" method (see below).
- The "unSet" method will display the expanded decimal places if the "eDec" option is used.
"reSet" - resets the unset value
- Convenient way to reset value after post
"wipe' - deletes the value and any sessionStorage or cookies that were created by autoNumeric
- Unlike the "destroy" method autoNumeric is still active
- See option aStor below
"destroy' - modified to delete value, sessionStorage or cookies that were created by autoNumeric and kills autoNumeric
Modified methods
"get" - displays the raw value of the input.
- $(selector).autoNumeric('get'); - returns a numeric string as 'nnnn.nn' with the period '.' as the decinal charcter
- $(selector).autoNumeric('get', 'asKomma'); - returns numeric string 'nnnn,nn' with the comma / Komma ',' as the decinal charcter
- $(selector).autoNumeric('get', 'checkOptions'); - checks the options for the input and returns numeric string 'nnnn.nn' or 'nnn,nn' based on the settings.
"getString" - displays the raw value of the input.
- $(selector).autoNumeric('getString'); - returns a numeric string as 'nnnn.nn' with the period '.' as the decinal charcter
- $(selector).autoNumeric('getString', 'asKomma'); - returns numeric string 'nnnn,nn' with the comma / Komma ',' as the decinal charcter
- $(selector).autoNumeric('getString', 'checkOptions'); - checks the options for the input and returns numeric string 'nnnn.nn' or 'nnn,nn' based on the settings.
"getArray" - displays the raw value of the input.
- $(selector).autoNumeric('getArray'); - returns a numeric string as 'nnnn.nn' with the period '.' as the decinal charcter
- $(selector).autoNumeric('getArray', 'asKomma'); - returns numeric string 'nnnn,nn' with the comma / Komma ',' as the decinal charcter
- $(selector).autoNumeric('getArray', 'checkOptions'); - checks the options for the input and returns numeric string 'nnnn.nn' or 'nnn,nn' based on the settings.
New options and modifications
"eDec" - this displays expanded decimal places when the input has focus.
- Default value "eDec: null"
- eDec - value must be enclosed in quotes - example eDec: '5'
- The "eDec" value should be either "null" or greater than the normal decimal places set by the "vMin" & "vMax" values or "mDec" option.
- If the value being "set" is longer than the "eDec" value being set will be rounded.
- Currently there is no padding when the input has focus.
- Note - "eDec" will function properly with the following exception: if the "aStor = false" (the default) and the client navigates away from the page the extended value is lost and will be replaced with the non extended value!
- Note - to ensure the extended value (eDec) is retained the "aStor" option must be set to "true" see details below.
"nSep" - this displays the number with decimal only when the input has focus.
- This is similar to the behavior of a spread spreadsheet
- On focusout the value is formatted again
"aStor" - when true allows the "eDec" value to be retained via sessionStorage on compatible browsers of a session cookie in EI 6 & 7.
- Default value "aStor: true"
- Set to "aStor: false" to NOT use session storage.
- Note - sessionStorage or session cookie is used only on fields when eDec does not equal null and is greater than mDec.
- Note - once the browser is shut down or the tab is closed all extended values held in sessionStorage or cookies are deleted.
"oRide" - overrides min / max values and controls the number of integers. Helpful when you run into the limits of javaScript math accuracy.
- example oRide: '6,0' allows positive values only with 6 integers with zero decimal places
- example oRide: '-8,2' allows positive and negative values with 8 integers and 2 decimal places
- Note - do not use the 'mDec' option when using "oRide"
"pNeg" - positions the minus sign "-" to the left or the right of the currency sign.
- Only works when the currency sign is a prefix
- When the "-" is the the right of the currency sign "negative brackets will not function
"aSuffix" - allows a suffix to be place at the far right.
- Can be used with "aSign" in either prefix or suffix
"mRound" - added rounding method used in Switzerland
- mRound: "CHF" rounds to the nearest .X0 or .X5
"dGroup" - modified the digital grouping
- Support for a modified lakh "22,333,22,22,333.00" that can be used for scaling
Notes:
- Default values and Values being set can use either the period '.' or Komma ',' as the decimal character
Demonstration showing the new features:
- Focus and focusout of the inputs to see the behavior for the different inputs.
- Change the values.
- Navigate away and return to see the values are retained and see how the "aStor" option behaves.
- Press the "unSet" and the "set" method with the "reSet" value.
- Press the "wipe" and try entering leters.
- Press the "destroy" and try entering leters.
- reload page and try more changes.
Text " contenteditable" - this is on my wish list is to eventually get autoNumeric to work here - the issue is there is no reliable method to place the caret.
$1,000.00