条件付き

実装済み

1 つのクエリについて、セルの値に応じてセルを色付けします。ハイライトルール、カラースケール、データバー。

条件付きディレクティブは、値に応じてセルに色を付けます。対象はこのクエリだけです。たとえば、ステータスが Failed、残高がマイナスになるとピンクで塗りつぶす、レイテンシー列に緑から赤のカラースケールをかける、売上の数値ごとにデータバーを表示する、といった指定ができます。ルールは 1 行に 1 つずつ書き、列ごとに何行でも書けます。

構文

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

ルールは、その名前を持つすべての結果列に、大文字小文字を区別せずに一致して適用されます。効果は次のいずれかです。

効果意味
when=nullセルは NULL.
when=not nullセルは次ではありません NULL.
when=> NN より大きい数値。
when=< NN 未満の数値。
when=between A and BA から B までの数値(両端を含む)。範囲の上限と下限はどちらの順で指定しても構いません。
when=is TEXTTEXT と等しいテキスト(大文字小文字は区別しない)。
when=contains TEXTTEXT を含むテキスト(大文字小文字は区別しない)。
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: 結果の列に適用されるルールごとの行。参照: グリッドをロックする.