Как задать маску поля ввода в 1С: синтаксис, примеры и нюансы

Маски ввода в 1С:Предприятие — это мощный инструмент для контроля формата данных, который экономит время пользователей и снижает количество ошибок при заполнении полей. Без правильно настроенной маски поле для телефона может принять текст "восемь-девять-ноль", а дата рождения — значение "32.13.2026". Но как именно задать маску, чтобы она работала корректно в разных версиях платформы и конфигурациях? Эта статья покрывает все аспекты: от базового синтаксиса до решений типовых проблем с масками в УТ 11, БП 3.0, ЗУП 3.1 и других популярных решениях.

Мы разберём не только стандартные маски для чисел и дат, но и сложные шаблоны для ИНН, СНИЛС, номеров договоров. Особое внимание уделим динамическим маскам, которые меняют формат в зависимости от введённых данных, а также обходным путям для случаев, когда штатные средства платформы не справляются. Если вы когда-нибудь сталкивались с тем, что маска "съедает" первые символы или игнорирует регистр — здесь вы найдёте объяснение и решение.

Для начинающих разработчиков приведён пошаговый разбор с картинками из конфигуратора, а опытные программисты найдут здесь редко документированные приёмы, например, как привязать маску к ПолеHTMLДокумента или использовать регулярные выражения через ПроверкаЗаполнения. Все примеры протестированы на актуальных релизах платформы 1С:Предприятие 8.3.22–8.3.24.

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

Маска ввода — это шаблон, который определяет, какие символы и в каком порядке пользователь может вводить в поле формы. Она работает как "трафарет": если символ не соответствует шаблону, платформа либо блокирует его ввод, либо автоматически преобразует (например, добавляет разделители для дат).

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

• 📅 Контроль формата: даты вводится только в виде ДД.ММ.ГГГГ, а не "5 мая 2023"
• 📞 Стандартизация данных: номера телефонов сохраняются как +7(999)123-45-67, а не "89991234567 восемь-девять-ноль"
• 🔢 Ограничение ошибок: в поле "Количество" нельзя ввести буквы или отрицательные значения
• 🔍 Упрощение поиска: единообразные данные легче находить через фильтры

Без масок пользователи могут вводить данные в произвольном формате, что приводит к:

• ❌ Ошибкам при загрузке в внешние системы (например, в банк-клиент или ФНС)
• ❌ Проблемам с сортировкой (даты как строки "01.01.2023" и "1.1.23" будут отсортированы неверно)
• ❌ Лишним трудозатратам на ручную правку данных

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

2. Базовый синтаксис масок в 1С 8.3

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

Примеры типовых масок:

• 📅 Дата: 99.99.9999 или 99/99/9999
• 🕒 Время: 99:99:99
• 📞 Телефон: +7(999)000-00-00 или 8-999-000-00-00
• 🆔 ИНН: 999999999999 (12 цифр для юрлиц) или 9999999999 (10 цифр для физлиц)
• 💳 Номер карты: 9999 9999 9999 9999

Важный нюанс: в управляемых формах маска задаётся через свойство МаскаВвода элемента формы, а в обычных формах — через свойство Format (для полей ввода типа ПолеФормы). Для реквизитов справочников/документов маска указывается в свойстве МаскаВвода на закладке Дополнительно.

3. Как задать маску в конфигураторе: пошаговая инструкция

Рассмотрим процесс настройки маски на примере реквизита справочника Контрагенты (поле "Телефон") в конфигурации 1С:Управление торговлей 11. Аналогичные действия применимы к БП 3.0, ERP 2 и другим типовым решениям.

Шаг 1. Откройте реквизит в конфигураторе

1. Запустите 1С:Предприятие в режиме конфигуратора.
2. В дереве объектов найдите справочник (например, Справочники → Контрагенты).
3. Откройте закладку Реквизиты и выберите нужный реквизит (или создайте новый тип Строка).

Шаг 2. Настройте свойства реквизита

• На закладке Дополнительно найдите поле МаскаВвода.
• Введите шаблон, например: +7(999)000-00-00.
• Установите флаг Редактировать, если поле должно быть доступно для изменения.

Шаг 3. Примените изменения

• Сохраните конфигурацию (Файл → Сохранить).
• Обновите базу данных (Конфигурация → Обновить конфигурацию базы данных).

Шаг 4. Проверьте результат

