Thème personnalisé dans LuckyTemplates

Pour le post d'aujourd'hui, je vais passer en revue rapidement les personnalisations que vous pouvez effectuer en éditant et en appliquant directement un fichier de thème JSON. Il ne s'agit pas réellement d'une description de ce qui peut être fait dans LuckyTemplates lui-même, mais plutôt d'un exemple de ce qui peut être accompli en dehors de LuckyTemplates lorsque vous créez un thème personnalisé. Vous pouvez regarder la vidéo complète de ce tutoriel au bas de ce blog.

Cette rubrique n'est pas destinée aux consommateurs de rapports LuckyTemplates ou aux développeurs LuckyTemplates occasionnels, mais plutôt à ceux qui sont familiers et à l'aise avec la modification et la création directe de codes JSON.

Pour implémenter une thématisation personnalisée, vous devez être à l'aise avec la syntaxe et la structure des fichiers JSON ainsi qu'avec les outils de l'environnement de développement. J'utiliserai le code Visual Studio pour développer des fichiers de thème JSON.

Examinons les personnalisations disponibles qui sont déjà intégrées à l'application de bureau LuckyTemplates. Tout d'abord, nous avons besoin d'une toile pour présenter notre travail. J'ai utilisé l'ensemble de données de pratique LuckyTemplates, qui est un ensemble de données de vente simple où les visuels peuvent être facilement construits. Un fichier PBIX de démonstration est une page de rapport unique et des dimensions personnalisées de 1600 x 900 ont été utilisées pour donner un peu plus d'espace que le rapport standard de 1280 x 720.

Table des matières

• Utilisation du thème par défaut
• Un examen rapide des bases de JSON pour les thèmes personnalisés
• Changer l'arrière-plan pour un thème personnalisé
• Modification de l'arrière-plan du texte du titre
• Ajouter des ombres aux visuels
• Ajout de texte de titre
• Autres choses à retenir dans les thèmes personnalisés
• Conclusion

Utilisation du thème par défaut

Jetons un coup d'œil à notre thème par défaut ici. Si nous parcourons les thèmes et appliquons le thème par défaut…

… nous pouvons voir qu'il utilise simplement les couleurs standard bleu, orange et violet.

Et si je sélectionne le thème Texte blanc sur fond sombre …

… c'est le thème que nous verrons.

Un examen rapide des bases de JSON pour les thèmes personnalisés

Il ne s'agit certainement pas d'un examen complet de la manière de développer un fichier JSON pour LuckyTemplates, mais plutôt de quelques commentaires rapides sur les fichiers JSON.

JSON signifie JavaScript Object Notation ; il s'agit d'un format de texte clair pour les fichiers de données, composé d'objets imbriqués ou de blocs de code. Chacun d'eux a sa propre collection de paires nom-valeur.

Les deux-points sont utilisés pour séparer les paires nom-valeur. Les accolades sont utilisées pour entourer un objet. Les éléments de la liste sont séparés par des virgules et les listes peuvent être effacées. Une liste peut également être un tableau qui, dans ce cas, est entouré de crochets.

Un fichier LuckyTemplates JSON se compose généralement de trois sections principales : name , colors et visuals . La section du nom est en fait la seule section obligatoire, et comme vous pouvez le voir, c'est là que nous allons commencer notre enquête aujourd'hui.

Appliquons simplement ce fichier de thème en parcourant les thèmes.

Nous allons opter pour le thème par défaut. Vous verrez que les couleurs par défaut sont utilisées.

Passons à la section du bloc de code et copions le jeu de couleurs alternatives.

Nous pouvons coller cela dans notre fichier de thème JSON en ajoutant une virgule après le bloc de nom, puis en collant le code.

Nous allons enregistrer le fichier de thème JSON, revenir à LuckyTemplates et appliquer le thème scratch.

Maintenant, nous pouvons voir que les couleurs ont changé.

La section visuelle est de loin la plus grande, et c'est là que nous faisons le reste de notre travail. Vous pouvez facilement modifier le texte, y compris la police, la taille de la famille et la couleur.

Passons à notre bloc-notes pour copier le bloc de code pour nos classes de texte et les polices définies sur différentes tailles.

Ensuite, nous passerons à Visual Studio Code, ajouterons une colonne pour séparer les codes, puis collerons le code.

Encore une fois, nous allons enregistrer notre fichier de thème. Ensuite, nous retournerons à LuckyTemplates et appliquerons les fichiers de thème. Nous pouvons voir que tous les textes sont maintenant devenus bleus.

L'une des choses que nous pouvons facilement faire est de changer la couleur du texte. Revenons au fichier JSON, sélectionnons la couleur bleue et remplaçons-la par du rouge.

Enregistrons cela à nouveau, revenons à LuckyTemplates et importons le fichier de thème JSON une fois de plus. Maintenant, nous pouvons voir que tous les textes sont passés au rouge.

Changer l'arrière-plan pour un thème personnalisé

