Python で Excel のスパークラインを挿入・変更・削除する方法

月別の推移を行ごとに並べた表は、数字が 12 列も続くと「増えているのか減っているのか」が一目では分かりません。かといって行ごとにグラフを貼り付けると、シートはグラフだらけになり、表そのものが読みにくくなります。

その中間にあるのがスパークラインです。セル 1 つ分の領域に収まる小さなグラフで、表のレイアウトを崩さずに推移だけを添えられます。本記事では、Spire.XLS for Python を使用して Python で Excel のスパークラインを挿入・変更・削除する方法 を解説します。

クイックナビゲーション

• 準備：Spire.XLS for Python のインストール
• サンプルデータを用意する
• スパークラインの 3 種類
• スパークラインを挿入する
• スパークラインを変更する
• スパークラインを削除する
• まとめ
• FAQ

準備：Spire.XLS for Python のインストール

本記事のコードは Spire.XLS for Python と plum-dispatch v1.7.4 を使用しています（動作確認は Spire.XLS for Python 16.8.2）。pip コマンドでインストールしてください。

pip install Spire.XLS

スクリプト側では、次の 2 行をインポートします。

from spire.xls import *
from spire.xls.common import *

ここでひとつ注意点があります。 スパークラインは Excel 2010 以降で追加された機能のため、ワークブックの形式が古いままだと扱えません。Workbook() で新規作成したブックの Workbook.Version は既定で Version97to2003 になっており、その状態でスパークラインを操作しようとすると次の例外で停止します。

SpireException: Sparkline can not be supported for current excel version.

新規にブックを作る場合は、最初に Workbook.Version へ ExcelVersion.Version2016 を設定しておいてください。既存の .xlsx ファイルを読み込む場合は、そのファイルの形式が引き継がれるため通常は設定不要です。

サンプルデータを用意する

以降の操作で使う表を用意します。商品ごとに 1 行、1 月から 12 月までの数値を横に並べ、スパークラインはその右隣（N 列）に置く構成です。

from spire.xls import *
from spire.xls.common import *

# Workbook オブジェクトを作成
workbook = Workbook()
workbook.Version = ExcelVersion.Version2016
workbook.CreateEmptySheets(1)
sheet = workbook.Worksheets.get_Item(0)
sheet.Name = "月別売上"

# 見出しを設定
sheet.Range["A1"].Text = "2025年度 月別売上高（千円）"
sheet.Range["A2"].Text = "商品"
months = ["1月", "2月", "3月", "4月", "5月", "6月",
          "7月", "8月", "9月", "10月", "11月", "12月"]
for i, month in enumerate(months):
    sheet.Range[2, i + 2].Text = month
sheet.Range[2, 14].Text = "スパークライン"

# 商品ごとの月別数値を入力
products = [
    ("商品A", [120, 135, 150, 148, 162, 175, 190, 205, 198, 215, 230, 248]),
    ("商品B", [240, 228, 215, 210, 196, 188, 175, 168, 152, 140, 128, 115]),
    ("商品C", [150, 152, 149, 151, 150, 153, 148, 150, 151, 149, 152, 150]),
    ("商品D", [90, 210, 110, 240, 95, 260, 120, 230, 100, 250, 130, 245]),
    ("商品E", [80, 75, 110, 160, 200, 230, 215, 180, 140, 110, 95, 90]),
    ("前年同月比", [12, -8, 15, 20, -5, 18, -12, 25, 9, -3, 22, 17]),
]
for r, (label, values) in enumerate(products, start=3):
    sheet.Range[r, 1].Text = label
    for i, value in enumerate(values):
        sheet.Range[r, i + 2].NumberValue = value

# 表の書式を整える
sheet.Range["A2:N2"].Style.Color = Color.get_Black()
sheet.Range["A2:N2"].Style.Font.Color = Color.get_White()
sheet.Range["A2:N2"].Style.Font.IsBold = True
sheet.Range["A2:N2"].Style.HorizontalAlignment = HorizontalAlignType.Center
sheet.Range["A2:A8"].Style.Font.IsBold = True
sheet.Range["B3:M8"].Style.HorizontalAlignment = HorizontalAlignType.Center
sheet.Range["B3:M8"].Style.NumberFormat = "#,##0"
sheet.AutoFitColumn(1)

workbook.SaveToFile("Sample.xlsx", ExcelVersion.Version2016)
workbook.Dispose()

ここで「1月」のような文字列を扱うときの落とし穴があります。Range.Value に "1月" を代入すると、Spire.XLS はそれを日付（2026/1/1）として解釈してしまいます。セルの表示形式を "@"（文字列）に変えてから代入しても同じでした。月名や年号のような「日付に見える文字列」をそのまま表示させたい場合は、次のように Range.Text プロパティを使ってください。

