条件

功能的

针对单个查询,按值为单元格着色:高亮规则、色阶和数据条。

条件指令会按单元格的值为其着色,仅对此查询生效:红色文字表示状态值为 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: 适用于结果列的每条规则各占一行。参见 锁定网格.