Почему не работает программное условное оформление ячейки табличной части и как его настроить

← На главную

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

Анализ типичных ошибок в коде оформления

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


&НаСервере
Процедура ОформлениеТЧ()
    ДанныеФормы = ЭтаФорма.Объект.Товары;
    Для Каждого Строка Из ДанныеФормы Цикл
        СправочныйЦвет = ЦветНаСервере(Строка.Номенклатура);
        // ... преобразование строки в Новый Цвет(X, Y, Z) ...
        
        ЭлементУсловногоОформления = УсловноеОформление.Элементы.Добавить();
        
        ОформляемоеПоле = ЭлементУсловногоОформления.Поля.Элементы.Добавить();
        ОформляемоеПоле.Поле = Новый ПолеКомпоновкиДанных("Номенклатура");
        ОформляемоеПоле.Использование = Истина;
        
        ЭлементОтбора = ЭлементУсловногоОформления.Отбор.Элементы.Добавить(Тип("ЭлементОтбораКомпоновкиДанных"));
        ЭлементОтбора.ЛевоеЗначение = Новый ПолеКомпоновкиДанных("Объект.Товары.Номенклатура");
        ЭлементОтбора.ВидСравнения = ВидСравненияКомпоновкиДанных.Равно;
        ЭлементОтбора.ПравоеЗначение = Строка.Номенклатура;
        
        ЭлементУсловногоОформления.Оформление.УстановитьЗначениеПараметра("ЦветФона", ЦветЯчейки);
    КонецЦикла;
КонецПроцедуры

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

Неверное имя оформляемого поля. Это самая распространенная ошибка. В свойстве ОформляемоеПоле.Поле платформе требуется передать имя элемента формы (колонки таблицы), а не имя реквизита объекта из метаданных. По умолчанию колонка табличной части на форме получает имя вида ТоварыНоменклатура (префикс таблицы плюс имя реквизита). Передавая просто "Номенклатура", мы указываем несуществующий элемент интерфейса, и платформа молча пропускает применение стилей.
Отсутствие флага активности отбора. При создании элемента отбора компоновки данных программно свойство Использование по умолчанию может оставаться в значении Ложь. Чтобы отбор начал действовать, обязательно требуется явно указать ЭлементОтбора.Использование = Истина;.
Генерация правил оформления в цикле по строкам. Условное оформление в управляемых формах рассчитано на декларативные правила, а не на построчную обработку. Создание отдельного элемента условного оформления под каждую строку документа приводит к тому, что при повторном открытии или изменении данных коллекция разрастается, а новые строки, добавляемые пользователем вручную, не попадают под правила.
Неактивность общего элемента оформления. Для надежного применения правила необходимо убедиться, что включено свойство ЭлементУсловногоОформления.Использование = Истина;.
Проблема производительности при получении свойств (N+1 запросов). Вызов вспомогательных серверных функций для каждой строки таблицы документа в цикле генерирует множество однотипных запросов к базе данных, замедляя открытие формы.

Правильная настройка условного оформления для колонок и строк

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

Если требуется раскрасить конкретную колонку таблицы при наступлении определенного условия, мы создаем элемент условного оформления, настраиваем отбор, указываем точное имя элемента формы и задаем параметры оформления:


&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    НастроитьУсловноеОформление();
КонецПроцедуры

&НаСервере
Процедура НастроитьУсловноеОформление()
    
    // Очищаем коллекцию, если процедура может вызываться повторно
    УсловноеОформление.Элементы.Очистить();
    
    // Создаем новый элемент условного оформления
    ЭлементУО = УсловноеОформление.Элементы.Добавить();
    ЭлементУО.Использование = Истина;
    
    // 1. Указываем оформляемое поле (имя элемента формы на управляемой форме!)
    ОформляемоеПоле = ЭлементУО.Поля.Элементы.Добавить();
    ОформляемоеПоле.Поле = Новый ПолеКомпоновкиДанных(Элементы.ТоварыНоменклатура.Имя);
    ОформляемоеПоле.Использование = Истина;
    
    // 2. Настраиваем условие отбора
    ЭлементОтбора = ЭлементУО.Отбор.Элементы.Добавить(Тип("ЭлементОтбораКомпоновкиДанных"));
    ЭлементОтбора.ЛевоеЗначение = Новый ПолеКомпоновкиДанных("Объект.Товары.Цена");
    ЭлементОтбора.ВидСравнения = ВидСравненияКомпоновкиДанных.Меньше;
    ЭлементОтбора.ПравоеЗначение = 100;
    ЭлементОтбора.Использование = Истина;
    
    // 3. Устанавливаем параметры визуального оформления
    ЭлементУО.Оформление.УстановитьЗначениеПараметра("ЦветФона", Новый Цвет(255, 230, 230));
    ЭлементУО.Оформление.УстановитьЗначениеПараметра("ЦветТекста", Новый Цвет(150, 0, 0));
    
КонецПроцедуры

Как раскрасить всю строку табличной части целиком

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


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

Динамический цвет из дополнительных реквизитов или справочников

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

Для решения подобной задачи рекомендуется применить архитектурный подход с вычисляемым реквизитом:

Добавим в табличную часть документа или только в структуру реквизитов формы служебную колонку (например, КодЦвета с типом Строка или Число).
При заполнении табличной части или в обработчике ПриИзменении номенклатуры заполняем этот реквизит соответствующим идентификатором цвета или категории.
В процедуре ПриСозданииНаСервере один раз создаем ограниченный набор правил УсловноеОформление для каждого возможного значения КодЦвета.

Такой подход обеспечивает максимальную производительность, корректно работает при добавлении пользователем новых строк и гарантирует стабильную отрисовку формы в интерфейсе «Такси».