Skip to content

Configurator

Pick the options you need and copy the generated configuration object.

Choose a value for each option you want to change: the options object is generated as you go, and the input on the right uses it immediately. Options left on their default value are not included.

The object can be generated in its simplified form, with the values themselves, or in its detailed form, which refers to the AutoNumeric.options constants.

allowDecimalPadding See the demoDefines if the decimal places should be padded with zeroes
alwaysAllowDecimalCharacter See the demoDefines if the decimal character or decimal character alternative should be accepted when there is already a decimal character shown in the element.
caretPositionOnFocus See the demoDefines where should be positioned the caret on focus
createLocalList See the demoDefines if a local list of AutoNumeric objects should be kept when initializing this object.
currencySymbol See the demoDefines the currency symbol string.
currencySymbolPlacement See the demoDefines where the currency symbol should be placed (before of after the numbers)
decimalCharacter See the demoDefines what decimal separator character is used
decimalCharacterAlternative See the demoAllow to declare an alternative decimal separator which is automatically replaced by `decimalCharacter` when typed
decimalPlaces See the demoDefines the default number of decimal places to show on the formatted value, and keep for the precision
decimalPlacesRawValue See the demoDefines how many decimal places should be kept for the raw value rawValue
decimalPlacesShownOnBlur See the demoDefines how many decimal places should be visible when the element is unfocused
decimalPlacesShownOnFocus See the demoDefines how many decimal places should be visible when the element has the focus
defaultValueOverride See the demoHelper option for Asp.net postback
digitalGroupSpacing See the demoDefines how many numbers should be grouped together
digitGroupSeparator See the demoDefines the thousand grouping separator character
divisorWhenUnfocused See the demoThe number that divides the element value on focus
emptyInputBehavior See the demoDefines what should be displayed in the element if the raw value is an empty string ''
eventBubbles See the demoDefines if the custom and native events triggered by AutoNumeric should bubble up or not
eventIsCancelable See the demoDefines if the custom and native events triggered by AutoNumeric should be cancelable
failOnUnknownOption See the demoThis option is AutoNumeric's "strict mode" (aka 'debug' mode), which allows autoNumeric to strictly analyse the options given by the user, and fails if an unknown options is used in the settings object
formatOnPageLoad See the demoDetermine if the default value will be formatted on initialization
formulaMode See the demoDefines if the formula mode can be activated by the user
historySize See the demoSet the undo/redo history table size
isCancellable See the demoAllow the user to cancel and undo the changes he made to the given autonumeric-managed element, by pressing the Escape key
leadingZero See the demoControls the leading zero behavior
maximumValue See the demoDefines the maximum possible value a user can enter
minimumValue See the demoDefines the minimum possible value a user can enter
modifyValueOnWheel See the demoAllows the user to increment or decrement the element value with the mouse wheel
negativeBracketsTypeOnBlur See the demoAdds brackets-like characters on negative values when unfocused
negativePositiveSignPlacement See the demoPlacement of the negative/positive sign relative to the currencySymbol option
negativeSignCharacter See the demoDefines the negative sign symbol to use
noEventListeners See the demoDefines if the element should have event listeners activated on it
onInvalidPaste See the demoManage how autoNumeric react when the user tries to paste an invalid number
outputFormat See the demoDefines how the value should be formatted when wanting a localized version of it
overrideMinMaxLimits See the demoOverride the minimum and maximum limits
positiveSignCharacter See the demoDefines the positive sign symbol to use
rawValueDivisor See the demoDivides the formatted value shown in the AutoNumeric element and store the divided result in rawValue
readOnly See the demoDefines if the element (<input> or another allowed html tag) should be set as read only on initialization
roundingMethod See the demoDefines the rounding method to use
saveValueToSessionStorage See the demoSet to true to allow the decimalPlacesShownOnFocus value to be saved with sessionStorage
selectNumberOnly See the demoDetermine if the select all keyboard command will select the complete input text, or only the input numeric value
selectOnFocus See the demoDefines if the element value should be selected on focus
serializeSpaces See the demoDefines how the serialize functions should treat the spaces
showOnlyNumbersOnFocus See the demoDefines if the element value should be converted to the raw value on focus or mouseenter, (and back to the formatted on blur or mouseleave)
showPositiveSign See the demoAllow the positive sign symbol positiveSignCharacter to be displayed for positive numbers
showWarnings See the demoDefines if warnings should be shown in the console
styleRules See the demoDefines the rules that calculate the CSS class(es) to apply on the element, based on the raw unformatted value
suffixText See the demoAdd a text on the right hand side of the element value
symbolWhenUnfocused See the demoDefines the symbol placed as a suffix when not in focus or hovered
unformatOnHover See the demoDefines if the element value should be unformatted when the user hover his mouse over it while holding the Alt key
unformatOnSubmit See the demoWhen a submit event is detected in the parent form element, temporarily removes the formatting and set the rawValue in each AutoNumeric child elements
valuesToStrings See the demoProvides a way for automatically replacing the formatted value with a pre-defined string, when the raw value is equal to a specific value
watchExternalChanges See the demoDefines if the AutoNumeric element should watch external changes made without using .set()
wheelOn See the demoDefines when the wheel event will increment or decrement the element value
wheelStep See the demoDefines by how much the element value should be incremented/decremented on the wheel event