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 dans de nombreuses applications, par exemple:
- Mettez en surbrillance les cellules situées au-dessus d'un certain seuil (par exemple, en utilisant du texte en gras pour toutes les transactions supérieures à 2 000 $).
- Mettez 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 lorsque le montant supérieur à 2 000 $augmente).
- Mettez 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 "Time on Market" 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 permettant de 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 valeur de la colonne age par rapport à la valeur médiane de tous les âges. Les lignes dont l'âge est supérieur à la médiane affichent le texte en rouge, tandis que celles qui sont inférieures à la médiane affichent 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 pas de mise en forme spéciale. (Pour connaître 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 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, 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 appliquent un format uniquement si des critères spécifiques sont remplis.
- Les règles de gradient 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 élément BooleanRule détermine si un format spécifique doit être appliqué en fonction d'un élément BooleanCondition dont le résultat est 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 ConditionType intégrée 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 la comparaison de texte ou du remplissage d'une cellule. 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.
Custom formula (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. Cela permet également l'évaluation de n'importe quelle cellule, et pas seulement de 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, utilisez un sous-ensemble du type CellFormat:
- 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 du dégradé
Un GradientRule définit une plage de couleurs correspondant à une plage de valeurs. Une règle de dégradé prend la forme:
{
"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 au niveau de l'index donné à l'aide de la méthode
AddConditionalFormatRuleRequest.Remplacez ou réorganisez les règles dans la liste au niveau de l'index donné à l'aide de la méthode
UpdateConditionalFormatRuleRequest.Supprimez les règles de la liste au niveau de l'index donné à l'aide de la méthode
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 des exemples supplémentaires, consultez la page d'exemples de mise en forme conditionnelle.