Полный список опций

decimalCharacter

Определяет символ, используемый для отделения целой части числа от дробной.

Чаще всего используются:

  • . (точка) — стандарт в англоязычных локалях
  • , (запятая) — распространён в европейских форматах

Пример поведения:

  • 1234.56
  • 1234,56

Внутренне библиотека использует этот символ для парсинга и форматирования значения при вводе, вставке и программном изменении.

digitGroupSeparator

Устанавливает символ разделения групп разрядов в целой части числа.

Типовые значения:

  • пробел " "
  • запятая ","
  • точка "."
  • апостроф "'"

Примеры отображения:

  • 1 000 000
  • 1,000,000
  • 1.000.000

decimalPlaces

Определяет фиксированное количество знаков после запятой.

Поведение:

  • значение 2 → всегда 2 знака дробной части
  • значение 0 → дробная часть отсутствует
  • значение null → количество может изменяться динамически

При вводе и программном setValue происходит автоматическое округление.

decimalPlacesRawValue

Определяет количество знаков после запятой в «сыром» значении (internal/raw value), используемом для вычислений.

Отличается от decimalPlaces тем, что:

  • не влияет на отображение напрямую
  • используется при получении значения через API

minimumValue

Устанавливает минимально допустимое значение.

Примеры:

  • 0 → запрет отрицательных чисел
  • -100 → ограничение снизу

При превышении нижней границы значение автоматически корректируется или блокируется ввод.

maximumValue

Устанавливает максимально допустимое значение.

Поведение аналогично minimumValue, но ограничивает верхнюю границу.

Форматирование числа

currencySymbol

Задаёт символ валюты или любой префикс/суффикс.

Примеры:

  • $
  • €
  • ₸
  • USD

currencySymbolPlacement

Определяет позицию символа валюты:

  • p — префикс (до числа)
  • s — суффикс (после числа)

Примеры:

  • $ 1,000
  • 1,000 $

decimalCharacterAlternative

Позволяет использовать альтернативные символы ввода для десятичного разделителя.

Пример:

  • ввод . автоматически интерпретируется как ,

Полезно для локализаций и клавиатурных раскладок.

digitGroupSeparatorAlwaysShow

Принудительно отображает разделители групп разрядов даже для малых чисел.

Пример:

  • 1000 → 1,000
  • 12 → 12

Поведение ввода

emptyInputBehavior

Определяет, как ведёт себя поле при пустом вводе.

Возможные значения:

  • null → значение отсутствует
  • zero → интерпретируется как 0
  • min → подставляется minimumValue
  • focus → поведение зависит от фокуса

Влияет на UX и на интеграцию с формами.

leadingZero

Контролирует поведение нулей в начале числа.

Возможные режимы:

  • allow — разрешены ведущие нули (0012)
  • deny — автоматически удаляются (12)
  • keep — сохраняются без изменений

selectOnFocus

Определяет поведение выделения текста при получении фокуса.

Если включено:

  • всё значение выделяется целиком при фокусе

Используется для быстрого перезаписывания значения.

caretPositionOnFocus

Управляет позицией курсора при фокусе:

  • начало строки
  • конец строки
  • сохранение позиции

Округление и точность

roundingMethod

Определяет метод округления.

Распространённые варианты:

  • S — half up (классическое математическое)
  • A — away from zero
  • F — floor (вниз)
  • C — ceiling (вверх)
  • U — truncate (обрезание)

allowDecimalPadding

Контролирует добавление нулей до фиксированного количества знаков.

Примеры:

  • 1.5 → 1.50 (если включено)
  • 1.5 → 1.5 (если выключено)

Отрицательные числа

negativeSignCharacter

Задаёт символ отрицательного числа:

  • - (по умолчанию)
  • может быть заменён на другой символ при кастомизации

negativePositiveSignPlacement

Управляет расположением знака:

  • слева от числа
  • рядом с валютным символом
  • внутри форматированной строки

negativeBracketsTypeOnBlur

Определяет отображение отрицательных значений при потере фокуса.

Примеры:

  • -123 → (123)
  • -123 → [123]

Используется в бухгалтерских интерфейсах.

Поведение мыши и клавиатуры

modifyValueOnWheel

Разрешает изменение значения с помощью колёсика мыши.

Особенности:

  • изменение шага зависит от настроек
  • можно ограничить диапазоном min/max

wheelStep

Определяет шаг изменения при прокрутке.

Пример:

  • 1 → +1 / -1
  • 0.1 → дробное изменение

onWheelStep

Функция-колбэк для динамического расчёта шага прокрутки.

Позволяет адаптировать поведение под контекст (например, масштабирование значений).

Внешние изменения и синхронизация

watchExternalChanges

Включает отслеживание изменений DOM-значения извне библиотеки.

Если активировано:

  • изменения через value = ... или сторонние скрипты синхронизируются

observerFunction

Позволяет задать пользовательскую функцию наблюдения за изменениями.

Используется для сложных сценариев интеграции с реактивными системами.

Поведение при фокусе и blur

showOnlyNumbersOnFocus

При фокусе скрывает форматирование и показывает «сырое» число.

После потери фокуса формат возвращается.

unformatOnSubmit

Перед отправкой формы значение преобразуется в неформатированный вид.

serializeSpaces

Управляет тем, как пробелы обрабатываются при сериализации значения.

Валидация и ограничения

isCancellable

Определяет возможность отмены некорректного ввода.

Если включено:

  • библиотека откатывает недопустимые изменения

noEventListeners

Полностью отключает внутренние события AutoNumeric.

Используется при интеграции с внешними системами управления состоянием.

Кастомизация символов и масок

suffixText

Добавляет статический текст после числа.

Пример:

  • 100 km
  • 250 pcs

prefixText

Добавляет статический текст перед числом.

Пример:

  • ≈ 100
  • > 50

rawSymbol

Позволяет задавать альтернативное внутреннее представление символов, отличное от отображаемого.

Дополнительные параметры поведения

formatOnPageLoad

Определяет, форматируется ли значение при загрузке страницы.

saveValueToSessionStorage

Сохраняет значение в sessionStorage для восстановления состояния.

historySize

Определяет количество шагов истории изменений для undo/redo.

createLocalList

Создаёт локальный список допустимых значений для автокоррекции ввода.

decimalPlacesShownOnBlur

Количество знаков после запятой при потере фокуса.

Отличается от decimalPlaces, так как влияет только на отображение вне фокуса.

decimalPlacesShownOnFocus

Количество знаков после запятой при фокусе.

Используется для повышения точности при редактировании.

Оглавление