1С Битрикс · 8 мин чтения

Маска телефона в форме Битрикс: ввод номера без ошибок

Маска телефона Битрикс держится на трёх слоях: подсказка формата в самом поле, проверка в браузере и нормализация номера на сервере. Обычно ставят только первый слой, а потом в CRM лежат «8999 123 45 67», «+7(999)1234567» и «89991234567». Поиск дублей их не склеивает, а менеджер звонит на номер с лишней цифрой.

Ниже мой рабочий вариант для форм на 1С-Битрикс: короткий скрипт без библиотек, подключение через шаблон в /local, серверная проверка на PHP и список ошибок, на которые я натыкался в живых формах. Формат по умолчанию российский, +7 (999) 123-45-67.

Маска ввода телефона в Битрикс: какой способ выбрать

Маска не зависит от того, на чём собрана форма. Веб-формы, компонент main.feedback, самописной компонент с AJAX или форма во всплывающем окне: в разметке у каждой лежит input, и маска цепляется именно к нему. Поэтому выбирать приходится не «под компонент», а под то, как форма попадает на страницу и сколько разных форматов нужно принимать.

Способ Что подключать Работает после перерисовки формы по AJAX Где неудобен
Атрибуты type=“tel” и pattern без JS Ничего Да, атрибуты остаются в разметке Номер не форматируется при наборе, ошибку человек видит только при отправке
Библиотека вроде Inputmask или IMask Файл библиотеки и код инициализации Нужна повторная инициализация для новых полей Лишний файл ради одной маски на сайте с одним форматом
Свой скрипт на делегировании событий Один небольшой файл в шаблоне сайта Да, слушатель висит на document Разбор вставки и иностранных номеров придётся поддерживать самому
intl-tel-input с выбором страны Библиотека и стили Нужна повторная инициализация для новых полей Усложняет форму, если клиенты только из России

Если форма собрана в CRM Битрикс24 и вставлена на сайт виджетом, разметкой поля вы не управляете, а набор настроек поля телефона смотрите прямо в редакторе формы. Когда нужна своя маска, форму делают на сайте, а заявка уходит в CRM через REST, например методом crm.item.add, уже с нормализованным номером.

Для сайта с российской аудиторией и несколькими формами я беру свой скрипт на делегировании событий. Библиотека оправдана, когда нужны разные маски по странам. Один pattern без JS не годится: он ругается при отправке, а не во время набора, и человек раздражается уже после того, как заполнил всю форму.

Скрипт маски номера для формы на чистом JS

Сначала само поле. Тип tel вызывает на телефоне цифровую клавиатуру, inputmode и autocomplete помогают мобильным браузерам, а pattern отсекает неполный номер до отправки. Имя поля у вас будет своё, в веб-формах оно генерируется по идентификатору поля.

<input type="tel" name="PHONE" class="js-phone"
       inputmode="tel" autocomplete="tel"
       placeholder="+7 (999) 123-45-67"
       pattern="\+7 \(\d{3}\) \d{3}-\d{2}-\d{2}" required>

Теперь скрипт. Он забирает из значения все цифры, заменяет ведущую 8 на 7, добавляет 7 впереди, если номер начинается не с 7 и не с 8, обрезает лишнее и собирает строку заново.

(function () {
  function formatPhone(value) {
    var digits = value.replace(/\D/g, '');
    if (digits === '') {
      return '';
    }
    if (digits[0] === '8') {
      digits = '7' + digits.slice(1);
    } else if (digits[0] !== '7') {
      digits = '7' + digits;
    }
    var d = digits.slice(1, 11);
    var out = '+7';
    if (d.length > 0) out += ' (' + d.slice(0, 3);
    if (d.length > 3) out += ') ' + d.slice(3, 6);
    if (d.length > 6) out += '-' + d.slice(6, 8);
    if (d.length > 8) out += '-' + d.slice(8, 10);
    return out;
  }

  document.addEventListener('input', function (e) {
    var input = e.target;
    if (!input.matches || !input.matches('input.js-phone, input[type=tel]')) {
      return;
    }
    input.value = formatPhone(input.value);
  });
})();

