Les cellules FOSS
Python
Sparkline

Sparkline — Aspose.Cells FOSS for Python API Reference

Les sparklines sont des graphiques miniatures intégrés dans des cellules individuelles, introduits dans Excel 2010. aspose-cells-foss gère les sparklines via SparklineGroup et SparklineGroupCollection (ws.sparkline_groups). Chaque groupe contient un ou plusieurs Sparkline objets partageant le même type et les mêmes paramètres de couleur.

Examples: aspose.cells_foss

from aspose.cells_foss import SparklineType, SparklineEmptyCells, Sparkline, SparklineGroup

SparklineType

SparklineType est un IntEnum identifiant la forme visuelle d’un groupe de sparklines.

ExamplesExamplesExamples
LINE0Line sparkline — rend les données sous forme d’une ligne connectée.
COLUMN1Column sparkline — rend les données sous forme de barres verticales.
WIN_LOSS2Sparkline de gains/pertes — chaque valeur est affichée sous forme de bloc positif ou négatif.

SparklineEmptyCells

SparklineEmptyCells est un IntEnum contrôlant la façon dont les cellules vides sont gérées dans une sparkline.

ExamplesExamplesExamples
ZERO0Considère les cellules vides comme zéro.
GAP1Laisse un vide là où les cellules sont vides (la ligne est interrompue).
CONNECTED2Connecte les valeurs adjacentes non vides, en sautant le vide.

Examples

Un Sparkline lie une plage de données unique à un emplacement de cellule unique.

Examples 

Sparkline(data_range: str, cell_reference: str)
ExamplesExamplesExamples
data_rangestrPlage de style A1 contenant les données source du sparkline (par ex., "Sheet1!B2:G2").
cell_referencestrAdresse de cellule de style A1 où le sparkline est affiché (par ex., "H2").

Examples

ExamplesExamplesExamples
data_rangestrPlage de données source.
cell_referencestrAdresse de cellule d’affichage.

SparklineGroup

A SparklineGroup définit les paramètres visuels partagés (type, couleurs, gestion des cellules vides) pour un ensemble de sparklines. SparklineGroup les objets ne sont pas construits directement — utilisez ws.sparkline_groups.add(...) ou ws.sparkline_groups.add_group(...).

Examples

ExamplesExamplesExamples
typeSparklineTypeForme de sparkline : LINE, COLUMN, ou WIN_LOSS.
display_empty_cells_asSparklineEmptyCellsComment gérer les cellules vides dans la plage de données.
color_seriesstrCouleur de la ligne/barres principale du sparkline, au format hexadécimal RRGGBB.
color_negativestrCouleur des barres à valeur négative (WIN_LOSS et COLUMN), au format hexadécimal RRGGBB.
color_axisstrCouleur de la ligne de l’axe zéro, au format hexadécimal RRGGBB.
color_markersstrCouleur des marqueurs de points de données sur les sparklines en ligne, au format hexadécimal RRGGBB.
color_firststrCouleur de surbrillance du premier point de données, au format hexadécimal RRGGBB.
color_laststrCouleur de surbrillance pour le dernier point de données, au format hexadécimal RRGGBB.
color_highstrCouleur de surbrillance pour le point de données le plus élevé, au format hexadécimal RRGGBB.
color_lowstrCouleur de surbrillance pour le point de données le plus bas, au format hexadécimal RRGGBB.
sparklineslist[Sparkline]Liste en lecture seule des sparklines individuelles de ce groupe.
countintNombre de sparklines dans ce groupe (lecture seule).

Examples

add_sparkline 

group.add_sparkline(data_range: str, cell_reference: str) -> Sparkline

Ajoute un sparkline individuel à ce groupe et renvoie le nouveau Sparkline objet.

SparklineGroupCollection

SparklineGroupCollection est accessible comme ws.sparkline_groups. Il contient tous les groupes de sparklines d’une feuille de calcul.

Examples

add 

ws.sparkline_groups.add(
    sparkline_type=SparklineType.LINE,
    data_range=None,
    is_vertical=False,
    location_range=None
) -> SparklineGroup

Crée un nouveau groupe et, éventuellement, le remplit de sparklines dérivées de data_range (lignes ou colonnes selon is_vertical) placées dans les cellules décrites par location_range. Retourne le nouveau SparklineGroup.

ExamplesExamplesExamples
sparkline_typeSparklineTypeforme visuelle des sparklines.
data_range`strNone`
is_verticalboolExamples True, chaque colonne dans data_range alimente un sparkline ; quand False, chaque ligne le fait.
location_range`strNone`

add_group 

ws.sparkline_groups.add_group(sparkline_type=SparklineType.LINE) -> SparklineGroup

Crée un groupe vide du type donné. Les sparklines doivent être ajoutés individuellement avec group.add_sparkline(...).

Propriétés et itération

ExamplesExamples
countNombre de groupes de sparklines sur cette feuille de calcul (lecture seule).
__len__()Examples count.
__iter__()Itère sur tous les SparklineGroup objets.
__getitem__(index)Renvoie le SparklineGroup à base zéro index.

Examples

L’exemple suivant écrit les données de chiffre d’affaires mensuel pour trois régions et ajoute une sparkline en ligne pour chaque ligne.

from aspose.cells_foss import Workbook, SparklineType, SparklineEmptyCells

wb = Workbook()
ws = wb.worksheets[0]
ws.name = "Trends"

# Write headers
months = ["Jan", "Feb", "Mar", "Apr", "May", "Jun"]
for col, m in enumerate(months):
    ws.cells[0][col + 1].put_value(m)

ws.cells["A1"].put_value("Region")
ws.cells["H1"].put_value("Trend")

# Write three rows of data
regions = [
    ("North", [12000, 14500, 13800, 16200, 15900, 17400]),
    ("South", [9800,  10200, 11500, 10900, 12300, 13100]),
    ("West",  [7500,   8100,  7900,  8800,  9200, 10500]),
]
for row_i, (name, values) in enumerate(regions, start=1):
    ws.cells[row_i][0].put_value(name)
    for col_i, v in enumerate(values):
        ws.cells[row_i][col_i + 1].put_value(v)

# Add a line sparkline group — one sparkline per data row
group = ws.sparkline_groups.add(
    sparkline_type=SparklineType.LINE,
    data_range="Trends!B2:G4",
    is_vertical=False,
    location_range="Trends!H2:H4",
)

# Customize colors
group.color_series = "4472C4"       # blue lines
group.color_high   = "70AD47"       # green for peak
group.color_low    = "FF0000"       # red for trough
group.display_empty_cells_as = SparklineEmptyCells.GAP

wb.save("sparklines.xlsx")

Voir aussi

 Français