El formato condicional te permite dar formato a las celdas para que su apariencia cambie de manera dinámica según el valor que contengan o los valores de otras celdas. El formato condicional se puede usar de muchas formas, por ejemplo:
- Resalta celdas por encima de un umbral determinado (por ejemplo, usa negrita para todas las transacciones superiores a $2,000).
- Aplica formato a las celdas de modo que el color varíe según el valor (por ejemplo, aplica un fondo rojo más intenso a medida que aumente la cantidad superior a USD 2,000).
- Da formato dinámico a las celdas según el contenido de otras celdas (por ejemplo, destaca la dirección de las propiedades cuyo campo "tiempo en el mercado" es superior a 90 días).
Incluso puedes formatear celdas según su valor y los de otras celdas. Por ejemplo, podrías dar formato a un rango de celdas según su valor en comparación con la mediana del rango:
Figura 1. Formatear para destacar valores superiores o inferiores a la edad mediana
En este ejemplo, las celdas de cada fila tienen un formato que depende de cómo se compara el valor de su columna age
con la mediana de todas las edades. Las filas cuya antigüedad está por encima de la mediana tienen texto rojo y las que están por debajo de la mediana tienen un fondo rojo. Dos de las filas tienen un valor para age
que coincide con la mediana de edad (48) y estas celdas no reciben un formato especial. (Para obtener el código fuente que crea este formato condicional, consulta el ejemplo más abajo).
Reglas de formato condicional
El formato condicional se expresa mediante reglas de formato. Cada hoja de cálculo almacena una lista de estas reglas y las aplica en el mismo orden en que aparecen en la lista. La API de Hojas de cálculo de Google te permite agregar, actualizar y borrar estas reglas de formato.
Cada regla especifica un rango de destino, el tipo de regla, las condiciones para activar la regla y cualquier formato que se aplique.
Rango de destino: Puede ser una sola celda, un rango de celdas o varios rangos.
Tipo de regla: Hay dos categorías de reglas:
- Las reglas booleanas aplican un formato solo si se cumplen criterios específicos.
- Las reglas de gradiente calculan el color de fondo de una celda en función del valor de la celda.
Las condiciones que se evalúan y los formatos que puedes aplicar son diferentes para cada uno de estos tipos de reglas, como se detalla en las siguientes secciones.
Reglas booleanas
Un BooleanRule
define si se debe aplicar un formato específico, según un BooleanCondition
que se evalúa como true
o false
. Una regla booleana tiene la siguiente forma:
{
"condition": {
object(BooleanCondition)
},
"format": {
object(CellFormat)
},
}
La condición puede usar el ConditionType
integrado o puede usar una fórmula personalizada para evaluaciones más complejas.
Los tipos integrados te permiten aplicar formatos de acuerdo con umbrales numéricos, comparaciones de texto o si se propagan datos en una celda. Por ejemplo, NUMBER_GREATER
significa que el valor de la celda debe ser mayor que el valor de la condición. Las reglas siempre se evalúan en función de la celda de destino.
La fórmula personalizada es un tipo de condición especial que te permite aplicar formato de acuerdo con una expresión arbitraria, la cual también permite la evaluación de cualquier celda, no solo de la de destino. La fórmula de la condición debe evaluarse como true
.
Para definir el formato que aplica una regla booleana, usa un subconjunto del tipo CellFormat
para definir lo siguiente:
- Indica si el texto de la celda está en negrita, cursiva o tachado.
- El color del texto de la celda.
- El color de fondo de la celda.
Reglas de gradientes
Un objeto GradientRule
define un rango de colores que corresponden a un rango de valores. Una regla de gradientes
tiene la siguiente forma:
{
"minpoint": {
object(InterpolationPoint)
},
"midpoint": {
object(InterpolationPoint)
},
"maxpoint": {
object(InterpolationPoint)
},
}
Cada InterpolationPoint
define un color y su valor correspondiente. Un conjunto de tres puntos define un gradiente de color.
Administrar reglas de formato condicional
Para crear, modificar o borrar reglas de formato condicional, usa el método spreadsheets.batchUpdate
con el tipo de solicitud adecuado:
Agrega reglas a la lista en el índice determinado con
AddConditionalFormatRuleRequest
.Reemplaza o reordena las reglas de la lista en el índice determinado con
UpdateConditionalFormatRuleRequest
.Quita reglas de la lista en el índice determinado con
DeleteConditionalFormatRuleRequest
.
Ejemplo
En el siguiente ejemplo, se muestra cómo crear el formato condicional que se muestra en la captura de pantalla de la parte superior de esta página. Para ver otros ejemplos, consulta la página de muestras de formato condicional.