sheet.Range["B2"].Text = "1月"      # 文字列として格納される
sheet.Range["B2"].Value = "1月"     # 日付に変換されてしまう

スパークラインの 3 種類

挿入の前に、選べる種類を整理しておきます。SparklineType 列挙体には次の 3 つの値が用意されています。

Stacked は名前こそ「積み上げ」ですが、Excel の「勝敗」スパークラインに相当します。上のサンプルでいえば「前年同月比」のように、正負のどちらかに振れたことだけを追いたい行に向いています。

スパークラインを挿入する

挿入は、ワークシートにスパークライン グループを追加し、その中にスパークラインを追加するという 2 段構えの流れになります。色はグループ単位で指定するため、同じ見た目にしたい行は同じグループにまとめると管理しやすくなります。

• Worksheet.SparklineGroups.AddGroup() でグループを追加し、SparklineGroup.SparklineType と SparklineGroup.SparklineColor で見た目を設定する
• SparklineGroup.Add() でスパークラインのコレクションを取得する
• SparklineCollection.Add(データ範囲, 表示先セル) でスパークラインを配置する

from spire.xls import *
from spire.xls.common import *

# Workbook オブジェクトを作成し、スパークラインを含むファイルを読み込む
workbook = Workbook()
workbook.LoadFromFile("Sample.xlsx")

# 最初のワークシートを取得
sheet = workbook.Worksheets.get_Item(0)

# 折れ線スパークライン（商品Aの行）
group1 = sheet.SparklineGroups.AddGroup()
group1.SparklineType = SparklineType.Line
group1.SparklineColor = Color.get_Orange()
group1.HighPointColor = Color.get_Red()
sparklines1 = group1.Add()
sparklines1.Add(sheet.Range["B3:M3"], sheet.Range["N3"])

# 縦棒スパークライン（商品Bの行）
group2 = sheet.SparklineGroups.AddGroup()
group2.SparklineType = SparklineType.Column
group2.SparklineColor = Color.get_BlueViolet()
group2.HighPointColor = Color.get_Red()
sparklines2 = group2.Add()
sparklines2.Add(sheet.Range["B4:M4"], sheet.Range["N4"])

# 勝敗スパークライン（前年同月比の行）
group3 = sheet.SparklineGroups.AddGroup()
group3.SparklineType = SparklineType.Stacked
group3.SparklineColor = Color.get_DarkBlue()
group3.NegativePointColor = Color.get_Red()
sparklines3 = group3.Add()
sparklines3.Add(sheet.Range["B8:M8"], sheet.Range["N8"])

# スパークラインが見えるよう列幅を調整
sheet.Columns[13].ColumnWidth = 20

workbook.SaveToFile("AddSparklines.xlsx", ExcelVersion.Version2016)
workbook.Dispose()

スパークラインはセルの幅に合わせて描画されるため、表示先の列幅が狭いとほとんど見えません。上のコードのように Worksheet.Columns[index].ColumnWidth である程度の幅を確保しておいてください。

SparklineGroup には、色以外にも次のようなプロパティがあります。

• HighPointColor — 最大値の点の色
• LowPointColor — 最小値の点の色
• NegativePointColor — 負の値の色（Stacked でとくに有効）
• MarkersColor — マーカーの色
• LineWeight — 線の太さ（既定は 0.75）
• ShowHighPoint / ShowLowPoint / ShowNegativePoint / ShowMarkers — 各ポイントを表示するかどうか

スパークラインを変更する

挿入したあとに種類や色、参照するデータ範囲を変えたい場合は、Worksheet.SparklineGroups[index] でグループを取得して設定を上書きします。参照範囲の変更だけはグループではなくスパークライン単位の操作で、SparklineCollection.RefreshRanges() メソッドを使います。

from spire.xls import *
from spire.xls.common import *

# Workbook オブジェクトを作成し、スパークラインを含むファイルを読み込む
workbook = Workbook()
workbook.LoadFromFile("AddSparklines.xlsx")

# 最初のワークシートを取得
sheet = workbook.Worksheets.get_Item(0)

# 2 番目のスパークライングループを取得
sparklineGroup = sheet.SparklineGroups[1]

# 種類を折れ線に、色をフォレストグリーンに変更
sparklineGroup.SparklineType = SparklineType.Line
sparklineGroup.SparklineColor = Color.get_ForestGreen()