Regardons maintenant l'arrière-plan de la page et réglons-le sur la deuxième couleur la plus sombre de notre palette. Nous allons passer à Notepad ++, saisir notre bloc de code d'arrière-plan de page et le copier.

Et puis nous passerons à Visual Studio Code et y collerons le code.

Ensuite, accédez à LuckyTemplates et encore une fois, appliquez le thème scratch pour voir le nouvel arrière-plan.

Modification de l'arrière-plan du texte du titre

Terminons notre démo en changeant l'arrière-plan de notre texte de titre en la couleur de thème la plus sombre et la couleur du texte en blanc. Comme vous pouvez le voir, je n'ai pas compris la syntaxe appropriée pour définir le style de table et de matrice via le fichier de thème JSON. J'ai donc utilisé l'interface pour changer le style des deux visuels en none .

Revenons à Notepad ++ pour copier le bloc de code JSON pour notre arrière-plan de titre.

Et puis nous passons à Visual Studio Code pour y coller le code.

Encore une fois, nous allons enregistrer notre thème, revenir à LuckyTemplates et appliquer le thème une fois de plus.

Ajouter des ombres aux visuels

J'ai également quelques petites démos autonomes qui présentent quelques options de thème. Réinitialisons notre thème à l'option par défaut. Si nous voulons ajouter des ombres à tous nos visuels, nous pouvons utiliser la syntaxe visualStyles et dropShadow.

Si nous passons à LuckyTemplates et appliquons ce fichier de thème, vous verrez que tous nos visuels ont des ombres.

Ajout de texte de titre

Si nous voulons nous assurer que tous nos visuels ont un texte de titre, nous pouvons ajouter un texte de titre d'espace réservé à l'aide de la syntaxe visualStyles, title, show et text dans Visual Studio Code.

Si nous passons à LuckyTemplates et appliquons ce fichier de thème, nous remarquerons qu'un seul de nos visuels a changé car tous les autres sont déjà modifiés avec des titres.

Si nous devons accéder à une nouvelle page, créer un nouveau tableau et apporter les canaux et les mesures que nous voulons, nous avons le texte du titre par défaut.

Une autre chose que nous pouvons faire est d'affecter la façon dont les nouvelles images s'adaptent à leur conteneur. Si nous réinitialisons le thème par défaut et insérons une image, nous verrons qu'elle conserve son rapport d'aspect.

Si nous voulons utiliser un fichier de thème pour définir la mise à l'échelle de l'image, nous pouvons utiliser la syntaxe visualStyles, image, imageScaling et image ScalingType.

Si nous passons à LuckyTemplates et ajoutons ce thème, nous verrons que le rapport d'aspect peut maintenant être modifié pour le visuel existant.

Et si nous ajoutons de nouveaux visuels, nous pouvons voir à nouveau que la mise à l'échelle est maintenant réglée pour s'adapter.

Autres choses à retenir dans les thèmes personnalisés

Le paramètre de transparence de l'arrière-plan de la page dans le fichier JSON ne semble pas être pris en compte, j'ai donc utilisé l'interface pour définir le niveau de transparence de l'arrière-plan de la page sur 0 avant le début de la démo.

Les paramètres de style de tableau et de matrice ne semblent pas non plus être pris en compte. J'ai donc utilisé l'interface pour définir le style de table et de matrice sur aucun.

L'ordre semble être important dans les fichiers de thème JSON, donc si vous constatez qu'un paramètre particulier n'est pas pris en compte, essayez de réorganiser le paramètre qui vous intéresse plus haut ou plus tôt dans le code.

Les visuels existants peuvent ne pas répondre complètement aux fichiers de thème, surtout s'ils ont déjà appliqué des paramètres de format.

Création de thèmes, de logos d'entreprise, d'icônes et d'arrière-plans
Comment sélectionner un thème de couleurs LuckyTemplates pour vos rapports
Comment créer une palette de couleurs LuckyTemplates convaincante

Conclusion

Si vous êtes relativement néophyte dans le codage JSON, en particulier dans LuckyTemplates, veuillez prendre tous les exemples que j'ai utilisés avec un grain de sel. Je m'attends à ce que les personnes plus expérimentées et familiarisées avec le codage de thème JSON dans LuckyTemplates produisent un code bien meilleur et plus lisible.

Enfin, je voulais juste partager certaines de mes premières expériences et présenter quelques-unes des personnalisations que j'ai trouvées dans les thèmes personnalisés. Il existe une multitude de paramètres disponibles pour la thématisation LuckyTemplates JSON, et ceux qui sont prêts à investir du temps et des efforts pour rechercher les ressources en ligne disponibles peuvent développer de manière itérative des fichiers de thème utiles.

Un excellent point de départ est l'onglet Propriétés du générateur de thèmes avancé de PowerBI.tips, où vous pouvez utiliser leur interface utilisateur pour générer des fichiers de thèmes JSON pour tous les types visuels ou des types spécifiques. J'espère que vous pouvez ajouter un codage de thème JSON personnalisé à votre boîte à outils LuckyTemplates et cela peut à la fois aider à normaliser vos rapports et vous épargner du travail à l'avenir.

Greg