初心者向け No.069

買い物リスト

商品の追加・削除・チェック管理ができる買い物リストアプリ。カテゴリ分類と優先度設定機能付き。

🎯 難易度: ★☆☆ 📦 ライブラリ: tkinter（標準ライブラリ） ⏱️ 制作時間: 30〜90分

📋 目次

1. アプリ概要
2. 機能一覧
3. 事前準備・環境
4. 完全なソースコード
5. コード解説
6. ステップバイステップガイド
7. カスタマイズアイデア
8. よくある問題と解決法
9. 練習問題

1. アプリ概要

商品の追加・削除・チェック管理ができる買い物リストアプリ。カテゴリ分類と優先度設定機能付き。

このアプリはorganizersカテゴリの実践的なPythonアプリです。使用ライブラリは tkinter（標準ライブラリ）、難易度は ★☆☆ です。

このアプリは「整理ツール」カテゴリです。整理・分類系のツールはデータ構造とユーザー操作を結びつける書き方を学ぶ好機です。設計次第で書きやすさが大きく変わります。tkinter（標準ライブラリ） を活かして実装するこの構造は、他のアプリにも応用が効きます。

コードを読む前に実行することをおすすめします。動いている挙動を先に把握しておくと、解説で出てくる関数や処理がどこに対応するかが頭に入りやすくなります。

応用のヒントは、機能を 1 つ増やす・見た目を整える・例外を一つでも丁寧に扱う、のいずれかから始めるのがおすすめです。

買い物リスト実行画面（Linux Mint） — 実行画面（Linux Mint）

2. 機能一覧

「追加」ボタン（add_item()）・「チェック切替」ボタン（toggle_check()）・「削除」ボタン（delete_item()）・「完了済を削除」ボタン（delete_done()）で操作
キー <Return> から add_item() を実行
マウス操作 <Double-Button-1> から toggle_check() を実行
ttk.Treeview による表形式の一覧表示
JSON ファイルの保存・読み込み（起動時に自動実行）
messagebox.showerror()・messagebox.showwarning() によるダイアログ通知
ウィンドウはタイトル「買い物リスト」・サイズ 700x500 で起動

3. 事前準備・環境

ℹ️

動作確認環境

Python 3.10 以上 / Windows 11（実機）で起動・基本操作を確認／ Linux Mint 22.3（仮想マシン）で起動・画面表示を確認（macOS は未検証）

Windows 11（実機）で起動と基本操作を確認しています（全機能の網羅テストではありません）。Linux Mint 22.3（仮想マシン）では起動と画面表示を確認しました。macOS は標準ライブラリの範囲で動作する想定ですが、未検証です。

Python 3.10 以上
OS: Windows 11（実機で起動・基本操作を確認）・Linux Mint 22.3（仮想マシンで起動・画面表示を確認）

4. 完全なソースコード

💡

コードのコピー方法

右上の「コピー」ボタンをクリックするとコードをクリップボードにコピーできます。

✅ 追加インストール不要（標準ライブラリのみ使用）

app069.py

import tkinter as tk
from tkinter import ttk, messagebox
import json
import os


