La mise en forme conditionnelle vous permet de mettre en forme des cellules de sorte que leur apparence change de manière dynamique en fonction de la valeur qu'elles contiennent ou des valeurs d'autres cellules. La mise en forme conditionnelle peut être utilisée de nombreuses façons, y compris les suivantes :
- Mettre en surbrillance les cellules au-dessus d'un certain seuil (par exemple, en utilisant du texte en gras pour toutes les transactions supérieures à 2 000 $).
- Mettre en forme les cellules de sorte que leur couleur varie en fonction de leur valeur (par exemple, en appliquant un arrière-plan rouge plus intense à mesure que le montant dépasse 2 000 $).
- Mettre en forme les cellules de manière dynamique en fonction du contenu d'autres cellules (par exemple, en mettant en surbrillance l'adresse des propriétés dont le champ "Temps sur le marché" est supérieur à 90 jours).
Vous pouvez même mettre en forme des cellules en fonction de leur valeur et de celles d'autres cellules. Par exemple, vous pouvez mettre en forme une plage de cellules en fonction de leur valeur par rapport à la valeur médiane de la plage :
Figure 1. Mise en forme pour mettre en surbrillance les valeurs supérieures ou inférieures à l'âge médian.
Dans cet exemple, les cellules de chaque ligne sont mises en forme en fonction de la comparaison de la valeur de leur colonne age avec la valeur médiane de tous les âges. Les lignes dont l'âge est supérieur à la médiane ont un texte rouge, et celles dont l'âge est inférieur à la médiane ont un arrière-plan rouge. Deux des lignes ont une valeur pour age qui correspond à l'âge médian (48), et ces cellules ne reçoivent aucune mise en forme spéciale. (Pour le code source qui
crée cette mise en forme conditionnelle, consultez l'exemple ci-dessous.)
Règles de mise en forme conditionnelle
La mise en forme conditionnelle est exprimée à l'aide de règles de mise en forme. Chaque feuille de calcul stocke une liste de ces règles et les applique dans le même ordre que celui dans lequel elles apparaissent dans la liste. L'API Google Sheets vous permet d'ajouter, de mettre à jour et de supprimer ces règles de mise en forme.
Chaque règle spécifie une plage cible, un type de règle, des conditions de déclenchement de la règle et toute mise en forme à appliquer.
Plage cible : il peut s'agir d'une seule cellule, d'une plage de cellules ou de plusieurs plages.
Type de règle : il existe deux catégories de règles :
- Les règles booléennes n'appliquent un format que si des critères spécifiques sont remplis.
- Les règles de dégradé calculent la couleur d'arrière-plan d'une cellule, en fonction de sa valeur.
Les conditions évaluées et les formats que vous pouvez appliquer sont différents pour chacun de ces types de règles, comme indiqué dans les sections suivantes.
Règles booléennes
A
BooleanRule
définit s'il faut appliquer un format spécifique, en fonction d'une
BooleanCondition
qui prend la valeur true ou false. Une règle booléenne se présente comme suit :
{
"condition": {
object(BooleanCondition)
},
"format": {
object(CellFormat)
},
}
La condition peut utiliser le
ConditionType,
intégré ou une formule personnalisée pour des évaluations plus complexes.
Les types intégrés vous permettent d'appliquer une mise en forme en fonction de seuils numériques, d'une comparaison de texte ou du fait qu'une cellule est renseignée. Par exemple, NUMBER_GREATER signifie que la valeur de la cellule doit être supérieure à la valeur de la condition. Les règles sont toujours évaluées par rapport à la cellule cible.
Une formule personnalisée est un type de condition spécial qui vous permet d'appliquer une mise en forme en fonction d'une expression arbitraire, ce qui permet également d'évaluer n'importe quelle cellule, et pas seulement la cellule cible. La formule de la condition doit prendre la valeur true.
Pour définir la mise en forme appliquée par une règle booléenne, vous utilisez un sous-ensemble du
CellFormat
type pour définir les éléments suivants :
- Si le texte de la cellule est en gras, en italique ou barré.
- La couleur du texte dans la cellule.
- La couleur d'arrière-plan de la cellule.
Règles de dégradé
A
GradientRule
définit une plage de couleurs qui correspond à une plage de valeurs. Une règle de dégradé se présente comme suit :
{
"minpoint": {
object(InterpolationPoint)
},
"midpoint": {
object(InterpolationPoint)
},
"maxpoint": {
object(InterpolationPoint)
},
}
Chaque
InterpolationPoint
définit une couleur et sa valeur correspondante. Un ensemble de trois points définit un dégradé de couleurs.
Gérer les règles de mise en forme conditionnelle
Pour créer, modifier ou supprimer des règles de mise en forme conditionnelle, utilisez la
spreadsheets.batchUpdate
méthode avec le type de requête approprié :
Ajoutez des règles à la liste à l'index donné à l'aide de
AddConditionalFormatRuleRequest.Remplacez ou réorganisez les règles de la liste à l'index donné à l'aide de
UpdateConditionalFormatRuleRequest.Supprimez des règles de la liste à l'index donné à l'aide de
DeleteConditionalFormatRuleRequest.
Exemple
L'exemple suivant montre comment créer la mise en forme conditionnelle illustrée dans la capture d'écran en haut de cette page. Pour obtenir d'autres exemples, consultez la page Exemples de mise en forme conditionnelle.