La formattazione condizionale ti permette di formattare le celle in modo che il loro aspetto cambi dinamicamente in base al valore che contengono o ai valori di altre celle. Esistono molte possibili applicazioni della formattazione condizionale, tra cui i seguenti utilizzi:
- Evidenzia le celle al di sopra di una determinata soglia (ad esempio, utilizzando il testo in grassetto per tutte le transazioni superiori a $2000).
- Formatta le celle in modo che il colore vari con il loro valore (ad esempio, applicando uno sfondo rosso più intenso quando aumenta l'importo di oltre 2000 $).
- Formatta dinamicamente le celle in base al contenuto di altre celle (ad esempio, evidenziando l'indirizzo delle proprietà il cui campo "time on market" è > 90 giorni).
Puoi anche formattare le celle in base al loro valore e a quelli di altre celle. Ad esempio, puoi formattare un intervallo di celle in base al loro valore rispetto al valore mediano dell'intervallo:
Figura 1. Formattazione per evidenziare i valori superiori o inferiori all'età mediana.
In questo esempio, le celle in ogni riga sono formattate in base al confronto tra il valore nella colonna age
e il valore mediano di tutte le età. Le righe con età superiore alla mediana contengono testo rosso, mentre quelle al di sotto della media hanno uno sfondo rosso. Due delle righe hanno un valore per age
che corrisponde all'età mediana (48) e queste celle non ricevono una formattazione speciale. Per il codice sorgente che crea questa formattazione condizionale, consulta l'esempio riportato di seguito.
Regole di formattazione condizionale
La formattazione condizionale viene espressa utilizzando le regole di formattazione. Ogni foglio di lavoro memorizza un elenco di queste regole e le applica nello stesso ordine in cui sono visualizzate nell'elenco. L'API Fogli Google consente di aggiungere, aggiornare ed eliminare queste regole di formattazione.
Ogni regola specifica un intervallo target, un tipo di regola, le condizioni per l'attivazione della regola e l'eventuale formattazione da applicare.
Intervallo di destinazione: può essere una singola cella, un intervallo di celle o più intervalli.
Tipo di regola: esistono due categorie di regole:
- Le regole booleane applicano un formato solo se vengono soddisfatti criteri specifici.
- Le regole della sfumatura calcolano il colore di sfondo di una cella, in base al valore della cella.
Le condizioni valutate e i formati che puoi applicare sono diversi per ciascuno di questi tipi di regole, come descritto nelle sezioni seguenti.
Regole booleane
Un BooleanRule
definisce se applicare un formato specifico, in base a un
BooleanCondition
che restituisce true
o false
. Una regola booleana assume la forma:
{
"condition": {
object(BooleanCondition)
},
"format": {
object(CellFormat)
},
}
La condizione può utilizzare l'elemento
ConditionType
integrato
oppure una formula personalizzata per valutazioni più complesse.
I tipi integrati ti consentono di applicare la formattazione in base a soglie numeriche, confronto del testo o al fatto che una cella sia compilata. Ad esempio, NUMBER_GREATER
significa che il valore della cella deve essere maggiore del valore della condizione. Le regole vengono sempre valutate
in base alla cella di destinazione.
La formula personalizzata è un tipo di condizione speciale che consente di applicare la formattazione
in base a un'espressione arbitraria, il che consente anche la valutazione di qualsiasi cella,
non solo della cella di destinazione. La formula della condizione deve restituire true
.
Per definire la formattazione applicata da una regola booleana, utilizza un sottoinsieme del tipo CellFormat
per definire:
- Indica se il testo nella cella è in grassetto, corsivo o barrato.
- Il colore del testo nella cella.
- Il colore di sfondo della cella.
Regole del gradiente
GradientRule
definisce un intervallo di colori che corrisponde a un intervallo di valori. Una regola gradiente
assume il seguente formato:
{
"minpoint": {
object(InterpolationPoint)
},
"midpoint": {
object(InterpolationPoint)
},
"maxpoint": {
object(InterpolationPoint)
},
}
Ogni elemento
InterpolationPoint
definisce un colore e il valore corrispondente. Un insieme di tre punti definisce
un gradiente di colore.
Gestire le regole di formattazione condizionale
Per creare, modificare o eliminare le regole di formattazione condizionale, utilizza il metodo spreadsheets.batchUpdate
con il tipo di richiesta appropriato:
Aggiungi regole all'elenco nell'indice specificato utilizzando
AddConditionalFormatRuleRequest
.Sostituisci o riordina le regole nell'elenco nell'indice specificato utilizzando
UpdateConditionalFormatRuleRequest
.Rimuovi le regole dall'elenco nell'indice specificato utilizzando
DeleteConditionalFormatRuleRequest
.
Esempio
L'esempio seguente mostra come creare la formattazione condizionale mostrata nello screenshot nella parte superiore di questa pagina. Per ulteriori esempi, consulta la pagina di esempi della formattazione condizionale.