Как в 1С 8.3 реализовать выпадающий список с возможностью ручного ввода в поле формы

← На главную

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

Разберем базовые настройки свойств элемента формы

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

Рассмотрим ключевые свойства, которые нам понадобятся:

КнопкаВыпадающегоСписка (DropListButton): Установим значение в Да. Это добавит маленькую стрелку справа от поля, при нажатии на которую будет раскрываться список.
РежимВыбораИзСписка (ListChoiceMode): Установим в значение Нет. Это критически важный момент. Если оставить здесь Да, система заблокирует возможность ручного ввода любого текста, не входящего в список.
РедактированиеТекста (TextEdit): Убедимся, что стоит флаг Да. Это позволит пользователю печатать в поле.

После установки этих свойств поле визуально станет похожим на «комбобокс», но теперь нам нужно наполнить его данными.

Программное заполнение списка выбора

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

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


&НаСервере
Процедура ЗаполнитьСписокВыбораНаСервере()
    
    // Очищаем текущий список, если это необходимо
    Элементы.НашРеквизитНомерПриказа.СписокВыбора.Очистить();
    
    // Формируем запрос к данным
    Запрос = Новый Запрос;
    Запрос.Текст = 
        "ВЫБРАТЬ
        |   Награды.НомерПриказа КАК Номер
        |ИЗ
        |   Справочник.Награды КАК Награды
        |ГДЕ
        |   Награды.Ссылка = &Ссылка";
    
    Запрос.УстановитьПараметр("Ссылка", Объект.Награда);
    РезультатЗапроса = Запрос.Выполнить();
    Выборка = РезультатЗапроса.Выбрать();
    
    // Получаем доступ к списку выбора элемента формы
    СписокДляЗаполнения = Элементы.НашРеквизитНомерПриказа.СписокВыбора;
    
    Пока Выборка.Следующий() Цикл
        СписокДляЗаполнения.Добавить(Выборка.Номер);
    КонецЦикла;

КонецПроцедуры

В данном примере мы выбираем данные из базы и добавляем их в коллекцию СписокВыбора. Благодаря тому, что РежимВыбораИзСписка выключен, пользователь сможет как выбрать один из этих «Номеров», так и вписать свой собственный текст.

Использование события АвтоПодбор для динамического поиска

Если данных в справочнике очень много, заполнять весь список выбора сразу неэффективно. Проанализируем более продвинутый метод — использование события АвтоПодбор. Это событие срабатывает, когда пользователь начинает вводить текст в поле.

Рассмотрим, как это реализовать. В свойствах элемента формы найдем событие АвтоПодбор и создадим обработчик:


&НаКлиенте
Процедура РеквизитАвтоПодбор(Элемент, Текст, ДанныеВыбора, ПараметрыПолученияДанных, Ожидание, СтандартнаяОбработка)
    
    // Если пользователь еще печатает (Ожидание > 0), можно подождать
    Если Ожидание = 0 Тогда
        // Отменяем стандартную обработку, чтобы подставить свои данные
        СтандартнаяОбработка = Ложь;
        
        // Вызываем серверную функцию для поиска подходящих значений
        ДанныеВыбора = ПолучитьДанныеДляПодбораНаСервере(Текст);
    КонецЕсли;
    
КонецПроцедуры

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


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

КонецФункции

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

Обработка ввода нового значения

Когда мы разрешаем ручной ввод (то есть РежимВыбораИзСписка = Нет), возникает вопрос: что делать, если пользователь ввел текст, которого нет в базе? Если реквизит формы имеет тип Строка, то данные просто запишутся в объект. Однако, если мы работаем со ссылочными типами (например, СправочникСсылка), нам может потребоваться создать новый элемент справочника «на лету».

Разберем, как это сделать в событии ПриИзменении:


&НаСервере
Процедура РеквизитПриИзмененииНаСервере()
    
    // Проверяем, существует ли уже элемент с таким наименованием
    НайденнаяСсылка = Справочники.РФО_Теплоходы.НайтиПоНаименованию(Объект.ИмяРеквизита);
    
    Если НайденнаяСсылка.Пустая() Тогда
        // Если не нашли — создаем новый элемент
        НовыйОбъект = Справочники.РФО_Теплоходы.СоздатьЭлемент();
        НовыйОбъект.Наименование = Объект.ИмяРеквизита;
        НовыйОбъект.Записать();
        
        // Подставляем ссылку на созданный объект
        // Внимание: это сработает, если тип реквизита позволяет хранить ссылку
        // Если тип реквизита "Строка", можно оставить просто текст
    КонецЕсли;

КонецПроцедуры

Специфика работы с типами данных

Проанализируем ситуацию с типами данных реквизита, так как это часто вызывает путаницу:

Если реквизит имеет тип Строка: Это самый простой вариант для реализации «выпадающего списка с ручным вводом». Вы просто наполняете СписокВыбора строковыми значениями. Пользователь может выбрать строку или написать свою.
Если реквизит имеет тип СправочникСсылка: Здесь сложнее. При ручном вводе 1С попытается выполнить «автоподбор по строке» среди элементов справочника. Если вы хотите разрешить ввод текста, который СРАЗУ станет наименованием нового элемента, вам придется использовать промежуточный строковый реквизит на форме или активно использовать событие ОбработкаСозданияВыбранногоЗначения.