Маска ввода в 1С: пошаговая инструкция для программистов

Маски ввода в 1С:Предприятие 8.3 — это мощный инструмент для контроля корректности данных, которые пользователи вводят в формы. Они позволяют автоматически форматировать текст, ограничивать символы и упрощать работу с полями, где требуется строгий формат (номера телефонов, ИНН, даты, серийные номера и т.д.). Без правильно настроенной маски пользователи могут вводить данные в произвольном виде, что приводит к ошибкам в отчетах, обменах данными и бизнес-процессах.

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

Что такое маска ввода и зачем она нужна

Маска ввода — это набор правил, который определяет, какие символы и в каком порядке пользователь может вводить в поле формы. Она работает как шаблон, автоматически добавляющий разделители (дефисы, скобки, точки) и ограничивающий ввод только допустимыми символами. Например, маска для номера телефона может выглядеть как +7 (###) ###-##-##, где # обозначает цифру.

Основные задачи масок ввода в 1С:

📌 Стандартизация данных: все номера телефонов или ИНН будут вводиться в одном формате, что упрощает их обработку.
🔍 Уменьшение ошибок: пользователь не сможет ввести буквы в поле для цифр или пропустить обязательные символы.
⚡ Ускорение ввода: маска автоматически добавляет разделители (например, дефисы в номере паспорта), пользователю не нужно их вводить вручную.
🛡️ Защита от некорректных данных: например, маска для email проверяет наличие символа @.

Без масок ввода данные в базе могут выглядеть так: 89123456789, +7 (912) 345-67-89, 9123456789 — и это один и тот же номер телефона! Маска решает эту проблему, приводя все записи к единому виду.

Типы масок ввода в 1С: от простых до сложных

В 1С:Предприятие 8.3 маски ввода можно реализовать несколькими способами, в зависимости от требуемой функциональности. Рассмотрим основные подходы:

Тип маски	Пример использования	Плюсы	Минусы
Простая маска (шаблон)	Номер телефона: `+7 (###) ###-##-##`	Легко настраивается, не требует программирования	Ограниченная функциональность, не проверяет корректность данных
Регулярные выражения	ИНН: `^\d{10}$\|^\d{12}$`	Максимальная гибкость, проверка сложных форматов	Сложно поддерживать, требует знаний regex
Динамические маски (через события)	Автоматическое добавление дефисов в серийный номер	Можно изменять маску "на лету" в зависимости от ввода	Требует написания кода на встроенном языке
Внешние компоненты	Интеграция с библиотеками вроде InputMask	Расширенные возможности (например, маски для кредитных карт)	Зависимость от сторонних решений, возможны проблемы с обновлениями

Для большинства задач в 1С достаточно простых масок или регулярных выражений. Внешние компоненты целесообразно использовать только в случаях, когда стандартные средства не покрывают требования (например, для масок с поддержкой разных локалей или сложной логики валидации).

⚠️ Внимание: Если вы используете регулярные выражения для проверки ИНН или СНИЛС, учитывайте, что их формат может меняться со временем (например, с введением новых правил налоговой службы). Всегда сверяйте актуальные требования к форматам на официальных ресурсах.

Как создать простую маску ввода в управляемой форме

Рассмотрим пошаговую инструкцию по добавлению маски ввода для поля в управляемой форме. В этом примере мы создадим маску для номера телефона в формате +7 (XXX) XXX-XX-XX.

1. Откройте конфигуратор 1С:Предприятия 8.3 и перейдите в нужную управляемую форму.

2. Добавьте на форму поле ввода (элемент ПолеВвода) или выберите существующее.

3. В свойствах поля найдите параметр МаскаВвода и установите его значение:

+7 (000) 000-00-00

Здесь 0 обозначает обязательную цифру, а остальные символы (+, (, ), -) будут автоматически добавляться при вводе.

4. Чтобы маска работала корректно, также установите свойство РежимВводаТекста в значение РежимВводаТекста.ТолькоЧисло (если маска только для цифр).

Убедитесь, что поле принимает только цифры

Проверьте автоматическое добавление скобок и дефисов

Попробуйте ввести меньше/больше символов, чем требует маска

Сохраните форму и протестируйте в пользовательском режиме-->

Если маска не применяется, проверьте:

🔹 Правильно ли указан синтаксис (например, # вместо 0 для необязательных цифр).
🔹 Не конфликтует ли маска с другими обработчиками событий (например, ПриИзменении).
🔹 Установлено ли свойство МаскаВводаИспользовать в значение Истина.

💡

Если вам нужно, чтобы маска работала только при фокусе на поле, добавьте обработчик события ПриПолученииФокуса и программно устанавливайте маску там. Это полезно для полей, которые используются и для других целей.

Регулярные выражения для сложных масок

Когда простых масок недостаточно (например, для проверки email или ИНН), на помощь приходят регулярные выражения. Они позволяют задавать сложные правила валидации. В 1С регулярные выражения поддерживаются через объект РегулярноеВыражение.

Пример кода для проверки корректности ИНН (10 или 12 цифр):

Процедура ПроверитьИНН(Значение) Экспорт
РегВыражение = Новый РегулярноеВыражение("^\d{10}$|^\d{12}$");
Если НЕ РегВыражение.Проверка(Значение) Тогда
Сообщить("Некорректный формат ИНН! Допустимы только 10 или 12 цифр.");
Возврат Ложь;
КонецЕсли;
Возврат Истина;
КонецПроцедуры

Другие полезные регулярные выражения для 1С:

📧 Email: ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$
📅 Дата в формате ДД.ММ.ГГГГ: ^(0[1-9]|[12][0-9]|3[01])\.(0[1-9]|1[012])\.\d{4}$
🆔 СНИЛС: ^\d{3}-\d{3}-\d{3} \d{2}$
💳 Номер банковской карты (16 цифр): ^\d{4} \d{4} \d{4} \d{4}$

⚠️ Внимание: Регулярные выражения могут существенно замедлить работу формы, если их использовать для проверки каждого символа при вводе. Оптимально применять их при потере фокуса (ПриПотереФокуса) или перед сохранением данных.

Как тестировать регулярные выражения без 1С?

Вы можете использовать онлайн-сервисы вроде regex101.com или regexr.com, чтобы проверить корректность выражения перед внедрением в конфигурацию. Это сэкономит время на отладку в 1С.

Динамические маски: изменение формата "на лету"

Иногда маска ввода должна меняться в зависимости от первых введённых символов. Например, если пользователь начинает вводить номер телефона с +7, маска должна подстроиться под российский формат, а если с +375 — под белорусский. Для этого нужно использовать события ПриИзменении.

Пример динамической маски для международных телефонов:

Процедура ПолеВводаТелефонПриИзменении(Элемент)
ТекущийТекст = Элемент.Значение;

Если Лев(ТекущийТекст, 2) = "+7" Тогда
Элемент.МаскаВвода = "+7 (000) 000-00-00";
ИначеЕсли Лев(ТекущийТекст, 4) = "+375" Тогда
Элемент.МаскаВвода = "+375 (00) 000-00-00";
Иначе
Элемент.МаскаВвода = "";
КонецЕсли;
КонецПроцедуры

Другие сценарии для динамических масок:

🔢 Серийные номера: маска меняется в зависимости от префикса (например, AB- или XY-).
📊 Коды номенклатуры: первые символы определяют категорию товара, а маска — оставшуюся часть кода.
📅 Даты: автоматическое переключение между форматами ДД.ММ.ГГГГ и ММ/ГГГГ.

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

Типичные ошибки и как их избежать

Даже опытные разработчики 1С сталкиваются с проблемами при работе с масками ввода. Вот наиболее распространённые ошибки и способы их решения:

Ошибка	Причина	Решение
Маска не применяется к полю	Не установлено свойство `МаскаВводаИспользовать = Истина`	Проверьте свойства элемента формы в конфигураторе
Маска "съедает" первые символы	Конфликт с обработчиком `ПриИзменении`, который очищает поле	Отладьте обработчик или используйте событие `ПриВводеЗначения`
Пользователь может ввести запрещённые символы	Маска задана только для отображения, без валидации	Добавьте проверку через регулярное выражение в `ПриПотереФокуса`
Маска работает только в конфигураторе, но не в пользовательском режиме	Не обновлена конфигурация базы данных	Выполните `Обновить конфигурацию базы данных`

Ещё одна частая проблема — производительность. Если маска слишком сложная (например, с вложенными регулярными выражениями), форма может начинать "тормозить" при вводе. В таких случаях:

🔹 Перенесите валидацию на событие ПриПотереФокуса вместо ПриИзменении.
🔹 Используйте упрощённые маски для отображения и полную проверку только при сохранении.
🔹 Кэшируйте объекты РегулярноеВыражение, если они используются многократно.

💡

Всегда тестируйте маски ввода на реальных данных пользователей. То, что работает для тестовых значений, может давать сбои на практике (например, из-за неожиданных символов или длинных строк).

Продвинутые техники: интеграция с внешними библиотеками

Если стандартных средств 1С недостаточно, можно подключить внешние библиотеки для работы с масками. Например, популярная JavaScript-библиотека Inputmask позволяет создавать маски любой сложности, включая:

📅 Даты с календарём.
💳 Номера банковских карт с валидацией по алгоритму Луна.
🌍 Телефонные номера с автоматической подстановкой кода страны.
🔢 Динамические маски, которые изменяются в зависимости от ввода.

Для интеграции Inputmask в 1С потребуется:

Подключить библиотеку через HTMLДокумент в управляемой форме.
Написать обработчик, который будет применять маску к полю ввода.
Обеспечить обмен данными между 1С и JavaScript.

Пример кода для подключения Inputmask:

Процедура ПриСозданииНаКлиенте(Отказ)
HTML = "
            ";
ЭлементыФормы.HTMLДокумент.УстановитьТекст(HTML);
КонецПроцедуры

⚠️ Внимание: Использование внешних библиотек увеличивает зависимость от интернет-соединения (если скрипты подгружаются с CDN) и может создать проблемы с безопасностью. Всегда тестируйте такие решения в изолированной среде перед внедрением в рабочую базу.

FAQ: Ответы на частые вопросы о масках ввода в 1С

Как сделать маску для ввода даты в формате ДД.ММ.ГГГГ?

Используйте следующую маску в свойстве МаскаВвода:

00.00.0000

Дополнительно можно добавить валидацию через регулярное выражение, чтобы проверять корректность даты (например, что месяц не больше 12, а день соответствует месяцу).

Почему маска ввода не работает в тонком клиенте?

Убедитесь, что:

Свойство МаскаВводаИспользовать установлено в Истина.
Вы обновили конфигурацию базы данных после изменения формы.
Нет конфликтов с обработчиками событий (например, ПриИзменении не сбрасывает маску).

Если проблема остаётся, попробуйте использовать ПолеВвода.УстановитьМаскуВвода() в обработчике ПриОткрытии.

Можно ли сделать маску для ввода только заглавных букв?

Маска ввода сама по себе не управляет регистром символов. Однако вы можете:

Использовать событие ПриИзменении, чтобы автоматически преобразовывать текст в верхний регистр:

Процедура ПолеВводаПриИзменении(Элемент)
Элемент.Значение = ВРег(Элемент.Значение);
КонецПроцедуры

Либо настроить свойство РежимВводаТекста в РежимВводаТекста.ЗаглавныеБуквы (если нужно только буквы).

Как запретить ввод пробелов в поле с маской?

Добавьте обработчик ПриВводеЗначения и удаляйте пробелы:

Процедура ПолеВводаПриВводеЗначения(Элемент, СтандартнаяОбработка)
Если НЕ ПустаяСтрока(Элемент.Значение) Тогда
Элемент.Значение = СтрЗаменить(Элемент.Значение, " ", "");
КонецЕсли;
КонецПроцедуры

Alternatively, используйте регулярное выражение для валидации, которое исключает пробелы: ^\S+$.

Где хранить шаблоны масок, чтобы их можно было легко изменять?

Лучшие практики:

📁 Константы: создайте константы для часто используемых масок (например, МаскаТелефона, МаскаИНН).
📄 Общий модуль: вынесите функции создания масок в отдельный модуль с экспортными процедурами.
🗃️ Справочник "ШаблоныМасок": храните шаблоны в справочнике с возможностью редактирования без изменения конфигурации.

Пример структуры общего модуля:

Функция ПолучитьМаскуТелефона() Экспорт
Возврат "+7 (000) 000-00-00";
КонецФункции

Функция ПолучитьМаскуИНН() Экспорт
Возврат "000000000000"; // 10 или 12 цифр
КонецФункции

Маска ввода в 1С: как настроить и использовать правильно