Ces méthodes sont disponibles sur chaque objet Chart retourné par n'importe quelle fonction SeraPlot. Elles retournent toutes un nouveau Chart — elles peuvent donc être chaînées librement.

Configuration globale (héritage automatique)

sp.config(**kwargs)

Définie une fois, chaque graphique créé ensuite hérite automatiquement de la configuration. Aucune surcharge par graphique nécessaire.

import seraplot as sp

sp.config(
    font="Inter",
    font_size=14,
    title_size=22,
    crosshair=True,
    zoom=True,
    animation=True,
    animation_duration=500,
    export_button=True,
    responsive=True,
    border_radius=12,
    margin=16,
    opacity=0.85,
    background="#0f172a",
    gridlines=True,
    palette=[0x818CF8, 0xFB7185, 0x34D399, 0xFBBF24],
)

chart1 = sp.bar("Chiffre d'affaires", ["T1", "T2", "T3"], [120, 180, 140])
chart2 = sp.line("Tendance", ["Jan", "Fév", "Mar"], [100, 110, 105])
chart3 = sp.scatter("Corrélation", [1, 2, 3], [10, 20, 30])

sp.reset_config()

Remet toute la configuration globale aux valeurs par défaut (pas de fond, pas de réticule, pas de zoom, etc.).

sp.reset_config()
chart = sp.bar("Propre", labels, values)

Surcharge par graphique (chaînage de méthodes)

Surcharger la configuration globale pour des graphiques individuels :

import seraplot as sp

sp.config(font="Inter", background="#0f172a", gridlines=True)

chart1 = sp.bar("Défaut", labels, values)
chart2 = sp.bar("Surcharge", labels, values).font("Roboto").border_radius(20)
chart3 = sp.line("Propre", dates, values).zoom()

Fond et cadre

set_bg(color=None)

Définit la couleur de fond du wrapper HTML complet, pour plus d'infos une section Background existe dans cette documentation, ou vous pourrez retrouver plus ample information concernant les arrières plan, mais aussi les thèmes existant.

chart = sp.build_bar_chart("Ventes", labels, values).set_bg("#0f172a")
chart = sp.build_scatter_chart("Données", x, y).set_bg("white")
chart = sp.build_pie_chart("Parts", labels, values).set_bg(None)  # transparent

Accepte toute chaîne de couleur CSS : "#rrggbb", "rgb(r,g,b)", couleurs nommées, ou None/"transparent".

set_frame(color=None)

Définit le fond du canevas SVG indépendamment du wrapper HTML. Utile lors d'une intégration dans une page avec son propre fond.

chart = sp.build_bar_chart("Titre", labels, values).set_frame("transparent")

set_global_background(color)

Fonctions au niveau du module qui appliquent un fond à tous les graphiques créés après l'appel — utile pour les sessions notebook avec un thème cohérent.

sp.set_global_background("#0f172a")
chart1 = sp.build_bar_chart(...)
chart2 = sp.build_scatter_chart(...)
sp.reset_global_background()

sp.set_global_background("#0f172a");
const chart1 = sp.build_bar_chart(...);
const chart2 = sp.build_scatter_chart(...);
sp.reset_global_background();

sp.set_global_background("#0f172a");
const chart1 = sp.build_bar_chart(...);
const chart2 = sp.build_scatter_chart(...);
sp.reset_global_background();

Grille et axes

show_grid()

Force l'affichage des lignes de grille indépendamment du paramètre gridlines à la création.

chart = sp.build_histogram("Âges", values).show_grid()

hide_grid()

Force la désactivation des lignes de grille indépendamment du paramètre gridlines à la création.

chart = sp.build_line_chart("Tendance", labels, values, gridlines=True).hide_grid()

no_x_axis()

Supprime les lignes, ticks et étiquettes de l'axe X.

chart = sp.build_bar_chart("", labels, values).no_x_axis()

no_y_axis()

Supprime les lignes, ticks et étiquettes de l'axe Y.

chart = sp.build_bar_chart("", labels, values).no_y_axis()

no_axes()

Supprime les deux axes en une seule fois.

chart = sp.build_scatter_chart("", x, y).no_axes()

Étiquettes et texte

show_labels(position="bottom", labels=None, colors=None)

Affiche une étiquette texte sur chaque élément du graphique. position peut être "top", "bottom", "left" ou "right".

chart = sp.build_bar_chart("Chiffre d'affaires", labels, values).show_labels(position="top")

chart = sp.build_bar_chart("Chiffre d'affaires", labels, values).show_labels(
    position="top",
    labels=["142 k€", "98 k€", "210 k€"],
    colors=["#22c55e", "#ef4444", "#22c55e"],
)

no_title()

Supprime le titre du rendu.

chart = sp.build_pie_chart("Étiquette interne", labels, values).no_title()

no_legend()

Supprime la légende du rendu.

chart = sp.build_grouped_bar("T1", cats, series).no_legend()

set_font_size(px)

Surcharge toutes les tailles de texte du SVG avec une seule valeur en pixels.

chart = sp.build_radar_chart("Compétences", labels, values).set_font_size(11)

Taille et échelle

scale(factor)

Met à l'échelle tout le graphique (SVG et canevas). Utile pour produire des miniatures ou des variantes haute définition.

small = sp.build_bar_chart("Ventes", labels, values).scale(0.5)
large = sp.build_bar_chart("Ventes", labels, values).scale(2.0)

Survol

no_hover()

Désactive le moteur d'infobulles. Tous les événements pointeur data-idx sont retirés. Utile pour des intégrations statiques sans interaction au survol.

chart = sp.build_scatter_chart("Distribution", x, y).no_hover()

Injection CSS et JavaScript

inject_css(css)

Injecte un bloc <style> dans le <head> du HTML. Donne un accès complet au DOM SVG — surcharger n'importe quelle classe interne, changer les couleurs, animations, polices.

Classes CSS internes de SeraPlot :

chart = sp.build_bar_chart("Thème sombre", labels, values).inject_css("""
    rect.sp-bg  { fill: #0f172a !important; }
    svg text    { fill: #e2e8f0 !important; }
    .sp-gl      { stroke: #1e293b !important; }
    [data-idx]  { opacity: 0.85; }
    [data-idx]:hover { filter: brightness(1.3); }
""")

inject_js(js)

Injecte un bloc <script> avant </body>. Tout le DOM SVG rendu est accessible. Utilisez-le pour ajouter des écouteurs d'événements, animations ou intégrations tierces.

chart = sp.build_bar_chart("Ventes", labels, values).inject_js("""
    document.querySelectorAll('[data-idx]').forEach((el, i) => {
        setTimeout(() => el.style.opacity = '1', i * 50);
    });
""")

chart = sp.build_scatter_chart("Données", x, y).inject_js("""
    const btn = document.createElement('button');
    btn.textContent = 'Télécharger SVG';
    btn.onclick = () => {
        const svg  = document.querySelector('svg').outerHTML;
        const a    = document.createElement('a');
        a.href     = 'data:image/svg+xml;charset=utf-8,' + encodeURIComponent(svg);
        a.download = 'chart.svg';
        a.click();
    };
    document.body.appendChild(btn);
""")

Export

save(path)

Écrit le HTML dans un fichier.

chart = sp.build_pie_chart("Parts", labels, values)
chart.save("rapport/pie.html")

to_svg()

Extrait la chaîne SVG brute du HTML.

svg_string = chart.to_svg()

export_svg(path)

Écrit uniquement le SVG dans un fichier (sans le wrapper HTML).

chart.export_svg("chart.svg")