Условные конструкции
функциональныйОкрашивайте ячейки в зависимости от их значения для одного запроса: правила подсветки, цветовые шкалы и полосы данных.
Условная директива раскрашивает ячейки по их значениям — только в этом запросе: красный текст, когда статус говорит Failed, розовая заливка, когда баланс уходит в минус, зелёно-красная шкала по столбцу задержки или полоска данных за каждой цифрой выручки. Пишите одно правило на строку — и сколько угодно строк на столбец.
Синтаксис
-- sqlly conditional: column=<name>; <effect>[; <style>…]
Правило применяется к каждому столбцу результата с таким именем, сопоставление без учёта регистра. Действие может быть одним из:
| Эффект | Значение |
|---|---|
when=null | Ячейка NULL. |
when=not null | Ячейка не является NULL. |
when=> N | Число больше N. |
when=< N | Число меньше N. |
when=between A and B | Число от A до B, включая обе границы. Границы можно указать в любом порядке. |
when=is TEXT | Текст, равный TEXT, без учёта регистра. |
when=contains TEXT | Текст, содержащий TEXT, без учёта регистра. |
scale=#RRGGBB..#RRGGBB | Цветовая шкала: фон плавно изменяется от первого цвета при минимальном значении столбца до второго при максимальном. Для числовых столбцов. |
bar=#RRGGBB | Полоса данных: полоса длиной по значению, нарисованная за текстом. Для числовых столбцов. |
A when= правило требует хотя бы один стиль:
| Стиль | Значение |
|---|---|
text=#RRGGBB | Цвет текста. |
fill=#RRGGBB | Цвет фона. |
bold | Жирный текст. |
Цвета записываются как #RRGGBB, или #RRGGBBAA с альфа-каналом для прозрачной заливки. Текст после when= не может содержать ;.
Примеры
-- sqlly conditional: column=Status; when=is Failed; text=#B00020; bold
-- sqlly conditional: column=Balance; when=< 0; fill=#FDE7E9
-- sqlly conditional: column=Latency; scale=#63BE7B..#F8696B
-- sqlly conditional: column=Revenue; bar=#5B9BD5
-- sqlly conditional: column=ClosedAt; when=null; fill=#FFF4CE80
SELECT Status, Balance, Latency, Revenue, ClosedAt FROM accounts;
Несколько правил для одного столбца читаются сверху вниз. Здесь большой итог — жирный зелёный, отрицательный — красный, и каждое значение вдобавок получает полосу данных:
-- sqlly conditional: column=Total; when=> 10000; text=#1E7B34; bold
-- sqlly conditional: column=Total; when=< 0; text=#B00020
-- sqlly conditional: column=Total; bar=#5B9BD5
Какое правило побеждает
- Первое совпавшее
when=правило для столбца форматирует ячейку; последующие совпадающие правила пропускаются. - Совпавшее правило своим
fillперебивает цветовую шкалу, в любом месте, где проходит линия шкалы. Цвет текста и полужирное начертание из правила по-прежнему сочетаются со шкалой и полосой данных. - Одна цветовая шкала и одна полоска данных на столбец: когда их несколько, применяется первое из каждого.
- Правила директив имеют приоритет над правилами из диалогового окна «Условное форматирование» - чтобы запрос мог переопределить ваши обычные цвета для своих столбцов.
Условия для чисел, цветовые шкалы и полоски данных учитывают только те ячейки, которые база данных вернула как числа; текст, выглядящий как число, остаётся без изменений. Столбец, в котором все значения одинаковы, закрашивает средний цвет своей шкалы и полоски на всю длину.
Правила переносятся в Экспорт в Excel как собственное условное форматирование Excel, в том же порядке, поэтому книга раскрашена как сетка и обновляется вслед за значениями в ней.
conditional: строку для каждого правила, которое действует на столбцы результата. См. Заблокировать сетку.