Как создать выпадающий список в 1С: пошаговое руководство с примерами кода

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

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

Типы выпадающих списков в 1С и их назначение

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

• 📋 Поле ввода с выбором из справочника — классический вариант, когда пользователь может либо выбрать значение из списка, либо ввести его вручную. Подходит для справочников с небольшим количеством элементов (например, «Типы документов» или «Статусы заказов»).
• 🔍 Поле выбора с динамическим фильтром — список обновляется в зависимости от выбранных ранее значений (например, при выборе региона меняется список городов). Требует программной обработки события ПриИзменении.
• 📊 Поле выбора с иерархией — используется для работы с иерархическими справочниками (например, «Номенклатура» с группами и подгруппами товаров). Позволяет отображать дерево элементов.
• 🔄 Поле выбора с множественным выбором — даёт возможность выбирать несколько значений одновременно (например, для тегов или категорий). Реализуется через ПолеВыбораСписка.

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

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

Создание простого выпадающего списка на основе справочника

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

Алгоритм действий:

1. Откройте конфигуратор и перейдите в раздел Объекты → Документы → ЗаявкаНаРемонт.
2. В палитре свойств документа найдите вкладку Формы и откройте основную форму (или создайте новую).
3. В конструкторе формы добавьте новый элемент Поле ввода (или Поле выбора, если нужно ограничить только выбором без ручного ввода).
4. В свойствах поля укажите:
   • 📌 Тип значения — выберите справочник ВидыНеисправностей.
   • 📌 Путь к данным — укажите реквизит документа, который будет хранить выбранное значение (например, ТипНеисправности).
   • 📌 Режим выбора — установите ВыборИзСписка, если нужно запретить ручной ввод.

После этих действий в форме документа появится выпадающий список, который будет показывать все элементы справочника ВидыНеисправностей. Если справочник пустой, список будет пустым — это нормально. Заполните справочник тестовыми данными через 1С:Предприятие в пользовательском режиме.

Настройка динамического фильтра для выпадающего списка

Статичные списки удобны, но часто требуется динамическая фильтрация. Например, в документе «Реализация товаров» список номенклатуры должен зависеть от выбранного склада. Для этого нужно:

1. Добавить в форму документа два поля:
   • 🏭 Склад (тип — справочник Склады).
   • 📦 Номенклатура (тип — справочник Номенклатура).

Процедура СкладПриИзменении(Элемент)
// Очищаем текущий выбор номенклатуры
Элементы.Номенклатура.Значение = Неопределено;

// Настраиваем динамический список для номенклатуры
Элементы.Номенклатура.СписокВыбора.Очистить;
Элементы.Номенклатура.СписокВыбора.ЗагрузитьДанные(
Номенклатура.Выбрать(

"Склад = &Склад",
Новый Структура("Склад", Элементы.Склад.Значение)
)
);
КонецПроцедуры

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

• 🔹 В справочнике Номенклатура должно быть реквизит Склад (или аналогичный для привязки к складам).
• 🔹 Если номенклатура не привязана к складам напрямую, используйте регистр сведений (например, ОстаткиТоваров).

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

Работа с иерархическими справочниками в выпадающих списках

Иерархические справочники (например, Номенклатура с группами и подгруппами товаров) требуют особого подхода при отображении в выпадающих списках. По умолчанию 1С показывает все элементы справочника без учёта иерархии, что не всегда удобно. Чтобы отобразить дерево групп, нужно:

1. В свойствах поля выбора установить Отображение = ИерархическийСписок.
2. Настроить параметры отображения:
   • 🌳 УровеньИерархии — определяет, сколько уровней групп будет показано (например, 2 для групп и подгрупп).
   • 📁 ПоказыватьГруппы — если Истина, то группы будут доступны для выбора (по умолчанию Ложь).

Пример кода для настройки иерархического списка в обработчике ПриСозданииНаСервере:

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Элементы.Номенклатура.СписокВыбора.ПараметрыОтображения.УровеньИерархии = 2;
Элементы.Номенклатура.СписокВыбора.ПараметрыОтображения.ПоказыватьГруппы = Истина;
КонецПроцедуры

Если нужно, чтобы при выборе группы автоматически разворачивался список подгрупп, добавьте обработчик события ПриВыборе:

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

Программное управление выпадающими списками

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

