Condicional
funcionalColorir as células pelos valores delas em uma consulta: regras de destaque, escalas de cores e barras de dados.
A diretiva condicional colore células de acordo com seus valores, apenas para esta consulta: texto vermelho quando um status diz Failed, preenchimento rosa quando um saldo fica negativo, uma escala de cor do verde ao vermelho em uma coluna de latência, ou uma barra de dados atrás de cada valor de receita. Escreva uma regra por linha, quantas linhas por coluna você quiser.
Sintaxe
-- sqlly conditional: column=<name>; <effect>[; <style>…]
Uma regra vale para toda coluna de resultado com esse nome, sem diferenciar maiúsculas de minúsculas. O efeito é um dos seguintes:
| Efeito | Significado |
|---|---|
when=null | A célula é NULL. |
when=not null | A célula não é NULL. |
when=> N | Um número maior que N. |
when=< N | Um número menor que N. |
when=between A and B | Um número de A a B, ambos incluídos. Os limites podem vir em qualquer ordem. |
when=is TEXT | Texto igual a TEXT, ignorando maiúsculas e minúsculas. |
when=contains TEXT | Texto que contém TEXT, ignorando maiúsculas e minúsculas. |
scale=#RRGGBB..#RRGGBB | Uma escala de cores: o fundo faz a transição da primeira cor, no menor valor da coluna, até a segunda, no maior. Colunas numéricas. |
bar=#RRGGBB | Uma barra de dados: uma barra do tamanho do valor, desenhada atrás do texto. Colunas numéricas. |
A when= regra precisa de pelo menos um estilo:
| Estilo | Significado |
|---|---|
text=#RRGGBB | Cor do texto. |
fill=#RRGGBB | Cor de fundo. |
bold | Texto em negrito. |
As cores são escritas #RRGGBB, ou #RRGGBBAA com um canal alfa para um preenchimento translúcido. O texto depois de when= não pode conter um ;.
Exemplos
-- 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;
Várias regras em uma coluna são aplicadas de cima para baixo. Aqui, um total grande fica em verde negrito, um negativo fica em vermelho, e cada valor também recebe uma barra de dados:
-- sqlly conditional: column=Total; when=> 10000; text=#1E7B34; bold
-- sqlly conditional: column=Total; when=< 0; text=#B00020
-- sqlly conditional: column=Total; bar=#5B9BD5
Qual regra prevalece
- A primeira correspondência
when=regra para uma coluna estiliza a célula; as regras seguintes são ignoradas. - Na regra correspondente, o
fillvence uma escala de cores, independentemente de onde a linha da escala estiver. A cor do texto e o negrito da regra continuam se combinando com a escala e com uma barra de dados. - Uma escala de cores e uma barra de dados por coluna: quando há várias, a primeira de cada uma se aplica.
- As regras da diretiva vêm antes das regras salvas no diálogo de Formatação Condicional - para que uma consulta possa sobrepor suas cores do dia a dia nas próprias colunas dela.
Condições numéricas, escalas de cores e barras de dados olham apenas para células que o banco de dados retornou como números; textos com aparência numérica são deixados de lado. Uma coluna cujos valores são todos iguais pinta a cor do meio de sua escala e barras de comprimento completo.
As regras vão para um Exportação para Excel como formatação condicional nativa do Excel, na mesma ordem, de modo que a planilha fica colorida como a grade e se mantém atualizada quando os valores mudam lá.
conditional: linha para cada regra que se aplica às colunas do resultado. Veja Bloquear grade.