條件
功能性的針對單一查詢,依值為儲存格上色:醒目提示規則、色階與資料橫條。
條件指示詞會依值為儲存格上色,僅對這個查詢生效:紅色文字用於當 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 匯出 以 Excel 原生的設定格式化條件寫入,順序相同,所以活頁簿的上色和網格一致,值一變就跟著更新。
讓鎖頭來寫入它。 在「條件式格式」對話方塊中設定規則,然後按一下結果名稱前面的鎖頭:SQLly 會寫入一個
conditional: 行,讓適用於結果欄位的每一條規則都各有一行。請參見 鎖定網格.