A formatação condicional permite formatar células para que a aparência delas mude dinamicamente de acordo com o valor que elas contêm ou com valores em outras células. Há muitas aplicações possíveis da formatação condicional, incluindo estes usos:
- Destaque células acima de um determinado limite (por exemplo, usando texto em negrito para todas as transações acima de US $2.000).
- Formate as células para que a cor varie de acordo com o valor (por exemplo, aplicando um plano de fundo vermelho mais intenso à medida que o valor acima de US $2.000 aumenta).
- Formatar células de forma dinâmica com base no conteúdo de outras células (por exemplo, destacando o endereço de propriedades cujo campo "tempo no mercado" é > 90 dias).
Você pode até formatar células com base no valor delas e de outras células. Por exemplo, você pode formatar um intervalo de células com base no valor delas em comparação com o valor mediano do intervalo:
Figura 1. Formatação para destacar valores acima ou abaixo da idade média.
Neste exemplo, as células em cada linha são formatadas de acordo com a comparação do valor
na coluna age
com o valor médio de todas as idades. As linhas com idade acima da mediana têm texto vermelho, e as abaixo da mediana têm plano de fundo vermelho. Duas das linhas têm um valor de age
que corresponde à idade mediana
(48), e essas células não recebem formatação especial. Para conferir o código-fonte que
cria essa formatação condicional, consulte o exemplo abaixo.
Regras de formatação condicional
A formatação condicional é expressa usando regras de formatação. Cada planilha armazena uma lista dessas regras e as aplica na mesma ordem em que aparecem na lista. Com a API Google Sheets, você pode adicionar, atualizar e excluir essas regras de formatação.
Cada regra especifica um intervalo de destino, tipo de regra, condições para acionar a regra e qualquer formatação a ser aplicada.
Intervalo de destino: pode ser uma única célula, um intervalo de células ou vários intervalos.
Tipo de regra: há duas categorias de regras:
- As regras booleanas aplicam um formato somente se critérios específicos forem atendidos.
- As regras de gradiente calculam a cor de plano de fundo de uma célula com base no valor dela.
As condições que são avaliadas e os formatos que podem ser aplicados são diferentes para cada um desses tipos de regras, conforme detalhado nas seções a seguir.
Regras booleanas
Um BooleanRule
define se aplicar um formato específico, com base em um
BooleanCondition
que é avaliado como true
ou false
. Uma regra booleana tem a seguinte forma:
{
"condition": {
object(BooleanCondition)
},
"format": {
object(CellFormat)
},
}
A condição pode usar o
ConditionType
integrado
ou uma fórmula personalizada para avaliações mais complexas.
Os tipos integrados permitem aplicar formatação de acordo com limites numéricos,
comparação de texto ou se uma célula está preenchida. Por exemplo, NUMBER_GREATER
significa que o valor da célula precisa ser maior que o da condição. As regras são
sempre avaliadas em relação à célula de destino.
A fórmula personalizada é um tipo de condição especial que permite aplicar formatação
de acordo com uma expressão arbitrária, que também permite a avaliação de qualquer célula,
não apenas a célula de destino. A fórmula da condição precisa ser avaliada como true
.
Para definir a formatação aplicada por uma regra booleana, use um subconjunto do tipo
CellFormat
para definir:
- Indica se o texto na célula é em negrito, itálico ou tachado.
- A cor do texto na célula.
- A cor de fundo da célula.
Regras de gradiente
Um
GradientRule
define um intervalo de cores que corresponde a um intervalo de valores. Uma regra de gradiente
tem o seguinte formato:
{
"minpoint": {
object(InterpolationPoint)
},
"midpoint": {
object(InterpolationPoint)
},
"maxpoint": {
object(InterpolationPoint)
},
}
Cada
InterpolationPoint
define uma cor e o valor correspondente. Um conjunto de três pontos define um
gradiente de cores.
Gerenciar regras de formatação condicional
Para criar, modificar ou excluir regras de formatação condicional, use o método
spreadsheets.batchUpdate
com o tipo de solicitação adequado:
Adicione regras à lista no índice especificado usando o
AddConditionalFormatRuleRequest
.Substitua ou reordene regras na lista no índice fornecido usando o
UpdateConditionalFormatRuleRequest
.Remova regras da lista no índice especificado usando o
DeleteConditionalFormatRuleRequest
.
Exemplo
O exemplo a seguir mostra como criar a formatação condicional mostrada na captura de tela na parte de cima desta página. Para conferir outros exemplos, consulte a página de amostras de formatação condicional.