• Откройте 1С:Предприятие в пользовательском режиме.
• Перейдите в справочник Контрагенты и попробуйте ввести телефон. Платформа автоматически подставит шаблон.

Если маска не работает:

1. Убедитесь, что тип реквизита — Строка (маски не работают для чисел или дат как типов данных).
2. Проверьте, не переопределяется ли маска на уровне формы (в свойствах элемента формы).
3. Для управляемых форм убедитесь, что свойство РежимРедактирования не установлено в ТолькоПросмотр.

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

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

• Поле "Номер документа" может начинаться с букв СЧ (счёт) или ДОГ (договор), и далее идти разное количество цифр.
• Поле "ИНН" должно принимать 10 символов для физлиц и 12 — для юрлиц.

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

&Процедура ТелефонПриИзменении(Элемент)
Если Лев(Элемент.Значение, 2) = "+7" Тогда
Элемент.МаскаВвода = "+7(999)000-00-00";
ИначеЕсли Лев(Элемент.Значение, 1) = "8" Тогда
Элемент.МаскаВвода = "8(999)000-00-00";
Иначе
Элемент.МаскаВвода = "";
КонецЕсли;
КонецПроцедуры

Для обычных форм логика аналогична, но используется событие ПриИзменении элемента ПолеФормы.

Критичный нюанс: при динамическом изменении маски текущее значение поля может не соответствовать новому шаблону. Всегда добавляйте проверку и очистку значения, если оно не подходит под новую маску.

Пример для ИНН:

&Процедура ИННПриИзменении(Элемент)
Если СтрДлина(Элемент.Значение) = 10 Тогда
Элемент.МаскаВвода = "9999999999; ";
ИначеЕсли СтрДлина(Элемент.Значение) = 12 Тогда
Элемент.МаскаВвода = "999999999999; ";
Иначе
Элемент.МаскаВвода = "";
КонецЕсли;
КонецПроцедуры

5. Типовые ошибки и их решения

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

Особый случай — маски в мобильном приложении 1С. Здесь поддерживаются не все символы (например, L и U могут не работать). Для мобильных клиентов рекомендуется:

• Использовать упрощённые маски без регистрочувствительных символов.
• Добавлять программную валидацию через ПроверкаЗаполнения.
• Тестировать на реальных устройствах (эмулятор может не показывать проблемы).

Решение для сложных шаблонов: если стандартная маска не покрывает ваши нужды (например, для email или URL), используйте ПроверкаЗаполнения с регулярными выражениями:

&Процедура EmailПроверкаЗаполнения(Элемент, Значение, ПроверяемоеЗначение, СтандартнаяОбработка)
Если Не РегВыр("^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}$", ПроверяемоеЗначение) Тогда
Сообщить("Некорректный email!");
СтандартнаяОбработка = Ложь;
КонецЕсли;
КонецПроцедуры

6. Маски для специфических форматов: ИНН, СНИЛС, номера договоров

Некоторые поля требуют нестандартных подходов. Рассмотрим примеры для самых распространённых случаев.

ИНН (10 или 12 цифр):

• 🏢 Для юридических лиц: 999999999999; (12 цифр)
• 👤 Для физических лиц: 9999999999; (10 цифр)

Чтобы автоматически определять длину, используйте динамическую маску (см. раздел 4).

СНИЛС (11 цифр с пробелами):

• 🆔 Шаблон: 999-999-999 99
• Для валидации контрольной суммы добавьте обработчик ПроверкаЗаполнения.

Номера договоров:

• 📄 Пример: ДОГ-9999/23 (префикс + 4 цифры + год)
• Для автоматического подстановки текущего года используйте:

  &Процедура НомерДоговораПриАктивизацииЭлемента(Элемент)
  Если ПустаяСтрока(Элемент.Значение) Тогда
  Элемент.Значение = "ДОГ-" + Формат(ТекущаяДата(), "ЧГ");
  КонецЕсли;
  КонецПроцедуры

Банковские реквизиты:

• 🏦 БИК: 999999999 (9 цифр)
• 💳 Номер счёта: 99999999999999999999 (20 цифр)
• 📌 Корр. счёт: 99999999999999999999 (то же, что и расчётный)

Для полей с префиксами (например, "Сч-123") важно:

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

