条件
功能的针对单个查询,按值为单元格着色:高亮规则、色阶和数据条。
条件指令会按单元格的值为其着色,仅对此查询生效:红色文字表示状态值为 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 带有用于半透明填充的 alpha 通道。其后的文本 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 导出 ,顺序保持不变,因此工作簿就像网格一样着色,并在值变化时自动更新。
让锁来写。 在条件格式对话框中设置规则,然后点击结果名称前面的锁:SQLly 会写入一个
conditional: 适用于结果列的每条规则各占一行。参见 锁定网格.