El formato condicional te permite formatear celdas para que su apariencia cambie de forma dinámica según el valor que contengan o los valores de otras celdas. Existen muchas aplicaciones posibles para el formato condicional, incluidos los siguientes usos:
- Destacar las celdas que superen un límite determinado (por ejemplo, usar texto en negrita para todas las transacciones superiores a USD 2,000)
- Aplica formato a las celdas para que su color varíe según su valor (por ejemplo, aplica un fondo rojo más intenso a medida que aumenta el importe superior a USD 2,000).
- Aplicar formato de forma dinámica a las celdas según el contenido de otras celdas (por ejemplo, destacar 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 el de otras celdas. Por ejemplo, puedes formatear un rango de celdas según su valor en comparación con la mediana del rango:
Figura 1: Formato para destacar valores por encima o por debajo de la edad mediana
En este ejemplo, las celdas de cada fila tienen un formato que depende del valor de su columna age en comparación con la mediana de todas las edades. En las filas con edades superiores a la mediana, el texto es rojo; en las filas con edades inferiores a la mediana, el fondo es rojo. En dos filas, el valor de age coincide con la mediana (48) y estas celdas no reciben ningún formato especial. Para obtener el código fuente que genera este formato condicional, consulta el Ejemplo que aparece a continuación.
Reglas de formato condicional
El formato condicional se expresa con 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 el rango de destino, el tipo de regla, las condiciones que activarán la regla y el formato que se aplicará.
Rango de destino: Puede ser una sola celda, un rango de celdas o varios rangos.
Tipo de regla: Existen dos categorías de reglas:
- Las reglas booleanas aplican un formato solo si se cumplen criterios específicos.
- Las reglas de degradado calculan el color de fondo de una celda según su valor.
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 aplica un formato específico, según un BooleanCondition que se evalúa como true o false. Una regla booleana tiene el siguiente aspecto:
{
"condition": {
object(BooleanCondition)
},
"format": {
object(CellFormat)
},
}
La condición puede usar la función ConditionType integrada o una fórmula personalizada para evaluaciones más complejas.
Los tipos incorporados te permiten aplicar formatos de acuerdo con umbrales numéricos, comparaciones de texto o la existencia de contenido 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 formatos según una expresión arbitraria, que también permite la evaluación de cualquier celda, no solo de la celda de destino. La fórmula de la condición debe evaluarse como true.
Para definir el formato de una regla booleana, se utiliza un subconjunto del tipo CellFormat con el objetivo de definir lo siguiente:
- Si el texto de la celda está en negrita, cursiva o tachado.
- Es el color del texto en la celda.
- Es el color de fondo de la celda.
Reglas de degradado
Un GradientRule define un rango de colores que corresponde a un rango de valores. Una regla de gradiente tiene el siguiente formato:
{
"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.
Administra las 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 reglas en 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 aparece en la captura de pantalla en la parte superior de esta página. Para ver otros ejemplos, consulta la página de muestras de Formato condicional.