PanoramaNiveau · Débutant~15 min de lecture

Apache ECharts

Les plus beaux graphiques du web, prêts à adapter.

Matplotlib dessine des images et Plotly des pages interactives, depuis Python. Apache ECharts vient directement du web : une bibliothèque JavaScript pensée pour les sites et les tableaux de bord. Ce guide ne contient aucun code : il parcourt une sélection de 161 exemples de la galerie officielle, à ouvrir et à modifier en un clic.

À la fin de ce guide, tu sauras :

  • Situer ECharts face à Matplotlib et Plotly
  • Nommer les composants d’une option ECharts
  • Associer un besoin à une famille de graphiques
  • Ouvrir et adapter un exemple de la galerie
Tags
  • JavaScript
  • Sans code
À lire avant
JSON
Publié
Tableau de bord ouvert dans un navigateur : aires empilées en dégradé avec infobulle et curseur de zoom, jauge de progression à 68 % et calendrier d’activité sur plusieurs mois

1. Qu’est-ce qu’Apache ECharts ?

Apache ECharts est une bibliothèque libre et gratuite pour le langage JavaScript. Née chez Baidu en 2013, elle est confiée à la fondation Apache en 2018 et en devient un projet de premier plan en 2021. La version 6, parue en 2025, ajoute notamment les matrices et les diagrammes de cordes.

Elle dessine directement dans la page web :

  • Choisir le rendu Canvas pour les gros volumes, ou SVG pour la netteté
  • Animer l’entrée des données et chaque mise à jour
  • Adapter le graphique à l’écran, du téléphone au grand moniteur
  • Décrire automatiquement le graphique aux lecteurs d’écran
L’idée centrale

Avec ECharts, on ne dessine pas : on décrit. Un seul objet de configuration, appelé option, liste les composants voulus. La bibliothèque s’occupe du tracé, des animations et des interactions.

Depuis Python : la bibliothèque pyecharts écrit cette option à ta place et produit une page HTML. C’est une passerelle pratique après les guides Matplotlib et Plotly.

2. L’anatomie d’une option

Chaque partie visible d’un graphique ECharts correspond à une clé de l’option. Connaître leurs noms aide à lire les exemples de la galerie et à les adapter.

Schéma d’un graphique ECharts : titre, légende, boîte à outils, infobulle, grille et axes, séries, correspondance visuelle et zoom sur les donnéesVentes et margeVentesMarge3002001000janfévmaravrmaimarsVentes 245élevéfaible12345678
  1. Titre (title) : le message principal du graphique
  2. Légende (legend) : un clic masque ou affiche une série
  3. Boîte à outils (toolbox) : enregistrer l’image, zoomer, changer de type
  4. Infobulle (tooltip) : les valeurs exactes au survol
  5. Grille et axes (grid, xAxis, yAxis) : la zone de tracé et ses graduations
  6. Séries (series) : les données et leur type, ici des barres et une courbe
  7. Correspondance visuelle (visualMap) : la couleur qui suit la valeur
  8. Zoom sur les données (dataZoom) : une fenêtre à glisser pour choisir la plage

Sous le capot : l’option est un simple objet JavaScript, proche du JSON. Le composant dataset permet d’y ranger les données à part, pour les partager entre plusieurs séries ou plusieurs graphiques.

3. Graphiques classiques et évolutions

Dans la galerie : Line · Bar · Pie

Les graphiques du quotidien, soignés jusqu’au détail : dégradés, angles arrondis, animation d’entrée et transition fluide quand les données changent.

Lire la sélection

Chaque carte correspond à un type de série, dont le nom figure en bas. Le lien « exemples à ouvrir » mène à la section de ce type, sous la galerie, et l’affiche. Chaque section se masque ou s’affiche d’un clic. Chaque exemple ouvre l’éditeur en ligne, avec le code modifiable à gauche et le graphique à droite. Il s’agit d’un choix éditorial, et non d’un classement officiel. Les vignettes proviennent de la galerie Apache ECharts, sous licence Apache 2.0 (nouvel onglet).

Courbes12 exemples
Barres et colonnes12 exemples
Secteurs et anneaux10 exemples

Camembert, avec prudence : l’œil compare mal les angles. Au-delà de quatre ou cinq parts, ou quand elles sont proches, des barres sont plus lisibles.

4. Exploration des données et géographie

Dans la galerie : Scatter · Heatmap · Calendar · Map · Lines

Pour faire parler beaucoup de points, des grilles de valeurs, des dates ou des lieux. ECharts reste fluide avec des centaines de milliers de points.

Nuages de points et bulles10 exemples
Cartes de chaleur5 exemples
Calendriers5 exemples
Cartographie7 exemples
Trajets et connexions4 exemples

Bon à savoir : ECharts ne fournit plus de fonds de carte. On charge le fichier GeoJSON ou SVG de son choix, ce qui permet aussi de cartographier un plan de salle ou un bâtiment.

5. Hiérarchies, réseaux et flux

Dans la galerie : Graph · Tree · Treemap · Sunburst · Sankey · Chord

Pour montrer comment des éléments s’emboîtent, se relient ou se transmettent une quantité.

Graphes de relations6 exemples
Arbres hiérarchiques5 exemples
Cartes de rectangles5 exemples
Hiérarchies circulaires5 exemples
Flux de données5 exemples
Diagrammes de cordes4 exemples

6. Indicateurs et analyses spécialisées

