cat ~/blog/phone-mask-in-checkout.md
Маска телефона работала до выбора доставки. Потом исчезла
Поле выглядит нормально, пока покупатель не выбрал доставку. После AJAX появляется уже другой input, а старая маска остаётся на удалённом элементе. И это только одна из поломок.
Сценарий обычно выглядит невинно. Открыл оформление заказа, начал вводить +7 (999)... — маска работает. Выбрал другую доставку, вернулся к телефону — в поле можно написать хоть «позвонить после обеда».
Никакой магии. sale.order.ajax обновил часть формы и заменил сам <input>. Старый элемент вместе с прикреплённой маской удалён из DOM. Новый выглядит точно так же, но для JavaScript это другой объект.
На обычной статичной форме такой тест не воспроизведётся: там элемент создаётся один раз и спокойно доживает до отправки, тогда как в заказе компонент может заменить его после каждого изменения доставки или оплаты.
Поле появилось заново — маску подключаем заново
Скрипт с одним поиском полей на DOMContentLoaded здесь бесполезен. Он обработал старый input и закончил работу до того, как покупатель выбрал доставку.
Я подключаю маску к появляющимся элементам через MutationObserver. При повторном обходе уже обработанные поля пропускаются, иначе наблюдатель начнёт ставить маски поверх своих же изменений.
const observer = new MutationObserver(() => scan(document.body));
observer.observe(document.body, { childList: true, subtree: true });
// scan() ищет только поля, которые ещё не обработаны
Тот же приём спасает попапы «Заказать звонок» и «Купить в 1 клик». Их полей тоже нет в исходном HTML.
Плюс пропадает уже после оформления
Следующая поломка вообще не связана с браузером. Я поймал её на стенде, когда в заказе вместо +79991234567 оказалось 79991234567.
При включённой нормализации компонент оставляет от телефона цифры. Потом Битрикс сравнивает новое значение со старым нестрого и решает, что номер не изменился. Обработчик, который возвращает плюс перед сохранением, в этой ситуации может просто не повлиять на запись.
Пришлось лезть в исходники sale. Рабочим оказался обработчик после сохранения заказа: он записывает нормализованный номер с плюсом напрямую. Проверяются два случая — новый заказ и повторное сохранение существующего.
Так что если в поле плюс виден, а в админке его нет, маску можно оставить в покое. Смотреть нужно дальше по цепочке сохранения.
Две маски начинают спорить за курсор
Во многих шаблонах уже есть своя маска, например jquery.inputmask. Поверх неё подключают вторую. Первая ставит скобку, вторая переносит курсор, потом первая пытается всё вернуть.
Для посетителя это выглядит как прыгающий ввод и потерянные цифры. В консоли при этом может быть пусто.
Проще всего отключить обработку телефона в шаблоне. Если настройки нет, перед своей маской я снимаю маску шаблона. В модуле это делается на фокусе и повторно через 400 мс: некоторые темы успевают инициализировать своё поле ещё раз.
У России и Казахстана один код, но разные номера
Строка +7 (___) ___-__-__ визуально подходит обеим странам. На этом сходство заканчивается. Если правила знают только Россию, казахстанский номер либо отклоняется, либо проходит проверку не по своим правилам.
Я определяю страну по введённому номеру и оставляю человеку список выбора. Казахстан в нём — отдельная страна, хотя код снова +7. Пытаться угадать страну только по длине маски бессмысленно.
Список стран открылся где-то под попапом
Это моя любимая поломка, потому что логика здесь ни при чём. Выпадающий список переносится в конец <body>, а модальное окно имеет больший z-index.
Нажимаешь на флаг, список технически открыт, но находится под затемнением. Кажется, что кнопка не работает. Лечится CSS, зато обнаруживается только на живом попапе. На статичной форме в отдельном HTML-файле всё будет красиво.
Как я проверяю маску после исправления
- Ввожу российский номер и меняю доставку. Маска должна остаться, номер — не измениться.
- Открываю попап обратного звонка и повторяю ввод там.
- Вставляю
8 (999) 123-45-67из буфера. Номер должен распознаться как российский. - Ввожу казахстанский номер и проверяю выбранную страну.
- Оформляю тестовый заказ, затем пересохраняю его в админке. Плюс должен остаться на месте.
Все эти случаи уже собраны в модуле маски телефона. Но даже если вы чините форму своими руками, начните с выбора доставки. Именно этот короткий шаг чаще всего показывает, что маска была привязана к полю, которого больше нет.