В этом коде три решения, на которых обычно спотыкаются.

  • Скобка, пробелы и дефисы дописываются только тогда, когда есть следующая цифра. Если добавлять закрывающую скобку сразу после третьей цифры, Backspace её сотрёт, а маска тут же вернёт на место, и поле не очистить.
  • Значение всегда собирается заново из цифр, поэтому вставка «8 999 123-45-67», «+7(999)1234567» или номера с автозаполнения браузера приводится к одному виду без отдельной обработки.
  • Когда поле стёрто до одного «+», оно очищается целиком. Если оставлять «+7» насильно, человек не может удалить номер и начинает жаловаться на «глючную форму».

Одно ограничение честно назову: при правке цифры в середине номера курсор прыгает в конец. Для короткого номера это терпимо, для более сложных сценариев в библиотеках есть готовая работа с позицией курсора.

Бесплатный материал

🎁 Полезный скрипт в подарок

Подпишитесь на Telegram - пришлю готовый скрипт по этой теме.

Без спама. Отписка в 1 клик.

Подключение в шаблон через /local и работа с AJAX-формами

Файл со скриптом кладу в /local/templates/<шаблон>/js/phone-mask.js. Кастомизация через /local нужна потому, что при обработке папок приоритет у /local, и правки не лежат среди файлов ядра. Подключается файл в header.php шаблона до вызова $APPLICATION->ShowHead():

<?php
\Bitrix\Main\Page\Asset::getInstance()->addJs(SITE_TEMPLATE_PATH . '/js/phone-mask.js');

Слушатель повешен на document, а не на конкретные input. Это важно для Битрикса: компоненты часто перерисовывают форму после отправки через AJAX, а формы обратного звонка открываются в попапе и подгружаются уже после загрузки страницы. Обработчик, навешенный на поле при старте, к этому моменту либо не видит поле, либо теряется вместе со старой разметкой. Делегирование срабатывает для любого поля, которое появилось на странице позже.

Если поле выводит стандартный шаблон компонента, копирую шаблон в /local/templates/<шаблон>/components/ и в копии добавляю полю класс js-phone и тип tel. Когда поле собирается вспомогательной функцией компонента и класс передать некуда, в скрипте подойдёт селектор по имени поля, например input[name*=PHONE].

Если форм много, часть из них лежит в компонентах с кастомными шаблонах, а маску нужно сразу привести к одному виду по всему сайту, такую работу проще отдать на доработку и поддержку 1С-Битрикс. Я беру такие задачи от 3 000 ₽ за час, небольшая правка масок занимает от одного часа.

После выкладки сбросьте кэш браузера и проверьте форму в трёх местах: на обычной странице, во всплывающем окне и после неудачной отправки, когда компонент показывает форму с ошибками. Именно в последних двух случаях маска чаще всего пропадает.

Валидация телефона на сервере и единый формат номера

Маска и pattern работают только в браузере. Любой, кто отправит POST напрямую, пришлёт что угодно, а часть спам-ботов так и делает. Поэтому в обработчике формы номер приводится к единому виду и проверяется повторно. В базу и в CRM я отправляю формат +79991234567: без пробелов, скобок и дефисов.

<?php
use Bitrix\Main\Application;

function normalizePhone(string $raw): ?string
{
    $digits = preg_replace('/\D+/', '', $raw);

    if (strlen($digits) === 11 && in_array($digits[0], ['7', '8'], true)) {
        return '+7' . substr($digits, 1);
    }
    if (strlen($digits) === 10) {
        return '+7' . $digits;
    }
    return null;
}

$request = Application::getInstance()->getContext()->getRequest();
$phone = normalizePhone((string)$request->getPost('PHONE'));

if ($phone === null) {
    // вернуть в форму ошибку и заявку не создавать
}

Куда именно вставлять эту проверку, зависит от того, как устроена форма. В собственном AJAX-обработчике это начало метода, до записи в базу и отправки в CRM. Для готовых компонентов есть события модулей, в которых можно остановить создание заявки, но их сигнатуры отличаются между модулями, поэтому я каждый раз сверяюсь с документацией конкретного модуля, а не пишу по памяти.

Единый формат окупается в трёх местах. В CRM дубли ищутся по точному совпадению, и «8999…» с «+7999…» без нормализации считаются разными людьми. Службам доставки вроде СДЭК и SMS-шлюзам номер удобнее отдавать одинаковым, а не разбирать по десяти шаблонам. И менеджеру проще набрать номер, когда он записан одним способом. По моей практике именно ручная правка номеров в CRM съедала у клиентов больше времени, чем сама разработка маски.

