Сворачивание процедур, областей и блоков в модулях 1С 8.3

Чтобы свернуть код в 1С, поставьте курсор внутрь процедуры и нажмите Ctrl + Num- (минус на цифровой клавиатуре). Свернуть сразу весь модуль до заголовков процедур — Ctrl + Shift + Num-, развернуть всё обратно — Ctrl + Shift + Num+. То же самое делается мышью: щелчок по значку «минус» на левом поле редактора рядом со строкой Процедура или #Область.

Сворачивание работает в редакторе модулей Конфигуратора 1С:Предприятие 8.3 и в 1С:EDT. Оно ничего не меняет в тексте и не влияет на работу программы: это только вид. Свёрнутый блок показывается одной строкой с заголовком, остальное скрыто до разворачивания.

Горячие клавиши для сворачивания и разворачивания кода

Основные сочетания в Конфигураторе удобно держать перед глазами. Все они используют клавиши + и − на цифровом блоке клавиатуры, а не в верхнем ряду.

Как это выглядит на практике:

1. Откройте модуль, например модуль формы документа.
2. Нажмите Ctrl + Shift + Num-. Модуль на 3 000 строк превращается в список из пары десятков областей или процедур.
3. Найдите глазами нужную процедуру и поставьте на неё курсор.
4. Нажмите Ctrl + Num+ — откроется только она, остальные блоки останутся свёрнутыми.

Если на клавиатуре нет цифрового блока

На ноутбуках клавиш Num- и Num+ часто нет. Варианты:

• 🖱️ работать мышью через значки на поле редактора — этого хватает в 90% случаев;
• ⌨️ включить встроенный цифровой блок ноутбука (обычно через Fn и отдельную клавишу, зависит от модели);
• 🔧 переназначить команды на удобные клавиши. В свежих версиях платформы 8.3 в Конфигураторе есть Сервис → Настройка клавиатуры: найдите в списке команды сворачивания по слову «Свернуть» и задайте своё сочетание;
• 🧩 подключить внешнюю клавиатуру с цифровым блоком, если сворачиваете постоянно.

Сворачивание мышью: поле редактора и меню

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

• ➖ Щелчок по «минусу» сворачивает блок. Значок меняется на «плюс».
• ➕ Щелчок по «плюсу» разворачивает блок обратно.
• 📏 От «минуса» вниз тянется вертикальная линия до конца блока. По ней видно, где процедура или область заканчивается, даже если она не помещается на экран.

Свёрнутый блок выглядит как одна строка заголовка с отметкой о скрытом содержимом. Код внутри никуда не делся: поиск по модулю (Ctrl + F), синтаксический контроль и сохранение работают с полным текстом.

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

Области #Область: свои сворачиваемые блоки

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

#Область ОбработчикиСобытийФормы

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
	// ...
КонецПроцедуры

&НаКлиенте
Процедура ПриОткрытии(Отказ)
	// ...
КонецПроцедуры

#КонецОбласти

На поле редактора напротив строки #Область появится свой «минус». Свернули — и обе процедуры спрятаны под одной строкой #Область ОбработчикиСобытийФормы.

Правила для областей

1. Имя области пишется одним словом, без пробелов, по правилам идентификатора: буквы, цифры и подчёркивание, начинается не с цифры.
2. Каждая #Область закрывается своей #КонецОбласти. Незакрытая область — синтаксическая ошибка, модуль не пройдёт проверку.
3. Области можно вкладывать друг в друга. Сворачиваются они по уровням, как матрёшка.
4. Удобнее всего, когда граница области не разрывает процедуру: процедура целиком лежит внутри одной области.

Какие имена областей приняты

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

После Ctrl + Shift + Num- такой модуль читается как оглавление: три-четыре строки, и сразу понятно, где искать нужное.

Мини-кейс: разметить старый модуль областями

Допустим, достался модуль формы на 1 500 строк без единой области. Порядок работы:

1. Сохраните конфигурацию или сделайте копию модуля во внешний файл, чтобы было с чем сравнить.
2. Нажмите Ctrl + Shift + Num- — видны только заголовки процедур.
3. Перетащите или вырежьте процедуры так, чтобы обработчики формы, обработчики команд и служебные процедуры шли тремя группами.
4. Вставьте строки #Область … и #КонецОбласти на границах групп.
5. Проверьте синтаксис модуля и сверните всё ещё раз: вместо 60 строк заголовков останется 3.

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

Директивы компиляции и строки препроцессора

В модулях форм перед каждой процедурой стоит директива: &НаКлиенте, &НаСервере, &НаСервереБезКонтекста. Директива находится на отдельной строке над словом Процедура, поэтому при сворачивании процедуры она остаётся видимой. Это удобно: даже в свёрнутом виде видно, где выполняется код.

В модулях объектов и менеджеров часто весь код обёрнут в условие препроцессора #Если Сервер Или ТолстыйКлиентОбычноеПриложение Или ВнешнееСоединение Тогда … #КонецЕсли. Внутри такой обёртки процедуры и области сворачиваются как обычно.

Настройки группировки в Конфигураторе

Какие конструкции сворачиваются, задаётся в параметрах Конфигуратора:

1. Откройте Сервис → Параметры.
2. Перейдите на вкладку Модули.
3. Откройте закладку с настройками группировки.
4. Отметьте конструкции, которые нужно группировать.

Помимо процедур, функций и областей, платформа 8.3 умеет группировать управляющие конструкции: условия Если … КонецЕсли, циклы Для/Пока … КонецЦикла, блоки Попытка … КонецПопытки. Набор пунктов в окне зависит от версии платформы.

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

Как сворачивание ведёт себя при навигации по модулю

Свёрнутые блоки не мешают переходам по коду. Редактор сам разворачивает нужное место, когда вы туда прыгаете.

• 🔍 Поиск Ctrl + F находит текст и внутри свёрнутых блоков. Блок с найденным совпадением разворачивается, чтобы показать строку.
• ➡️ Переход к определению по F12 открывает процедуру, даже если она свёрнута, и ставит курсор на её заголовок.
• 📋 Список процедур и функций модуля (команда в меню Текст) переводит на выбранную процедуру и раскрывает её.
• 🔢 Переход к строке по номеру (Ctrl + G) раскрывает блок, в котором эта строка находится.
• 🐞 При отладке, если точка останова стоит внутри свёрнутого блока, отладчик показывает строку остановки развёрнутой.

Обратного автоматизма нет: после того как вы ушли из процедуры, она остаётся развёрнутой. Чтобы снова привести модуль к компактному виду, нажмите Ctrl + Shift + Num- ещё раз.

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

Сворачивание в разных модулях и в 1С:EDT

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

В 1С:EDT

В EDT сворачивание устроено как в любом редакторе на базе Eclipse:

• значки сворачивания стоят на левом поле, рядом с номерами строк;
• Ctrl + Num- и Ctrl + Num+ сворачивают и разворачивают текущий блок;
• Ctrl + Shift + Num/ сворачивает все блоки, Ctrl + Num* разворачивает все;
• настройки сворачивания — в Window → Preferences: введите в поле фильтра слово Folding, чтобы быстро найти страницу редактора встроенного языка.

Если сочетания в EDT не срабатывают, проверьте Window → Preferences → General → Keys: там можно найти команды Collapse, Expand, Collapse All, Expand All и посмотреть или изменить их клавиши.

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

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