Маска телефона Битрикс держится на трёх слоях: подсказка формата в самом поле, проверка в браузере и нормализация номера на сервере. Обычно ставят только первый слой, а потом в 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, их сигнатуры сверяют с документацией вашей версии.