Для иностранных номеров функция выше не подходит: она принимает только российский формат. Когда нужны другие страны, в главном модуле Битрикса есть разбор номеров в пространстве имён Bitrix\Main\PhoneNumber, и я использую его вместо самописных регулярок. Сигнатуры классов перед использованием сверяйте с документацией вашей версии ядра. На клиенте в этом случае маску заменяет intl-tel-input или свободный ввод с мягкой проверкой длины.

Ошибки ввода номера, которые ломают форму на практике

Большинство жалоб на «не работает форма» сводится к небольшому набору повторяющихся причин.

Симптом Причина Что делаю
Номер не стирается до конца Маска дописывает скобки и дефисы на каждое нажатие Добавляю разделители только перед следующей цифрой
Маска пропала в попапе или после отправки Обработчик вешался на поля при загрузке страницы, а форма подгрузилась позже Слушатель на document, а не на конкретные input
После автозаполнения номер выглядит криво Браузер подставил «89991234567» или значение с пробелами Форматтер собирает значение из цифр заново при любом вводе
Форма не принимает номер из Казахстана или Беларуси Жёсткая маска +7 отсекает коды других стран Если такие клиенты есть, ставлю выбор страны или свободный ввод
В CRM дубли одного контакта Номера пишутся в разных форматах и сравниваются как строки Нормализую на сервере перед записью
На телефоне открывается буквенная клавиатура У поля тип text вместо tel Ставлю type=“tel” и inputmode=“tel”

Отдельно про код страны. Жёсткая маска +7 подходит магазину, который доставляет по России, и мешает, если часть клиентов пишет с зарубежных номеров. Такие клиенты либо бросают форму, либо вбивают вымышленный российский номер, чтобы пройти проверку. Прежде чем ставить жёсткий формат, я смотрю, откуда реально приходят заявки, и решаю по этим данным.

Про сообщения об ошибках. Фраза «Неверный формат» ничего не объясняет. Рядом с полем лучше показывать пример «+7 (999) 123-45-67», а сообщение при отправке делать конкретным: «Не хватает двух цифр». Проверить это можно быстро: попросите человека, который не видел форму, заполнить её на телефоне и посмотрите, на каком поле он остановится.

Отладку удобно начинать в консоли браузера: выполните formatPhone(‘89991234567’) из скрипта, если вынесете функцию в глобальную область, и убедитесь, что результат совпадает с ожидаемым. Потом проверьте вставку из буфера с пробелами и скобками, ввод с цифровой клавиатуры телефона и автозаполнение. Если все три случая дают один результат, серверу приходит предсказуемая строка.

Условия и возможности 1С-Битрикс меняются, поэтому перед внедрением я сверяюсь с актуальной документацией продукта.

Частые вопросы

Нужна ли библиотека, чтобы сделать маску телефона в Битрикс?

Для одного российского формата библиотека не нужна: хватает короткого скрипта на десяток строк с делегированием событий. Библиотеки вроде Inputmask или IMask нужны, когда требуется несколько разных масок, выбор страны или аккуратная работа с курсором при правке в середине номера.

Почему маска не работает в форме во всплывающем окне?

Скрипт, скорее всего, навешивался на поля при загрузке страницы, а форма в попапе появилась позже или была перерисована после AJAX-запроса. Повесьте слушатель события input на document и проверяйте e.target через matches. Тогда маска работает для любого поля, которое появилось на странице в любой момент.

Достаточно ли маски в браузере, если у меня обычная форма заявки?

Нет. Маску и атрибут pattern обходят простой отправкой POST-запроса без браузера, а автозаполнение и расширения тоже иногда отдают номер в другом виде. Номер нужно приводить к единому формату и проверять длину на сервере до записи заявки и отправки в CRM.

Как принимать иностранные номера, если на сайте маска +7?

Жёсткую маску +7 нужно заменить. Есть два рабочих пути: поле с выбором страны на основе intl-tel-input или свободный ввод с проверкой только длины и допустимых символов. На сервере номер разбирают с учётом страны, для этого в ядре Битрикса есть классы в пространстве имён Bitrix\Main\PhoneNumber, их сигнатуры сверяют с документацией вашей версии.

Есть задача?

Обсудим вашу задачу

Оставьте заявку — обсудим объём работ и следующий шаг.

Продолжая пользование настоящим сайтом Вы выражаете своё согласие на обработку Ваших персональных данных (файлов куки) с использованием Yandex.Metrika.
Понятно