class App069:
    """買い物リスト（カテゴリ・優先度・チェック管理）"""

    SAVE_FILE = "shopping_list.json"
    CATEGORIES = ("食品", "日用品", "衣類", "電化製品", "その他")
    PRIORITIES = ("高", "中", "低")

    def __init__(self, root):
        self.root = root
        self.root.title("買い物リスト")
        self.root.geometry("700x500")
        self.root.configure(bg="#f8f9fc")
        self.items = []  # [{name, category, priority, checked}]
        self._build_ui()
        self._load()
        self._refresh()

    def _build_ui(self):
        """UIを構築する"""
        title_frame = tk.Frame(self.root, bg="#3776ab", pady=10)
        title_frame.pack(fill=tk.X)
        tk.Label(
            title_frame, text="買い物リスト",
            font=("Noto Sans JP", 16, "bold"),
            bg="#3776ab", fg="white"
        ).pack()

        main_frame = tk.Frame(self.root, bg="#f8f9fc", padx=14, pady=14)
        main_frame.pack(fill=tk.BOTH, expand=True)

        input_frame = ttk.LabelFrame(main_frame, text="商品の追加", padding=10)
        input_frame.pack(fill=tk.X, pady=(0, 10))

        tk.Label(input_frame, text="商品名:").grid(row=0, column=0, sticky="w")
        self.name_entry = ttk.Entry(input_frame, width=20)
        self.name_entry.grid(row=0, column=1, padx=4, sticky="ew")
        self.name_entry.bind("<Return>", lambda e: self.add_item())

        tk.Label(input_frame, text="カテゴリ:").grid(row=0, column=2, sticky="w")
        self.cat_var = tk.StringVar(value=self.CATEGORIES[0])
        ttk.Combobox(input_frame, textvariable=self.cat_var, values=self.CATEGORIES, state="readonly", width=10).grid(row=0, column=3, padx=4)

        tk.Label(input_frame, text="優先度:").grid(row=0, column=4, sticky="w")
        self.pri_var = tk.StringVar(value=self.PRIORITIES[1])
        ttk.Combobox(input_frame, textvariable=self.pri_var, values=self.PRIORITIES, state="readonly", width=4).grid(row=0, column=5, padx=4)

        ttk.Button(input_frame, text="追加", command=self.add_item).grid(row=0, column=6, padx=4)
        input_frame.columnconfigure(1, weight=1)

        # フィルタ
        filt_frame = tk.Frame(main_frame, bg="#f8f9fc")
        filt_frame.pack(fill=tk.X, pady=(0, 4))
        tk.Label(filt_frame, text="絞り込み:", bg="#f8f9fc").pack(side=tk.LEFT)
        self.filter_cat = tk.StringVar(value="すべて")
        ttk.Combobox(filt_frame, textvariable=self.filter_cat, values=("すべて",) + self.CATEGORIES, state="readonly", width=10).pack(side=tk.LEFT, padx=4)
        self.filter_cat.trace_add("write", lambda *a: self._refresh())
        self.show_done = tk.BooleanVar(value=True)
        ttk.Checkbutton(filt_frame, text="完了も表示", variable=self.show_done, command=self._refresh).pack(side=tk.LEFT)

        # ツリー
        tree_frame = tk.Frame(main_frame, bg="#f8f9fc")
        tree_frame.pack(fill=tk.BOTH, expand=True)
        cols = ("check", "name", "category", "priority")
        self.tree = ttk.Treeview(tree_frame, columns=cols, show="headings")
        self.tree.heading("check", text="✓")
        self.tree.heading("name", text="商品名")
        self.tree.heading("category", text="カテゴリ")
        self.tree.heading("priority", text="優先度")
        self.tree.column("check", width=40, anchor="center")
        self.tree.column("name", width=300)
        self.tree.column("category", width=100, anchor="center")
        self.tree.column("priority", width=70, anchor="center")
        self.tree.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
        self.tree.bind("<Double-Button-1>", lambda e: self.toggle_check())
        sb = ttk.Scrollbar(tree_frame, command=self.tree.yview)
        self.tree.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)

        op_frame = tk.Frame(main_frame, bg="#f8f9fc")
        op_frame.pack(fill=tk.X, pady=(8, 0))
        ttk.Button(op_frame, text="チェック切替", command=self.toggle_check).pack(side=tk.LEFT, padx=2)
        ttk.Button(op_frame, text="削除", command=self.delete_item).pack(side=tk.LEFT, padx=2)
        ttk.Button(op_frame, text="完了済を削除", command=self.delete_done).pack(side=tk.LEFT, padx=2)
        self.summary_label = tk.Label(op_frame, text="", bg="#f8f9fc")
        self.summary_label.pack(side=tk.RIGHT)

    def add_item(self):
        """商品を追加"""
        name = self.name_entry.get().strip()
        if not name:
            messagebox.showwarning("警告", "商品名を入力してください")
            return
        self.items.append({
            "name": name, "category": self.cat_var.get(),
            "priority": self.pri_var.get(), "checked": False,
        })
        self.name_entry.delete(0, tk.END)
        self._save()
        self._refresh()

    def toggle_check(self):
        """選択行のチェックを切り替え"""
        sel = self.tree.selection()
        if not sel:
            return
        idx = int(self.tree.item(sel[0], "tags")[0])
        self.items[idx]["checked"] = not self.items[idx]["checked"]
        self._save()
        self._refresh()

    def delete_item(self):
        """選択行を削除"""
        sel = self.tree.selection()
        if not sel:
            return
        idx = int(self.tree.item(sel[0], "tags")[0])
        del self.items[idx]
        self._save()
        self._refresh()

    def delete_done(self):
        """完了済を一括削除"""
        self.items = [it for it in self.items if not it["checked"]]
        self._save()
        self._refresh()

    def _refresh(self):
        """一覧を再描画"""
        for i in self.tree.get_children():
            self.tree.delete(i)
        pri_order = {"高": 0, "中": 1, "低": 2}
        sel_cat = self.filter_cat.get()
        for orig_i, it in sorted(enumerate(self.items), key=lambda x: (pri_order.get(x[1]["priority"], 9), x[1]["checked"])):
            if sel_cat != "すべて" and it["category"] != sel_cat:
                continue
            if not self.show_done.get() and it["checked"]:
                continue
            mark = "✓" if it["checked"] else " "
            self.tree.insert("", tk.END, values=(mark, it["name"], it["category"], it["priority"]), tags=(str(orig_i),))
        total = len(self.items)
        done = sum(1 for it in self.items if it["checked"])
        self.summary_label.config(text=f"完了 {done} / 全 {total}")

    def _load(self):
        """JSONを読み込む"""
        if os.path.exists(self.SAVE_FILE):
            try:
                with open(self.SAVE_FILE, "r", encoding="utf-8") as f:
                    self.items = json.load(f)
            except Exception:
                self.items = []

    def _save(self):
        """JSONを保存"""
        try:
            with open(self.SAVE_FILE, "w", encoding="utf-8") as f:
                json.dump(self.items, f, ensure_ascii=False, indent=2)
        except Exception as e:
            messagebox.showerror("エラー", f"保存失敗: {e}")


if __name__ == "__main__":
    root = tk.Tk()
    app = App069(root)
    root.mainloop()

5. コード解説

買い物リスト（カテゴリ・優先度・チェック管理）のコードを、実際に書かれている実装に沿って解説します。

クラス設計とコンストラクタ

App069 クラスにアプリの全機能をまとめています（メソッド9個・全171行）。__init__ ではタイトル「買い物リスト」とウィンドウサイズ 700x500 を設定します。そのあと _build_ui() → _load() → _refresh() の順に呼び出して初期状態を作ります。