# 参照するデータ範囲を 1 月〜6 月に変更（表示先はそのまま）
sparklines = sparklineGroup[0]
sparklines.RefreshRanges(sheet.Range["B4:G4"], sheet.Range["N4"])

workbook.SaveToFile("ModifySparklines.xlsx", ExcelVersion.Version2016)
workbook.Dispose()

SparklineGroup をインデックスで取得すると、そのグループに属するスパークラインのコレクション（SparklineCollection）も同じようにインデックスで取り出せます。上のコードでは sparklineGroup[0] が 1 本目のスパークラインにあたります。RefreshRanges() の第 2 引数には表示先セルを渡しますが、表示先を変えない場合でも省略できないため、変更前と同じセルを指定してください。

スパークラインを削除する

削除は Worksheet.SparklineGroups.Clear() メソッドで行います。引数には削除したいグループを渡します。

from spire.xls import *
from spire.xls.common import *

# Workbook オブジェクトを作成し、スパークラインを含むファイルを読み込む
workbook = Workbook()
workbook.LoadFromFile("AddSparklines.xlsx")

# 最初のワークシートを取得
sheet = workbook.Worksheets.get_Item(0)

# 最初のスパークライングループを取得して削除
sparklineGroup = sheet.SparklineGroups[0]
sheet.SparklineGroups.Clear(sparklineGroup)

workbook.SaveToFile("RemoveSparklines.xlsx", ExcelVersion.Version2016)
workbook.Dispose()

Clear() はグループ単位の削除なので、そのグループに複数のスパークラインが含まれていればまとめて消えます。グループの中から 1 本だけを削除する方法は、現行バージョン（16.8.2）の Python バインディングでは提供されていません。 SparklineCollection.Remove() や SparklineCollection.RemoveAt() を呼ぶと AttributeError: function 'IList_Remove' not found になります。特定の行のスパークラインだけを消したい場合は、削除したい行を含まないグループを組み直すか、対象の行だけを残したグループを作り直してください。

まとめ

本記事で扱った操作を整理します。

• 挿入 — Worksheet.SparklineGroups.AddGroup() でグループを作り、SparklineType と SparklineColor を設定したうえで、SparklineCollection.Add(データ範囲, 表示先セル) で配置する
• 変更 — 種類と色は SparklineGroup のプロパティを上書きし、参照範囲は SparklineCollection.RefreshRanges() で変更する
• 削除 — Worksheet.SparklineGroups.Clear(グループ) でグループごと削除する
• 前提条件 — スパークラインは Excel 2010 以降の機能のため、新規作成時は Workbook.Version に ExcelVersion.Version2016 を設定する。日本語の月名は Range.Text で代入する

表の数字とスパークラインを同時に生成できれば、月次レポートのような「行ごとの推移を見せたい資料」をまるごと自動化できます。

Spire.XLS for Python の全機能を評価したい場合は、30 日間の無料ライセンスを申請できます。なお無償の試用版では、保存したファイルに評価用の警告シートが追加されます。ライセンスを適用するとこれも出力されなくなります。

FAQ

スパークラインを画像に変換したら何も描画されませんでした。

仕様どおりの動作です。スパークラインは OOXML の拡張領域（x14:sparklineGroups）に格納される Excel 2010 以降の機能で、Worksheet.ToImage() によるレンダリングや PDF 出力では描画されません。保存した .xlsx を Excel で開けば問題なく表示されるため、確認は Excel 上で行ってください。

1 つのグループに複数のスパークラインを追加できますか？

はい。SparklineGroup.Add() で取得したコレクションに対して Add() を繰り返せば、同じ書式を共有するスパークラインを複数追加できます。たとえば「同じ色の折れ線を 5 行分」といった指定が 1 つのグループでまとまります。

データ範囲に空のセルが混じるとどうなりますか？

グループの SparklineGroup.EmptyCellsType に従って描画されます。SparklineEmptyCells 列挙体の値で指定し、既定値は Gaps（間隔として扱い線を途切れさせる）です。Zero にすると 0 として扱われ、Line にすると前後の値を結んで線を描画します。

スパークラインの色をポイントごとに変えられますか？

はい。HighPointColor（最大値）、LowPointColor（最小値）、NegativePointColor（負の値）、MarkerColor（マーカー）を個別に指定できます。色を反映させるには ShowHighPoint などの表示フラグを有効にしておく必要があります。

既存のファイルに含まれるスパークラインだけを一括で消せますか？

グループの数だけループして Worksheet.SparklineGroups.Clear(group) を呼んでください。Worksheet.SparklineGroups は Count プロパティを持つコレクションなので、for i in range(sheet.SparklineGroups.Count) の形で順に処理できます。