条件付き
実装済み1 つのクエリについて、セルの値に応じてセルを色付けします。ハイライトルール、カラースケール、データバー。
条件付きディレクティブは、値に応じてセルに色を付けます。対象はこのクエリだけです。たとえば、ステータスが Failed、残高がマイナスになるとピンクで塗りつぶす、レイテンシー列に緑から赤のカラースケールをかける、売上の数値ごとにデータバーを表示する、といった指定ができます。ルールは 1 行に 1 つずつ書き、列ごとに何行でも書けます。
構文
-- 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 | カラースケール:背景が、列の最小値での 1 つ目の色から、最大値での 2 つ目の色へとブレンドされます。数値列。 |
bar=#RRGGBB | データバー:値に応じた長さのバーを、テキストの背後に描画します。数値列。 |
A when= ルールには少なくとも 1 つのスタイルが必要です:
| スタイル | 意味 |
|---|---|
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;
1つの列に対する複数のルールは、上から下の順に評価されます。この例では、大きな合計は太字の緑、負の値は赤になり、すべての値にデータバーも付きます:
-- 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カラースケールより優先されます、スケールの線がどこにあっても。ルールのテキスト色と太字は、スケールやデータバーとも引き続き組み合わされます。 - 列ごとに 1 つのカラースケールと 1 つのデータバー: 複数ある場合は、それぞれの最初のものが適用されます。
- ディレクティブのルールは、条件付き書式ダイアログに保存されたルールより先に適用されます - そのため、クエリは自身の列に限って、日常的に使う色を上書きできます。
数値条件、カラースケール、データバーは、データベースが数値として返したセルだけを対象にします。数値に見えるテキストには手を加えません。列の値がすべて同じ場合は、スケールの中間色と全長のバーで描画されます。
設定したルールは、 Excel エクスポート ネイティブのExcel条件付き書式として同じ順序で書き出されるため、ブックはグリッドと同じ色になり、グリッド側で値が変わっても追従します。
ロックに書かせる。 条件付き書式ダイアログでルールを設定し、結果名の手前にあるロックをクリックすると、SQLly が次の行を書き込みます
conditional: 結果の列に適用されるルールごとの行。参照: グリッドをロックする.