Как добавить список в форму 1С

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

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

Мы рассмотрим как стандартные механизмы платформы, так и продвинутые приемы работы со списками. Вы научитесь настраивать вывод колонок, управлять видимостью элементов и реагировать на изменения, вносимые пользователем. Это позволит вам создавать гибкие и отзывчивые формы, соответствующие современным стандартам эргономики.

Создание реквизита и размещение на форме

Первым шагом для интеграции списка является создание соответствующего реквизита в объекте метаданных. Откройте конфигуратор и перейдите к дереву метаданных вашей конфигурации. Найдите нужную форму, например, форму документа или обработки, и раскройте её структуру. Вам необходимо добавить новый реквизит в ветку «Реквизиты».

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

После создания реквизита перетащите его на макет формы. Платформа автоматически создаст поле типа «Табличное поле». Теперь элемент готов к базовой настройке. Однако просто отображать данные недостаточно — необходимо настроить их представление.

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

Настройка отображения колонок и свойств

По умолчанию табличное поле может отображать не все необходимые данные или показывать их в неудобном порядке. Чтобы исправить это, перейдите в свойства элемента на форме. Найдите свойство «Выводить поля» и установите значение «Все поля» или «Выбранные поля» в зависимости от вашей задачи. Для сложных интерфейсов лучше выбирать конкретные поля вручную.

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

• 📊 Заголовок колонки: позволяет задать понятное имя столбца, отличное от имени поля в базе данных.
• 📏 Ширина: фиксирует размер колонки или позволяет пользователю изменять его вручную.
• 👁️ Видимость: скрывает технические поля, которые не нужны для визуального анализа, но необходимы для логики.

Также стоит обратить внимание на свойство Режим чтения. Если список предназначен только для просмотра, установите значение «Только просмотр». Это запретит пользователю редактировать ячейки напрямую, что защитит данные от случайной порчи. Для редактируемых списков это свойство должно быть снято.

⚠️ Внимание: Изменение свойств колонок в режиме предприятия возможно только если разрешено пользователю. В режиме конфигуратора изменения применяются немедленно.

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

Заполнение списка значениями программно

Если вы работаете с типом СписокЗначений, вам придется самостоятельно наполнять его данными. Это делается в модуле формы, обычно в обработчике события ПриСозданииНаСервере или ПриОткрытии. Используйте метод Добавить() для вставки новых строк.

Каждая строка списка значений может иметь несколько полей. Стандартные поля включают «Значение», «Представление», «Пометка» и «Сортировка». Вы можете добавлять произвольные поля, указывая их имена при создании структуры. Это позволяет хранить в одной строке списка как ключевые идентификаторы, так и отображаемый текст.

Список = СписокЗначений();
Список.Добавить(Новый УникальныйИдентификатор(), "Первый элемент", , Истина);
Список.Добавить(Новый УникальныйИдентификатор(), "Второй элемент", , Ложь);
Объект.МойСписок = Список;

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

Оптимизация больших списков

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

Локальные изменения в списке значений исчезнут после закрытия формы, если не предусмотрена процедура записи.

Обработка событий и взаимодействие с пользователем

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

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

• 🖱️ Двойной клик: часто используется для открытия карточки выбранного элемента справочника.
• ⌨️ Нажатие клавиш: позволяет реализовать горячие клавиши для удаления или добавления строк.
• 📝 Изменение ячейки: триггер для пересчета итогов или проверки введенных данных.

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

⚠️ Внимание: При обработке событий на клиенте избегайте тяжелых вычислений. Длительные операции блокируют интерфейс и создают ощущение «зависания» программы у пользователя.

Если необходимо запретить изменение определенных строк, используйте событие НачалоИзмененияСтроки. Возврат значения Ложь из этого обработчика отменит действие пользователя. Это мощный инструмент для контроля целостности данных.

Работа с выделением и текущей строкой

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

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

Свойство	Тип доступа	Описание
ТекущаяСтрока	Чтение/Запись	Объект данных активной строки
ВыделенныеСтроки	Чтение	Коллекция выбранных строк
ТекущиеДанные	Чтение	Данные ячейки под курсором
Колонки	Чтение	Настройки отображения столбцов

Иногда требуется снять выделение со всех строк. Для этого достаточно присвоить свойству ТекущаяСтрока значение Неопределено. Это возвращает форму в нейтральное состояние, что может быть необходимо перед выполнением некоторых операций.

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

Сохранение и передача данных списка

Когда работа со списком завершена, данные необходимо сохранить. Для реквизитов типа СправочникСсылка это происходит автоматически при записи объекта формы. Для СписокЗначений требуется явная запись в регистр сведений или в табличную часть документа.

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

При записи табличной части документа цикл по списку значений выглядит следующим образом:

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

Важно очищать табличную часть перед заполнением, если вы не планируете добавлять данные к существующим. Иначе возникнут дубликаты записей. Используйте метод Очистить() перед началом цикла заполнения.

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

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

Как добавить вычисляемую колонку в список?

Вычисляемые колонки создаются в свойствах элемента формы. В поле «Выражение» укажите формулу, использующую имена других полей списка. Например, Цена * Количество. Данные в такой колонке пересчитываются автоматически при изменении исходных полей.

Можно ли запретить удаление строк из списка?

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

Почему список не отображает все поля справочника?

Проверьте свойство «Выводить поля». Если выбрано «Выбранные поля», убедитесь, что нужные колонки добавлены в список вывода. Также проверьте права доступа пользователя к этим полям справочника.

Как отсортировать список по умолчанию?

В свойствах табличного поля найдите раздел «Сортировка». Добавьте нужное поле и укажите направление (возрастание или убывание). Сортировка применится автоматически при открытии формы.

Можно ли использовать список для выбора из регистра сведений?

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