Как добавить переключатель на форму в 1С 8.3

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

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

Ниже разобраны оба способа — через конфигуратор (визуально) и программно, а также обработка выбора, типичные ошибки и случаи, когда переключатель лучше заменить другим элементом.

Как устроен переключатель в управляемой форме

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

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

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

Создание реквизита для переключателя

Откройте нужную форму в конфигураторе (например, форму обработки, отчёта или документа). Перейдите на закладку «Реквизиты» в правой части редактора формы и добавьте новый реквизит формы. Задайте имя, например «СпособФормирования», и выберите тип.

Если варианты выбора являются частью прикладной логики и используются в нескольких местах, правильнее создать перечисление в дереве конфигурации и указать тип реквизита «ПеречислениеСсылка.ИмяПеречисления». Если переключатель нужен только на конкретной форме (например, режим «Сводно / Детально» в отчёте), достаточно типа «Число» или «Строка».

Для реквизита с числовым или строковым типом имеет смысл сразу задать значение по умолчанию — иначе при открытии формы ни один вариант не будет выбран, что может запутать пользователя. Значение по умолчанию удобно установить в обработчике «ПриСозданииНаСервере».

Добавление элемента переключателя на форму

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

После смены вида откройте свойство «Список выбора» и добавьте строки: для каждой укажите значение (соответствующее типу реквизита) и представление — текст, который увидит пользователь рядом с точкой переключателя. Если реквизит имеет тип перечисления, список выбора можно не заполнять вручную: платформа подставит значения перечисления автоматически, но явный список позволяет задать свои подписи и порядок.

Полезные свойства для настройки внешнего вида: «КоличествоКолонок» — располагает варианты в несколько колонок (0 — в одну строку или по ширине), «ГоризонтальноеПоложение» и заголовок элемента. Для компактных форм удобно размещать варианты в одну строку, для форм с длинными подписями — вертикально.

1. 1
   Откройте форму объекта в конфигураторе
2. 2
   Добавьте реквизит формы с подходящим типом (перечисление, число, строка)
3. 3
   Перетащите реквизит в дерево элементов формы
4. 4
   В палитре свойств установите вид элемента «Поле переключателя»
5. 5
   Заполните список выбора: значения и представления вариантов
6. 6
   Задайте значение по умолчанию в ПриСозданииНаСервере
7. 7
   Сохраните конфигурацию и проверьте форму в режиме Предприятия

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

Если элемент нужно добавить динамически (например, состав вариантов зависит от настроек), переключатель создаётся кодом в обработчике «ПриСозданииНаСервере». Сначала программно добавляется реквизит формы, затем элемент формы с типом «ПолеФормы» и видом переключателя, после чего заполняется список выбора.

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    ДобавляемыеРеквизиты = Новый Массив;
    ДобавляемыеРеквизиты.Добавить(Новый РеквизитФормы("СпособФормирования", Новый ОписаниеТипов("Число")));
    ИзменитьРеквизиты(ДобавляемыеРеквизиты);

    Элемент = Элементы.Добавить("СпособФормирования", Тип("ПолеФормы"));
    Элемент.Вид = ВидПоляФормы.ПолеПереключателя;
    Элемент.ПутьКДанным = "СпособФормирования";
    Элемент.СписокВыбора.Добавить(0, "Сводно");
    Элемент.СписокВыбора.Добавить(1, "Детально");

    ЭтаФорма["СпособФормирования"] = 0;
КонецПроцедуры

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

Обработка выбора пользователя

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

Текущее выбранное значение доступно через реквизит формы: «ЭтаФорма.СпособФормирования» или просто по имени реквизита в модуле формы. Сравнивайте его со значениями из списка выбора или со значениями перечисления, чтобы ветвить логику.

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

&НаКлиенте
Процедура СпособФормированияПриИзменении(Элемент)
    Элементы.ГруппаДетализация.Видимость = (СпособФормирования = 1);
КонецПроцедуры

Переключатель или другой элемент: как выбрать

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

Проверка результата и типичные ошибки

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

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

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