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 para valores em outras células. Existem muitas aplicações possíveis de formatação condicional, incluindo estas:
- Destaque as 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 delas varie de acordo com o valor. Por exemplo, aplicar um fundo vermelho mais intenso à medida que o valor acima de US $2.000 aumenta.
- Formate dinamicamente as células com base no conteúdo de outras células. Por exemplo, destacar o endereço de propriedades em que o campo "tempo no mercado" é maior que 90 dias.
Você pode até mesmo formatar células com base nos seus valores e no de outras células. Por exemplo, é possível formatar um intervalo de células com base no valor delas em comparação com o valor médio 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 forma como o valor na coluna age
se compara ao valor médio de todas as idades. Linhas com idade acima da mediana têm texto em vermelho e as abaixo da mediana têm um plano de fundo vermelho. Duas das linhas têm um valor para age
que corresponde à idade média (48) e essas células não recebem formatação especial. Para 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, um tipo de regra, as 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 só aplicam um formato se critérios específicos forem atendidos.
- As regras de gradiente calculam a cor de fundo de uma célula com base no valor dela.
As condições avaliadas e os formatos que podem ser aplicados são diferentes para cada um desses tipos de regra, conforme detalhado nas seções a seguir.
Regras booleanas
Um BooleanRule
define se é necessário aplicar um formato específico, com base em uma
BooleanCondition
que é avaliada como true
ou false
. Uma regra booleana tem a forma:
{
"condition": {
object(BooleanCondition)
},
"format": {
object(CellFormat)
},
}
A condição pode usar a
ConditionType
integrada ou uma fórmula personalizada para avaliações mais complexas.
Os tipos integrados permitem aplicar a 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 valor da condição. As regras sempre são 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, o que também permite a avaliação de qualquer célula, não apenas da 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:
- Se o texto na célula está 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 a forma:
{
"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 cor.
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 apropriado:
Adicione regras à lista no índice especificado usando
AddConditionalFormatRuleRequest
.Substitua ou reordene as regras na lista no índice especificado usando
UpdateConditionalFormatRuleRequest
.Remova regras da lista no índice especificado usando
DeleteConditionalFormatRuleRequest
.
Exemplo
O exemplo a seguir mostra como criar a formatação condicional mostrada na captura de tela no topo desta página. Para mais exemplos, consulte a página de exemplos de formatação condicional.