La mise en forme conditionnelle vous permet de mettre en forme des cellules afin 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, par exemple:
- Mettre en surbrillance les cellules dont la valeur dépasse un certain seuil (par exemple, en utilisant du texte en gras pour toutes les transactions supérieures à 2 000 $)
- Mettez en forme les cellules afin 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 $).
- Mettez en forme de manière dynamique les cellules en fonction du contenu d'autres cellules (par exemple, en mettant en évidence 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 celle 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 évidence 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 la colonne age à la valeur médiane de tous les âges. Les lignes dont l'âge est supérieur à la médiane sont en 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 obtenir 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 s'exprime à l'aide de règles de mise en forme. Chaque feuille de calcul stocke une liste de ces règles et les applique dans l'ordre 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, le type de règle, les conditions de déclenchement de la règle et la 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 détaillé dans les sections suivantes.
Règles booléennes
Un BooleanRule définit si un format spécifique doit être appliqué, en fonction d'un BooleanCondition qui renvoie true ou false. Une règle booléenne se présente sous la forme suivante:
{
"condition": {
object(BooleanCondition)
},
"format": {
object(CellFormat)
},
}
La condition peut utiliser la fonction intégrée ConditionType 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, de comparaisons de texte ou de la présence d'une valeur dans une cellule. Par exemple, NUMBER_GREATER signifie que la valeur de la cellule doit être supérieure à celle de la condition. Les règles sont toujours évaluées par rapport à la cellule cible.
La 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 renvoyer la valeur true.
Pour définir la mise en forme appliquée par une règle booléenne, vous utilisez un sous-ensemble du type CellFormat pour définir:
- Indique si le texte de la cellule est en gras, en italique ou barré.
- Couleur du texte dans la cellule.
- Couleur d'arrière-plan de la cellule.
Règles de dégradé
Un GradientRule définit une plage de couleurs correspondant à une plage de valeurs. Une règle de dégradé se présente sous la forme suivante:
{
"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 couleur.
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 méthode spreadsheets.batchUpdate 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 d'exemples de mise en forme conditionnelle.