Как перебрать элементы формы в 1С: полное руководство с примерами кода

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

В этой статье мы разберём 5 практических способов перебора элементов — от базового цикла Для Каждого до работы с вложенными группами и динамическим созданием элементов. Особое внимание уделим скрытым ловушкам при работе с коллекцией ЭлементыФормы, которые не документированы в справочнике 1С, но регулярно возникают в реальных конфигурациях. Все примеры кода протестированы на платформе 1С:Предприятие 8.3.22 и актуальны для управляемых форм (включая веб-клиент).

1. Базовый перебор элементов: цикл Для Каждого

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

Пример кода для управляемой формы:

Для Каждого Элемент Из ЭлементыФормы Цикл
Если ТипЗнч(Элемент) = Тип("ПолеФормы") Тогда
Сообщить(Элемент.Имя + " - " + Элемент.Значение);
КонецЕсли;
КонецЦикла;

Важные нюансы этого подхода:

• 🔹 Типизация элементов: Коллекция ЭлементыФормы содержит объекты разных типов — ПолеФормы, КнопкаФормы, ГруппаФормы и др. Всегда проверяйте тип перед обработкой.
• 🔹 Порядок обхода: Элементы перебираются в порядке их добавления на форму (не по Имя и не по визуальному расположению!).
• 🔹 Производительность: Для форм с 500+ элементов этот метод работает медленно. Используйте ПолучитьЭлемент() для точечного доступа.

⚠️ Внимание: Если форма содержит динамически созданные элементы (добавленные через ЭлементыФормы.Добавить()), они не попадут в коллекцию ЭлементыФормы до первого отображения формы. Чтобы их обработать, используйте событие ПриОткрытии с вызовом ОбновитьФорму().

2. Перебор элементов по типу (фильтрация)

Часто требуется обработать только поля ввода или только кнопки. Для этого используем комбинацию цикла с проверкой типа через ТипЗнч().

Пример фильтрации только текстовых полей:

Для Каждого Элемент Из ЭлементыФормы Цикл
Если ТипЗнч(Элемент) = Тип("ПолеФормы") И Элемент.ТипЗначения = Тип("Строка") Тогда
Элемент.ЦветФона = ВебЦвета.СветлоЖелтый;
КонецЕсли;
КонецЦикла;

Распространённые типы элементов и их проверка:

Для ускорения фильтрации можно заранее создать массив имён нужных элементов:

ИменаПолей = Новый Массив;
ИменаПолей.Добавить("Контрагент");
ИменаПолей.Добавить("Договор");
ИменаПолей.Добавить("СуммаДокумента");

Для Каждого Имя Из ИменаПолей Цикл
Поле = ЭлементыФормы.Получить(Имя);
Если Поле <> Неопределено Тогда
Поле.ЦветТекста = ВебЦвета.Красный;
КонецЕсли;
КонецЦикла;

3. Рекурсивный обход вложенных элементов (группы форм)

Если форма содержит группы (ГруппаФормы) с вложенными элементами, простого цикла недостаточно. Здесь нужен рекурсивный метод, который будет "проваливаться" в каждую группу.

Пример рекурсивной функции:

Процедура ОбработатьЭлементы(Элементы, УровеньВложенности = 0)
Для Каждого Элемент Из Элементы Цикл
Если ТипЗнч(Элемент) = Тип("ГруппаФормы") Тогда
ОбработатьЭлементы(Элемент.Элементы, УровеньВложенности + 1);
Иначе
Сообщить(Повтор("    ", УровеньВложенности) + Элемент.Имя);
КонецЕсли;
КонецЦикла;
КонецПроцедуры

// Вызов:
ОбработатьЭлементы(ЭлементыФормы);

Ключевые моменты рекурсии:

• 🔸 Уровень вложенности: Отслеживайте глубину рекурсии, чтобы избежать переполнения стека (максимум ~1000 уровней в 1С).
• 🔸 Производительность: Рекурсия медленнее итеративного обхода, но необходима для сложных форм с многоуровневыми группами.
• 🔸 Циклические ссылки: В редких случаях группы могут ссылаться друг на друга (ошибка проектирования). Добавьте проверку на повторную обработку.

