AutoNumeric предоставляет мощные средства для работы с числовыми данными в веб-формах, включая удобное управление разделителями разрядов. Разделители разрядов — это символы, используемые для визуального разделения групп цифр в числах, чаще всего в тысячах, что повышает читаемость больших чисел. В библиотеке AutoNumeric это реализуется с помощью параметров форматирования, которые задаются при инициализации экземпляра.
AutoNumeric поддерживает два ключевых параметра для работы с разделителями:
digitGroupSeparator — символ, используемый для
разделения групп разрядов. Примеры: пробел ' ', запятая
',', точка '.'.decimalCharacter — символ, отделяющий целую часть числа
от дробной. Примеры: точка '.', запятая
','.Пример инициализации с настройкой разделителей:
new AutoNumeric('#price', {
digitGroupSeparator: ' ',
decimalCharacter: ',',
decimalPlaces: 2
});
В данном случае число 1234567.89 будет отображено как
1 234 567,89.
AutoNumeric автоматически форматирует вводимые значения, применяя заданные разделители разрядов. Это особенно полезно при работе с большими суммами или финансовыми данными, так как пользователь видит число в привычном виде в процессе ввода.
Пример динамического форматирования:
const priceInput = new AutoNumeric('#price', {
digitGroupSeparator: ',',
decimalCharacter: '.',
decimalPlaces: 0
});
// Ввод 1234567 преобразуется в 1,234,567
Библиотека отслеживает каждое изменение значения и автоматически вставляет разделители в соответствующих позициях.
AutoNumeric позволяет легко адаптировать отображение чисел под локальные стандарты, где правила форматирования отличаются:
digitGroupSeparator = ',',
decimalCharacter = '.' → 1,234,567.89digitGroupSeparator = '.',
decimalCharacter = ',' → 1.234.567,89digitGroupSeparator = ' ',
decimalCharacter = ',' → 1 234 567,89new AutoNumeric('#europePrice', {
digitGroupSeparator: '.',
decimalCharacter: ',',
decimalPlaces: 2
});
AutoNumeric поддерживает предустановленные конфигурации, которые включают стандартные разделители для различных валют и регионов. Это позволяет создавать единообразный формат чисел без необходимости вручную задавать каждый параметр.
Пример использования предустановки:
new AutoNumeric('#usdPrice', AutoNumeric.getPredefinedOptions().dollar);
Предустановка dollar автоматически применяет запятую для
тысяч и точку для десятичных разрядов.
При удалении символов AutoNumeric корректно обрабатывает разделители, не нарушая структуру числа.
Пример:
1 234 567,891 234 567,8Это позволяет избежать ошибок форматирования при динамическом редактировании числа пользователем.
AutoNumeric предоставляет методы для получения числового значения без разделителей, что важно при сохранении данных на сервере или при математических вычислениях:
const numericValue = AutoNumeric.getNumber('#price');
При значении поля 1 234 567,89 метод вернет число
1234567.89, полностью удалив визуальные разделители.
allowDecimalPadding — управляет автоматическим
добавлением нулей после десятичного разделителя.modifyValueOnWheel — позволяет изменять число с
колесиком мыши, сохраняя разделители.leadingZero — корректно обрабатывает числа с ведущими
нулями, не нарушая форматирование разрядов.Эти опции совместимы с разделителями разрядов и помогают поддерживать единый визуальный стиль числовых данных.
AutoNumeric допускает использование любой строки или символа в качестве разделителя. Это открывает возможности для создания нестандартных форматов, например:
new AutoNumeric('#custom', {
digitGroupSeparator: '*',
decimalCharacter: '|',
decimalPlaces: 3
});
Число 1234567.891 отобразится как
1*234*567|891. Такая гибкость позволяет интегрировать
библиотеку в любые дизайнерские решения интерфейса.
Разделители разрядов в AutoNumeric обеспечивают:
AutoNumeric сочетает простоту использования с мощными возможностями кастомизации, позволяя эффективно управлять отображением чисел с разделителями разрядов в любых веб-приложениях.