條件

功能性的

針對單一查詢,依值為儲存格上色:醒目提示規則、色階與資料橫條。

條件指示詞會依值為儲存格上色,僅對這個查詢生效:紅色文字用於當 Failed,餘額為負時填上粉紅色、延遲欄位套用綠到紅的色階,或在每個營收數字後面畫資料條。每行一條規則,每個欄位要幾行都行。

語法

-- sqlly conditional: column=<name>; <effect>[; <style>…]

規則會套用到所有同名的結果欄,不分大小寫。效果是下列其中之一:

效果意義
when=null儲存格是 NULL.
when=not null儲存格不是 NULL.
when=> N大於 N 的數字。
when=< N小於 N 的數字。
when=between A and BA 到 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 匯出 以 Excel 原生的設定格式化條件寫入,順序相同,所以活頁簿的上色和網格一致,值一變就跟著更新。

讓鎖頭來寫入它。 在「條件式格式」對話方塊中設定規則,然後按一下結果名稱前面的鎖頭:SQLly 會寫入一個 conditional: 行,讓適用於結果欄位的每一條規則都各有一行。請參見 鎖定網格.