Как свернуть комментарий в 1С: инструкция для конфигуратора и документов

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

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

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

Редактор кода конфигуратора поддерживает группировку строк: любой связный фрагмент текста, в том числе блок комментариев, можно объединить в группу и свернуть в одну строку. Слева от текста, на полях редактора, появляется значок «минус», при нажатии на который фрагмент скрывается, остаётся только первая строка.

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

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

Как свернуть блок комментариев через группировку строк

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

1. 1
   Откройте модуль в конфигураторе и найдите нужный блок комментариев
2. 2
   Выделите строки комментария мышью или клавишами Shift+стрелки
3. 3
   Нажмите Ctrl+Shift+G либо выберите пункт меню «Текст — Группировать» (в ряде версий — «Блок — Группировать»)
4. 4
   На полях слева появится маркер группы — нажмите «минус», чтобы свернуть блок
5. 5
   Проверьте: блок сжался до одной строки, разворачивается кликом по «плюсу»

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

Чтобы убрать группировку, выделите сгруппированный фрагмент и выполните обратную команду «Разгруппировать» (Ctrl+Shift+U в типовых настройках). Сам текст при этом не удаляется.

Сворачивание через область #Область

Более надёжный и «правильный» способ для больших комментариев — заключить их в именованную область. Директивы #Область и #КонецОбласти создают постоянный сворачиваемый блок, который сохраняется в тексте модуля и виден всем разработчикам.

#Область ОписаниеАлгоритма
// Здесь размещается длинный комментарий:
// назначение модуля, ограничения,
// особенности расчёта и ссылки на задачи.
#КонецОбласти

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

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

Настройки редактора, влияющие на сворачивание

За отображение маркеров группировки отвечают настройки редактора модулей. Откройте «Сервис — Параметры» (в новых версиях — через главное меню конфигуратора), раздел «Модули» или «Редактор текста» в зависимости от версии платформы.

Если значки «плюс/минус» на полях не отображаются, проверьте включение опции группировки и отображения полей редактора. Также на удобство влияет настройка автоматической группировки синтаксических конструкций — при включённой опции процедуры и функции сворачиваются без ручных действий.

Полезная команда — «Свернуть все группы» и «Развернуть все группы» в меню текста. Она позволяет одним действием сжать весь модуль до структуры методов, что удобно при первом знакомстве с чужим кодом.

Как свернуть длинный комментарий в документе в режиме предприятия

В пользовательском режиме ситуация иная: поле «Комментарий» документа или справочника — это обычный реквизит, и «свернуть» его штатной кнопкой нельзя. Но есть рабочие приёмы.

• Уменьшите высоту многострочного поля на форме: в конфигураторе у элемента формы задайте фиксированную высоту в 1–2 строки — остальной текст будет доступен прокруткой.
• Вынесите комментарий на отдельную вкладку или в группу с признаком «сворачиваемая»: у группы формы есть свойство «Отображение» и поведение сворачивания по заголовку.
• Используйте расширенную подсказку: краткий текст выводится в поле, а развёрнутое пояснение — во всплывающей подсказке.
• Храните объёмные пояснения в присоединённых файлах или в отдельном регистре сведений, оставляя в комментарии только суть.

Частые ошибки и ограничения

Ещё одно ограничение: сворачивание не ускоряет выполнение кода. Комментарии и так не компилируются в исполняемые инструкции, поэтому сворачивание — чисто эргономическая мера, а не оптимизация.

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

FAQ