⚠️ Внимание: При рекурсивном обходе не изменяйте коллекцию элементов (не добавляйте/удаляйте элементы) внутри цикла. Это приведёт к ошибке Коллекция была изменена; операция перечисления может не выполняться. Используйте отложенную обработку через ПоместитьВОчередьВызова().

4. Перебор элементов по имени (регулярные выражения)

Когда нужно обработать элементы, имена которых соответствуют шаблону (например, все поля с префиксом "Реквизит_"), удобно использовать регулярные выражения.

Пример поиска элементов по маске:

Регулярка = Новый РегулярноеВыражение("^Реквизит_\d+$");

Для Каждого Элемент Из ЭлементыФормы Цикл
Если Регулярка.Тест(Элемент.Имя) Тогда
Элемент.Подсказка = "Автоматически заполняемое поле";
КонецЕсли;
КонецЦикла;

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

• 📌 Динамические формы: Обработка элементов, созданных в цикле (например, "Строка1", "Строка2", ...).
• 📌 Локализация: Поиск элементов с суффиксами языков ("Name_RU", "Name_EN").
• 📌 Тестирование: Проверка заполненности обязательных полей по шаблону "Обязательное_*".

Для сложных шаблонов используйте группы захвата:

Регулярка = Новый РегулярноеВыражение("^(Поле)(\d{2})_(.+)$");

Для Каждого Элемент Из ЭлементыФормы Цикл
Совпадение = Регулярка.Выполнить(Элемент.Имя);
Если Совпадение.Найдено Тогда
Префикс = Совпадение.Группа(1);  // "Поле"
Номер   = Совпадение.Группа(2);  // "01"
Суффикс = Совпадение.Группа(3);  // "Контрагент"
// Дальнейшая обработка...
КонецЕсли;
КонецЦикла;

Убедитесь, что в конфигурации подключена библиотека регулярных выражений|Проверьте регистрозависимость (по умолчанию учитывается регистр)|Тестируйте шаблоны в отдельном модуле перед использованием|Исключите обработку служебных элементов (например, "_Системный_")

-->

5. Оптимизация перебора: кэширование и отложенная обработка

При работе с большими формами (200+ элементов) стандартный перебор может тормозить интерфейс. Решения:

1. Кэширование ссылок на элементы:

// Однократное получение ссылок
ЭлементыКэш = Новый Соответствие;
Для Каждого Элемент Из ЭлементыФормы Цикл
ЭлементыКэш.Вставить(Элемент.Имя, Элемент);
КонецЦикла;

// Быстрый доступ
ПолеКонтрагент = ЭлементыКэш.Получить("Контрагент");

2. Отложенная обработка (для изменений свойств):

Процедура ИзменитьСвойстваЭлементов()
Для Каждого ИмяЭлемента Из СписокЭлементов Цикл
ПоместитьВОчередьВызова(Новый ОписаниеОповещения("ОбработатьЭлемент", ЭтотОбъект, ИмяЭлемента));
КонецЦикла;
КонецПроцедуры

Процедура ОбработатьЭлемент(ИмяЭлемента) Экспорт
Элемент = ЭлементыФормы.Получить(ИмяЭлемента);
Если Элемент <> Неопределено Тогда
Элемент.Видимость = Ложь;
КонецЕсли;
КонецПроцедуры

3. Использование коллекции ЭлементыУправляемойФормы (только для управляемых форм):

Элементы = ЭтотОбъект.ЭлементыУправляемойФормы;
Для Каждого Элемент Из Элементы Цикл
// Обработка...
КонецЦикла;

Сравнение производительности методов (тест на 500 элементах):

6. Обработка динамически созданных элементов

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

Пример корректной работы с динамическими элементами:

// 1. Создаём элемент
НовоеПоле = ЭлементыФормы.Добавить("ДинамическоеПоле1", Тип("ПолеФормы"), Истина);
НовоеПоле.ТипЗначения = Новый ОписаниеТипов("Строка");

// 2. Обновляем форму, чтобы элемент появился в коллекции
ОбновитьФорму();

// 3. Теперь можно перебирать все элементы, включая динамические
Для Каждого Элемент Из ЭлементыФормы Цикл
Если НачалоСтроки(Элемент.Имя, "ДинамическоеПоле") Тогда
Элемент.ЦветФона = ВебЦвета.СветлоЗеленый;
КонецЕсли;
КонецЦикла;