• 🔄 Динамическое изменение доступных значений — например, скрыть устаревшие элементы справочника.
• 📈 Сортировка элементов списка — по алфавиту, по коду или по другому реквизиту.
• 🔍 Поиск по части названия — реализация автопоиска в большом справочнике.
• 🔒 Блокировка определённых значений — например, запрет выбора удалённых элементов.

Пример кода для сортировки списка по названию:

Процедура ПриОткрытии(Отказ)
// Получаем список выбора для поля"Контрагент"
Список = Элементы.Контрагент.СписокВыбора;

// Загружаем данные с сортировкой по наименованию
Список.Очистить;
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| Контрагенты.Ссылка КАК Ссылка,
| Контрагенты.Наименование КАК Наименование
|ИЗ
| Справочник.Контрагенты КАК Контрагенты
|УПОРЯДОЧИТЬ ПО
| Наименование";
Результат = Запрос.Выполнить;
Список.ЗагрузитьДанные(Результат);
КонецПроцедуры

Для реализации поиска по части названия можно использовать событие ПриВводеСтрокиПоиска:

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

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| Контрагенты.Ссылка КАК Ссылка
|ИЗ
| Справочник.Контрагенты КАК Контрагенты
|ГДЕ
| Контрагенты.Наименование ПОДОБНО &Поиск";
Запрос.УстановитьПараметр("Поиск","%" + ТекстПоиска +"%");
Список.ЗагрузитьДанные(Запрос.Выполнить);
КонецЕсли;
КонецПроцедуры

⚠️ Внимание: При программной загрузке данных в список выбора всегда очищайте его перед загрузкой (Список.Очистить), иначе новые данные добавятся к старым, что приведёт к дублированию элементов.

Типичные ошибки и их решения

При работе с выпадающими списками в 1С разработчики часто сталкиваются с типичными проблемами. Разберём самые распространённые:

Если список ведёт себя нестабильно (например, пропадают элементы после обновления формы), проверьте:

• 🔹 Права доступа — у пользователя должны быть права на чтение справочника.
• 🔹 Транзакции — если список загружается в транзакции, которая потом откатывается, данные могут"исчезать".
• 🔹 Кэширование — в редких случаях помогает очистка кэша метаданных (Файл → Открыть... → Обновить конфигурацию).

Оптимизация производительности выпадающих списков

Выпадающие списки могут тормозить работу формы, если не оптимизированы. Основные способы ускорения:

• 🚀 Индексирование полей — добавьте индексы на поля, по которым выполняется фильтрация (например, Склад в справочнике Номенклатура).
• 🗃️ Использование регистров сведений — вместо прямого обращения к справочнику берите данные из регистра (например, ОстаткиТоваров для фильтрации номенклатуры по складу).
• ⏳ Отложенная загрузка — загружайте данные в список только после того, как пользователь кликнет на поле (через событие ПриАктивизации).
• 🔍 Ограничение количества элементов — если в справочнике миллионы записей, загружайте только первые 100–200 элементов, а остальные — по запросу (через ПоказатьЕще).

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

Процедура НоменклатураПриАктивизации(Элемент)
Список = Элементы.Номенклатура.СписокВыбора;
Список.Очистить;

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ ПЕРВЫЕ 200
| Номенклатура.Ссылка КАК Ссылка,
| Номенклатура.Наименование КАК Наименование
|ИЗ
| Справочник.Номенклатура КАК Номенклатура
|УПОРЯДОЧИТЬ ПО
| Наименование";
Список.ЗагрузитьДанные(Запрос.Выполнить);

// Добавляем кнопку"Показать ещё" (если данных больше 200)
Если Номенклатура.Выбрать.Количество > 200 Тогда
Список.ПоказатьКомандуПолученияДанных("Показать ещё 200...");
КонецЕсли;
КонецПроцедуры

Для очень больших справочников (более 100 000 записей) рассмотрите возможность использования виртуальных таблиц или внешних источников данных (например, PostgreSQL через 1С:Альфа-Авто). Однако это требует глубокой доработки конфигурации и обычно применяется в высоконагруженных системах.

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

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

Процедура РегионПриИзменении(Элемент)
Элементы.Город.Значение = Неопределено;
Элементы.Город.СписокВыбора.Очистить;
Элементы.Город.СписокВыбора.ЗагрузитьДанные(
Справочник.Города.Выбрать(

"Регион = &Регион",
Новый Структура("Регион", Элемент.Значение)
)
);
КонецПроцедуры