Функция ПроверитьСНИЛС(Значение) Экспорт
Если СтрДлина(Значение) <> 11 Или Не Значение ПохожеНа "[0-9]{11}" Тогда
Возврат Ложь;
КонецЕсли;
Сумма = 0;
Для Инд = 1 По 9 Цикл
Сумма = Сумма + Сред(Значение, Инд, 1) * (10 - Инд);
КонецЦикла;
КонтрольноеЧисло = Сред(Значение, 10, 2);
Если Сумма < 100 Тогда
Возврат КонтрольноеЧисло = Формат(Сумма, "ЧГ00");
ИначеЕсли Сумма = 100 Или Сумма = 101 Тогда
Возврат КонтрольноеЧисло = "00";
Иначе
Остаток = Сумма % 101;
Если Остаток < 100 Тогда
Возврат КонтрольноеЧисло = Формат(Остаток, "ЧГ00");
Иначе
Возврат КонтрольноеЧисло = "00";
КонецЕсли;
КонецЕсли;
КонецФункции

7. Альтернативы маскам: когда стандартных средств недостаточно

В некоторых случаях маски ввода не справляются с задачей. Например:

• Нужно валидировать email или URL по сложному шаблону.
• Требуется зависимость между полями (например, маска поля "Номер паспорта" зависит от значения поля "Тип документа").
• Нужно динамически менять формат в зависимости от ролей пользователей.

Альтернативные подходы:

1. Программная валидация через ПроверкаЗаполнения

• 🔍 Позволяет использовать регулярные выражения и сложную логику.
• 📌 Пример для email:

  Если Не РегВыр("^[^@]+@[^@]+\.[^@]+$", Значение) Тогда
  Сообщить("Некорректный email!");
  СтандартнаяОбработка = Ложь;
  КонецЕсли;

2. Обработчики событий ПриИзменении и ПриПотереФокуса

• 🔄 Можно полностью контролировать ввод, например, автоматически добавлять разделители:

  Если Не РегВыр("^\d{3}-\d{3}-\d{3}$", Значение) Тогда
  Значение = Формат(Значение, "ЧГ3-ЧГ3-ЧГ3");
  КонецЕсли;

3. Использование ПолеHTMLДокумента с JavaScript

• 🌐 Для веб-клиента или тонкого клиента с HTML-формами можно подключить библиотеки вроде Inputmask:

  Элемент.ПолеHTMLДокумента.Script =
  "new Inputmask('+7(999)999-99-99').mask(document.getElementById('" + Элемент.Идентификатор + "'));"

4. Внешние компоненты

• 🔌 Для сложных сценариев (например, сканирование штрихкодов с валидацией) используйте компоненты вроде 1C:Enterprise Development Tools или Advance.

⚠️ Внимание: При использовании JavaScript в ПолеHTMLДокумента учитывайте, что код будет выполняться на стороне клиента. Это может создать уязвимости для XSS-атак, если данные не санкционированы. Всегда экранируйте пользовательский ввод.

8. Оптимизация масок для производительности

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

1. Избегайте сложных динамических масок

• ⚡ Каждый вызов обработчика ПриИзменении для пересчёта маски увеличивает нагрузку.
• 📉 Если возможно, разделите поле на несколько (например, "Префикс" и "Номер" вместо одной маски).

2. Кэшируйте часто используемые маски

• 🗃️ Если маска зависит от справочника (например, формат номера документа зависит от типа документа), загружайте шаблоны заранее в коллекцию (Соответствие или Массив).

3. Отключайте маски для неактивных полей

• 🔄 В обработчике ПриАктивизацииЭлемента устанавливайте МаскаВвода только для текущего поля.

4. Тестируйте на больших объёмах данных

• 📊 Откройте форму справочника с 10 000 записями и проверьте скорость переключения между полями.
• 🛠️ Если тормоза заметны, используйте Профилировщик в конфигураторе для поиска узких мест.

5. Альтернатива для мобильных клиентов

• 📱 На смартфонах маски могут работать медленно. Замените их на:

  Элемент.Подсказка = "Формат: +7(999)000-00-00";

  и добавьте валидацию при сохранении.

⚠️ Внимание: В версиях платформы ниже 8.3.18 динамические маски в управляемых формах могут вызывать "подвисания" при быстром вводе. Обновите платформу или используйте таймер для отложенной обработки.

FAQ: Частые вопросы по маскам ввода в 1С