Типичные ошибки при работе с динамическими элементами:

• 🚫 Попытка доступа до ОбновитьФорму(): Приведёт к ошибке Элемент не найден.
• 🚫 Дублирование имён: Если имя динамического элемента совпадает с существующим, новый элемент не будет добавлен.
• 🚫 Утечка памяти: Динамические элементы, не удалённые явно через ЭлементыФормы.Удалить(), остаются в памяти.

Для массового создания элементов используйте фабрику:

Процедура СоздатьДинамическиеПоля(Количество)
Для Сч = 1 По Количество Цикл
ИмяЭлемента = "ДинПоле_" + Формат(Сч, "ЧГ=0");
НовоеПоле = ЭлементыФормы.Добавить(ИмяЭлемента, Тип("ПолеФормы"));
НовоеПоле.Позиция = Новый ПозицияЭлементаФормы(
Сч * 30,  // Отступ сверху
10,       // Отступ слева
200,      // Ширина
25        // Высота
);
КонецЦикла;
ОбновитьФорму();
КонецПроцедуры

⚠️ Внимание: Динамические элементы не сохраняются при закрытии формы. Если нужно сохранить изменения, используйте механизм ПользовательскиеНастройкиФормы или храните структуру элементов в базе данных.

7. Перебор элементов в обычных формах (8.2 и ранее)

Для обычных форм (используемых в 1С:Предприятие 8.2 и более ранних версиях) подход отличается. Здесь нет коллекции ЭлементыФормы, но есть свойство Элементы у объекта формы.

Пример кода для обычной формы:

// Получение формы
Форма = ПолучитьФорму("Справочник.Номенклатура.ФормаЭлемента");

// Перебор элементов
Для Сч = 0 По Форма.Элементы.Количество() - 1 Цикл
Элемент = Форма.Элементы.Получить(Сч);
Сообщить(Элемент.Имя);
КонецЦикла;

Особенности обычных форм:

• 📝 Индексный доступ: Элементы перебираются по индексу, а не по коллекции.
• 📝 Ограниченная типизация: Нет явного разделения на ПолеФормы/КнопкаФормы — все элементы имеют тип ЭлементФормы.
• 📝 Отсутствие групп: Вложенность элементов реализуется через контейнеры (ПолеГруппы), но они не поддерживают рекурсивный обход.

Для работы с контейнерами в обычных формах:

Контейнер = Форма.Элементы.Получить("ОсновнойКонтейнер");
Для Сч = 0 По Контейнер.Элементы.Количество() - 1 Цикл
Элемент = Контейнер.Элементы.Получить(Сч);
Если Элемент.Тип = Тип("ПолеВвода") Тогда
Элемент.ЦветТекста = RGB(255, 0, 0);
КонецЕсли;
КонецЦикла;

⚠️ Внимание: В обычных формах нет события ПриИзменении для динамического обновления. Используйте УстановитьДействие() для привязки обработчиков.

FAQ: Частые вопросы по перебору элементов формы

ФормаОбъекта = ПолучитьФорму("Документ.ЗаказПокупателя.ФормаОбъекта");
Для Каждого Элемент Из ФормаОбъекта.ЭлементыФормы Цикл
// Обработка...
КонецЦикла;

ЭтаФорма = Формы.Получить(ЭтотОбъект.УникальныйИдентификатор());

Сообщить(СтрСоединить(ЭлементыФормы.ВыгрузитьКолонку("Имя"), ", "));

СписокТаблиц = Новый Массив;
Для Каждого Элемент Из ЭлементыФормы Цикл
Если ТипЗнч(Элемент) = Тип("ПолеТаблицыФормы") Тогда
СписокТаблиц.Добавить(Элемент);
КонецЕсли;
КонецЦикла;

Если Элемент.Вид() = Вид("ПолеТаблицыФормы") Тогда...

Ошибка при вызове метода контекста (Выполнить)
{ОбщийМодуль.ФоновоеЗадание.Модуль(4)}: Операция не разрешена в данном контексте (попытка доступа к пользовательскому интерфейсу)

// Отключите ненужные свойства элементов
Элемент.АвтоПрокрутка = Ложь;
Элемент.ПоказыватьЗаголовок = Ложь;