Créer un thème Power BI personnalisé : le fichier JSON expliqué
Un rapport aux couleurs de votre entreprise commence par un thème Power BI. Le thème s'applique à tous les visuels du rapport, d'un seul coup.
L'interface graphique suffit pour les couleurs de base. Pour tout le reste, il faut passer par le fichier JSON.
Un thème Power BI en cinq lignes de JSON
Le fichier de thème est un simple fichier texte. Une seule propriété est obligatoire : name.
Voici un thème minimal. Il ne définit qu'un nom et une palette.
{
"name": "Charte Société",
"dataColors": ["#1B3A57", "#E8730C", "#5B8DB8", "#F2A65A", "#8FA9BF"]
}Importez ce fichier dans Power BI Desktop. Le résultat est immédiat sur chaque visuel.
Élément du thème | Valeur | Ce qui change dans le rapport |
name | Charte Société | Le nom affiché dans la liste des thèmes |
dataColors, 1re couleur | La première série de chaque visuel | |
dataColors, 2e couleur | La deuxième série de chaque visuel | |
dataColors, 3e à 5e | Les séries suivantes, dans l'ordre |
Un histogramme sans légende devient bleu nuit. Ajoutez une légende à deux valeurs.
La première barre reste bleu nuit. La seconde passe en orange.
Tout ce que le fichier ne précise pas garde la valeur par défaut de Power BI.
Appliquer, exporter et modifier un thème
Un rapport empile trois couches de mise en forme. Le thème de base de Microsoft sert de socle.
Le thème personnalisé se pose par-dessus. La mise en forme manuelle d'un visuel passe en dernier.
Cette hiérarchie explique la plupart des surprises. Un visuel réglé à la main ignore le thème.
Importer un fichier de thème
Ouvrez le ruban Affichage. Déroulez Thèmes. Choisissez Rechercher des thèmes. Sélectionnez votre fichier JSON.
Power BI valide le fichier avant de l'appliquer. Un champ inconnu déclenche un message d'erreur détaillé.
La partie basse de ce menu n'existe que dans Power BI Desktop. Dans le service, vous ne voyez que les thèmes intégrés et ceux de l'organisation.
Exporter le thème d'un rapport existant
Le plus rapide est de partir d'un thème déjà en place. Déroulez Thèmes puis Personnaliser le thème actuel.
Réglez les couleurs et les polices dans la boîte de dialogue. Cliquez ensuite sur Enregistrer le thème actuel.
Vous obtenez un fichier JSON complet. Ouvrez-le dans un éditeur de texte pour aller plus loin.
Les quatre composants du fichier de thème
Un fichier de thème complet compte quatre blocs. Chacun couvre une zone précise du rapport.
Couleurs de données et couleurs structurelles
Les couleurs de données habillent les formes qui portent la donnée. La liste accepte autant de couleurs que vous voulez.
Quand la liste est épuisée, Power BI génère des nuances supplémentaires.
Propriété | Rôle |
dataColors | Couleur des séries dans tous les visuels |
good, neutral, bad | Couleurs d'état du visuel KPI et du graphique en cascade |
maximum, center, minimum, null | Dégradés proposés en mise en forme conditionnelle |
Les couleurs structurelles habillent tout le reste. Leurs noms sont peu parlants.
Le tableau suivant traduit les sept principales.
Propriété | Ce qu'elle colore |
firstLevelElements | Zones de texte, valeurs de tableau, étiquettes de carte |
secondLevelElements | Étiquettes d'axe et de légende, en-têtes de tableau |
thirdLevelElements | Quadrillage des axes, grille des tableaux |
fourthLevelElements | Légende estompée, étiquettes de catégorie des cartes |
background | Fond des visuels et des info-bulles modernes |
secondaryBackground | Contour de grille, remplissage des boutons désactivés |
tableAccent | Contour de la grille des tableaux et des matrices |
Classes de texte et styles visuels
Douze classes de texte existent. Quatre suffisent. Les huit autres en héritent automatiquement.
Classe JSON | Ce qu'elle met en forme | Valeur par défaut |
callout | Étiquette de données des cartes et des KPI | DIN 45 pt |
title | Titres d'axes, en-tête de segment | DIN 12 pt |
header | En-têtes des influenceurs clés | Segoe UI Semibold 12 pt |
label | Valeurs et en-têtes de tableau | Segoe UI 10 pt |
Réglez label sur 12 points. Les totaux en gras suivent, sans une ligne de plus.
Le bloc visualStyles règle ensuite chaque type de visuel. Sa structure compte quatre niveaux.
Structure de visualStyles
visualName : le type de visuel, ou * pour tous les visuels.
stylePresetName : * pour le style par défaut, ou un nom de présélection.
cardName : la section du volet de mise en forme visée.
propertyName : la propriété à régler, et sa valeur.
Le nom affiché dans le volet Format ne correspond pas toujours au nom attendu dans le JSON.
Le schéma officiel reste la seule référence fiable.
Un thème d'entreprise complet, prêt à copier
Voici un thème cohérent et directement utilisable. Remplacez les codes hexadécimaux par ceux de votre charte.
{
"name": "Charte Entreprise",
"dataColors": ["#1B3A57", "#E8730C", "#5B8DB8", "#F2A65A", "#3E6C8E", "#C25A08", "#8FA9BF", "#F7C89A"],
"good": "#3CAC22",
"neutral": "#D9B300",
"bad": "#D64550",
"maximum": "#1B3A57",
"center": "#8FA9BF",
"minimum": "#EAF0F5",
"null": "#B3B0AD",
"firstLevelElements": "#1B3A57",
"secondLevelElements": "#5A6C7A",
"thirdLevelElements": "#E6EAEE",
"fourthLevelElements": "#B3BCC4",
"background": "#FFFFFF",
"secondaryBackground": "#F4F6F8",
"tableAccent": "#E8730C",
"textClasses": {
"callout": { "fontSize": 40, "fontFace": "Segoe UI", "color": "#1B3A57" },
"title": { "fontSize": 12, "fontFace": "Segoe UI", "color": "#1B3A57" },
"header": { "fontSize": 12, "fontFace": "Segoe UI Semibold", "color": "#1B3A57" },
"label": { "fontSize": 10, "fontFace": "Segoe UI", "color": "#1B3A57" }
},
"visualStyles": {
"*": {
"*": {
"*": [{ "wordWrap": true }],
"background": [{ "show": true, "color": { "solid": { "color": "#FFFFFF" } }, "transparency": 0 }],
"border": [{ "show": true, "color": { "solid": { "color": "#E6EAEE" } }, "radius": 6 }],
"categoryAxis": [{ "gridlineStyle": "dotted" }]
}
}
}
}Enregistrez ce texte dans un fichier nommé charte-entreprise.json. Importez-le par Affichage puis Rechercher des thèmes.
Bon à savoir
Microsoft publie le schéma de validation des thèmes sur GitHub. Placez reportThemeSchema.json à côté de votre fichier. Ajoutez la ligne $schema en tête. Visual Studio Code complète alors les propriétés valides.
Les présélections de style, disponibles depuis mars 2025
Les présélections de style sont arrivées avec la mise à jour de mars 2025.
Elles définissent plusieurs styles pour un même type de visuel. Vous basculez de l'un à l'autre en un clic.
{
"name": "Charte Entreprise",
"visualStyles": {
"columnChart": {
"*": {
"stylePreset": [{ "name": "Compact" }]
},
"Compact": {
"legend": [{ "position": "BottomCenter" }]
},
"Complet": {
"legend": [{ "position": "Right" }],
"valueAxis": [{ "gridlineStyle": "dotted" }]
}
}
}
}La ligne stylePreset désigne la présélection appliquée par défaut. Les autres restent disponibles dans une liste déroulante.
Cette liste apparaît dans le volet Visualisations, section Format visuel.
Une présélection ne vaut que pour le visuel où elle est définie. Un histogramme ne verra jamais celle d'une carte.
Si la définition disparaît du thème, Power BI affiche une erreur. Seul l'auteur du rapport la voit.
Les pièges qui font échouer un thème
L'ordre des séries décide des couleurs
Power BI attribue les couleurs dans l'ordre d'apparition de la série. Ce n'est pas la valeur qui décide, c'est la position.
Un visuel affiche Nord puis Sud. Un autre affiche Est puis Nord.
Visuel | 1re série | 2e série | Couleur de Nord |
Visuel A | Nord | Sud | 1re couleur du thème |
Visuel B | Est | Nord | 2e couleur du thème |
Nord change donc de couleur d'un visuel à l'autre. La correction se fait visuel par visuel, dans le volet de mise en forme.
Aucun thème ne règle ce point à votre place.
« Rétablir la valeur par défaut » efface plus que le format
Ce bouton remet un visuel au style du thème. Il supprime aussi d'autres réglages.
les actions portées par les boutons et les images,
les règles de mise en forme conditionnelle,
les images issues d'une URL ou d'un champ,
les étiquettes de référence.
Utilisez-le sur un visuel simple. Évitez-le sur un bouton de navigation.
Les autres pièges reviennent souvent en formation.
Piège | Conséquence | Ce qu'il faut faire |
Un champ inconnu dans le JSON | L'import échoue | Valider le fichier avec le schéma officiel |
Mise en forme conditionnelle dans le thème | Impossible | L'appliquer visuel par visuel, après le thème |
Thème de base ancien | Styles figés sur une version passée | Suivre la bannière « Mettre à jour le thème » |
Thème intégré Classique ou Contraste élevé | Onglet Texte inaccessible | Exporter, repasser au thème par défaut, réimporter |
Thème sombre incomplet | Étiquettes illisibles | Définir aussi couleurs structurelles et classes de texte |
Questions fréquentes sur les thèmes Power BI
Peut-on imposer un thème à toute l'entreprise ?
Oui. L'administrateur du locataire publie des thèmes d'organisation.
Ils apparaissent alors dans la liste déroulante Thèmes de chaque créateur de rapport.
Les thèmes se pilotent aussi par programmation. Les notebooks Microsoft Fabric et la bibliothèque Semantic Link Labs appliquent un thème à plusieurs rapports.
Peut-on renvoyer une couleur du thème depuis une mesure DAX ?
Oui. Utilisez la mise en forme conditionnelle par valeur de champ.
Votre mesure renvoie le nom de la couleur, pas un code hexadécimal.
Couleur statut =
VAR Score = [Score qualité]
RETURN
SWITCH (
TRUE (),
Score >= 80, "good",
Score >= 50, "neutral",
"bad"
)Le rendu suit alors le thème. Changez de thème, les couleurs suivent.
Le détail de cette syntaxe figure dans notre article sur la fonction SWITCH.
La documentation Microsoft détaille chaque propriété disponible dans le guide officiel des thèmes personnalisés.
Un thème bien construit se rédige une fois. Il sert ensuite à tous les rapports de l'entreprise.
