Статические методы библиотеки AutoNumeric предназначены для работы без привязки к конкретному экземпляру, связанному с DOM-элементом. Они решают задачи преобразования значений, поиска и управления уже инициализированными инстансами, а также предоставляют доступ к глобальным настройкам и вспомогательным утилитам.
Ключевая особенность статического слоя заключается в том, что он оперирует либо «сырыми» значениями, либо уже существующими инстансами AutoNumeric, не требуя повторной инициализации или наличия прямой ссылки на объект.
Одним из базовых статических методов является получение инстанса, связанного с DOM-элементом.
AutoNumeric.getAutoNumericElement(element);Метод возвращает объект AutoNumeric, если элемент уже был
инициализирован. В противном случае результат обычно равен
null или undefined (в зависимости от версии
библиотеки).
Используется в сценариях, когда требуется безопасно обратиться к уже существующей логике форматирования:
Дополнительно в некоторых версиях присутствует вариация:
AutoNumeric.isManagedByAutoNumeric(element);Метод возвращает булево значение, показывающее, управляется ли элемент библиотекой.
Для массовой инициализации часто используется статический метод:
AutoNumeric.multiple(selector, options);Он принимает CSS-селектор или список элементов и применяет AutoNumeric ко всем найденным узлам.
Основные особенности:
Пример типичного поведения:
Статический метод форматирования позволяет преобразовать число в строку с учетом настроек библиотеки:
AutoNumeric.format(value, options);Используется для:
Параметры options обычно включают:
Форматирование выполняется независимо от DOM, что делает метод пригодным для изолированных вычислений.
Для получения «чистого» числового значения используется:
AutoNumeric.unformat(formattedValue, options);Метод удаляет:
Результатом обычно является строка или число (в зависимости от конфигурации).
Используется при:
В некоторых версиях API присутствует логика, аналогичная:
AutoNumeric.parse(value, options);Она может быть эквивалентна unformat, но в более строгом
смысле выполняет преобразование строки в числовой тип с учетом правил
конфигурации.
AutoNumeric предоставляет доступ к предустановленным конфигурациям:
AutoNumeric.getPredefinedOptions();Результатом является набор шаблонов настроек, включающих типовые сценарии:
Эти конфигурации служат базой для быстрого старта без ручной настройки каждого параметра.
В ряде реализаций присутствует метод:
AutoNumeric.getDefaultConfig();Он возвращает конфигурацию по умолчанию, которая используется при отсутствии пользовательских параметров.
Это важно для:
Для проверки корректности настроек используется:
AutoNumeric.validate(options);Метод анализирует переданный объект и проверяет:
Валидация предотвращает создание некорректных инстансов и снижает риск ошибок форматирования.
AutoNumeric.isManagedByAutoNumeric(element);Используется для безопасного определения состояния элемента перед выполнением операций:
Некоторые реализации предоставляют обратную связь:
AutoNumeric.getElement(autoNumericInstance);Метод возвращает DOM-элемент, связанный с конкретным инстансом. Это полезно при работе с коллекциями объектов, когда требуется синхронизация логики и UI.
AutoNumeric.multiple(selector, options);Этот метод часто применяется в формах с большим количеством числовых полей. Он обеспечивает:
Типичный сценарий — формы финансовых данных, где десятки input-элементов должны иметь одинаковую логику форматирования.
Статические методы часто используются как чистые функции для работы с данными:
Эти операции не требуют наличия DOM и могут применяться в бизнес-логике приложения.
Статические методы обеспечивают несколько ключевых свойств архитектуры библиотеки:
Такой подход делает AutoNumeric удобным не только для UI-слоя, но и для сервисных и вычислительных модулей приложения.