Dans la galerie : Radar · Gauge · Funnel · Candlestick · Boxplot · Parallel · ThemeRiver · Matrix

Des formats dédiés à une question précise : comparer des profils, suivre un objectif, analyser une conversion, un cours de bourse ou une distribution.

Radars4 exemples
Jauges et progression8 exemples
Entonnoirs4 exemples
Chandeliers financiers4 exemples
Boîtes statistiques3 exemples
Coordonnées parallèles3 exemples
Rivières thématiques2 exemples
Matrices7 exemples

7. Créativité et visualisations avancées

Dans la galerie : PictorialBar · Custom · ECharts GL · Dataset · Graphic

Quand les types prêts à l’emploi ne suffisent plus : symboles illustrés, séries entièrement dessinées, scènes 3D et graphiques reliés entre eux.

Barres illustrées7 exemples
Graphiques personnalisés8 exemples
Visualisations 3D9 exemples
Données, animations et interactions7 exemples

Bon à savoir : les exemples 3D demandent l’extension ECharts GL et un navigateur compatible WebGL. Ils impressionnent, mais restent plus lourds à charger et moins lisibles sur mobile.

8. Huit coups de cœur pour le web

Pour composer des sites et des tableaux de bord avec des graphiques réutilisables, ces huit exemples sont de bons points de départ. Le nom de chaque carte ouvre l’exemple.

Le point important

Les graphiques spectaculaires ne sont pas toujours les plus utiles. Sur un site professionnel, un format sobre, une micro-interaction ou une animation qui explique les données servent mieux le lecteur qu’un effet 3D complexe.

9. Intégrer et exporter

Un graphique ECharts vit dans une page web, mais il peut aussi devenir une image ou rejoindre une application.

BesoinPossibilitéBon à savoir
Site webScript ou paquet npmN’importer que les graphiques utilisés allège la page
ImageBouton d’enregistrementPNG avec le rendu Canvas, SVG avec le rendu SVG
Page sans JavaScriptRendu côté serveurNode.js produit un SVG fixe, prêt à insérer
ApplicationReact, Vue, AngularDes composants de la communauté suivent les données
PythonpyechartsGénère une page HTML depuis un script ou un notebook
Charte graphiqueThèmesThèmes clair et foncé fournis, éditeur de thème en ligne
AccessibilitéDescription et motifsDistingue les séries sans dépendre de la couleur

10. ECharts, Plotly ou Matplotlib ?

Les trois bibliothèques tracent les grands types de graphiques. Elles ne partent pas du même endroit.

CritèreMatplotlibPlotlyECharts
LangagePythonPythonJavaScript
RésultatImage fixePage web interactiveComposant d’une page web
DescriptionInstructions de dessinTraces et mise en pageUne option déclarative
Points fortsPublications, contrôle finExploration, science, DashTableaux de bord, animations, mobile
Pour démarrerGalerie d’exemplesPlotly ExpressÉditeur en ligne de la galerie
En pratique

Matplotlib pour un rapport imprimé, Plotly pour explorer des données en Python, ECharts pour un site ou un tableau de bord construit en JavaScript.

11. Mise en pratique : choisir le bon graphique

Voici quatre besoins de tableau de bord :

  • La régularité d’une pratique sportive sur une année
  • L’avancement d’un objectif dans une carte d’indicateur
  • Le budget d’une association, des recettes jusqu’aux dépenses
  • Le classement de cinq équipes au fil d’une saison

Objectif : associer chaque besoin à un exemple de la sélection, puis l’adapter dans l’éditeur.

  1. Nommer ce que le lecteur doit voir : régularité, progression, flux ou classement
  2. Retrouver la famille correspondante dans ce guide
  3. Ouvrir l’exemple choisi dans l’éditeur officiel
  4. Modifier une valeur du code et observer le graphique

Question pour vérifier ta compréhension :

Quel exemple choisir pour chaque besoin, et quelle clé de l’option modifier pour changer les valeurs affichées ?

Afficher la réponse

La régularité sur une année : le calendrier d’activité (Calendar Heatmap). L’avancement d’un objectif : la jauge de progression (Progress Gauge) ou le demi-anneau (Half Donut). Le budget d’une association : un diagramme de Sankey, qui suit chaque euro des recettes aux dépenses. Le classement d’une saison : le Bump Chart, ou une course de barres (Bar Race) pour l’animer. Dans tous les cas, les valeurs se trouvent dans la clé series, ou dans dataset quand l’exemple range ses données à part.

12. À retenir

ECharts, en bref

  • Décrire tout le graphique dans une seule option
  • Partir d’un exemple de la galerie plutôt que d’une page blanche
  • Choisir la famille selon la question : évolution, répartition, hiérarchie, flux ou indicateur
  • Préférer un format sobre à un effet 3D sur un site professionnel
  • N’importer que les graphiques utilisés

13. Guides associés

14. Pour aller plus loin

Parcourir toute la galerie, classée par type de graphique :

Apache ECharts : galerie d’exemples (en anglais)(nouvel onglet)

Comprendre les notions de base, de l’installation aux animations :

Apache ECharts : manuel (en anglais)(nouvel onglet)

Retrouver chaque clé de l’option et ses réglages :

Apache ECharts : référence de l’option (en anglais)(nouvel onglet)

Créer des graphiques ECharts depuis Python :

pyecharts : documentation(nouvel onglet)