買い物リスト
商品の追加・削除・チェック管理ができる買い物リストアプリ。カテゴリ分類と優先度設定機能付き。
1. アプリ概要
商品の追加・削除・チェック管理ができる買い物リストアプリ。カテゴリ分類と優先度設定機能付き。
このアプリはorganizersカテゴリの実践的なPythonアプリです。使用ライブラリは tkinter（標準ライブラリ）、難易度は ★☆☆ です。
このアプリは「整理ツール」カテゴリです。整理・分類系のツールはデータ構造とユーザー操作を結びつける書き方を学ぶ好機です。設計次第で書きやすさが大きく変わります。tkinter（標準ライブラリ） を活かして実装するこの構造は、他のアプリにも応用が効きます。
コードを読む前に実行することをおすすめします。動いている挙動を先に把握しておくと、解説で出てくる関数や処理がどこに対応するかが頭に入りやすくなります。
応用のヒントは、機能を 1 つ増やす・見た目を整える・例外を一つでも丁寧に扱う、のいずれかから始めるのがおすすめです。
2. 機能一覧
- 買い物リストのメイン機能
- 直感的なGUIインターフェース
- 入力値のバリデーション
- エラーハンドリング
- 結果の見やすい表示
- クリア機能付き
3. 事前準備・環境
Python 3.10 以上 / Windows・Mac・Linux すべて対応
以下の環境で動作確認しています。
- Python 3.10 以上
- OS: Windows 10/11・macOS 12+・Ubuntu 20.04+
4. 完全なソースコード
右上の「コピー」ボタンをクリックするとコードをクリップボードにコピーできます。
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クラスにアプリの全機能をまとめています。__init__でウィンドウ設定、_build_ui()でUI構築、process()でメイン処理を担当します。責任の分離により、コードが読みやすくなります。
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください（重複表示を避けるため再掲を省略しています）。
UIレイアウトの構築
LabelFrameで入力エリアと結果エリアを視覚的に分けています。pack()で縦に並べ、expand=Trueで結果エリアが画面いっぱいに広がるよう設定しています。
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください（重複表示を避けるため再掲を省略しています）。
イベント処理
ボタンのcommand引数でクリックイベントを、bind('
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください（重複表示を避けるため再掲を省略しています）。
Textウィジェットでの結果表示
tk.Textウィジェットをstate=DISABLED（読み取り専用）で作成し、更新時はNORMALに変更してinsert()で内容を書き込み、再びDISABLEDに戻します。
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください（重複表示を避けるため再掲を省略しています）。
例外処理とエラーハンドリング
try-exceptでValueErrorとExceptionを捕捉し、messagebox.showerror()でエラーメッセージを表示します。予期しないエラーも処理することで、アプリの堅牢性が向上します。
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください（重複表示を避けるため再掲を省略しています）。
6. ステップバイステップガイド
このアプリをゼロから自分で作る手順を解説します。コードをコピーするだけでなく、実際に手順を追って自分で書いてみましょう。
-
1ファイルを作成する
新しいファイルを作成して app069.py と保存します。
-
2クラスの骨格を作る
App069クラスを定義し、__init__とmainloop()の最小構成を作ります。
-
3タイトルバーを作る
Frameを使ってカラーバー付きのタイトルエリアを作ります。
-
4入力フォームを実装する
LabelFrameとEntryウィジェットで入力エリアを作ります。
-
5処理ロジックを実装する
_execute()メソッドにメインロジックを実装します。
-
6結果表示を実装する
TextウィジェットかLabelに結果を表示する_show_result()を実装します。
-
7エラー処理を追加する
try-exceptとmessageboxでエラーハンドリングを追加します。
7. カスタマイズアイデア
基本機能を習得したら、以下のカスタマイズに挑戦してみましょう。
💡 ダークモードを追加する
bg色・fg色を辞書で管理し、ボタン1つでダークモード・ライトモードを切り替えられるようにしましょう。
💡 データの保存機能
処理結果をCSV・TXTファイルに保存する機能を追加しましょう。filedialog.asksaveasfilename()でファイル保存ダイアログが使えます。
💡 設定ダイアログ
フォントサイズや色などの設定をユーザーが変更できるオプションダイアログを追加しましょう。
8. よくある問題と解決法
❌ 日本語フォントが表示されない
原因：システムに日本語フォントが見つからない場合があります。
解決法：font引数を省略するかシステムに合ったフォントを指定してください。
❌ ライブラリのインポートエラー
原因：必要なライブラリがインストールされていません。
解決法：pip install コマンドで必要なライブラリをインストールしてください。
❌ ウィンドウサイズが合わない
原因：画面解像度や表示スケールによって異なる場合があります。
解決法：root.geometry()で適切なサイズに調整してください。
9. 練習問題
アプリの理解を深めるための練習問題です。
-
課題1：機能拡張
買い物リストに新しい機能を1つ追加してみましょう。
-
課題2：UIの改善
色・フォント・レイアウトを変更して、より使いやすいUIにカスタマイズしましょう。
-
課題3：保存機能の追加
処理結果をファイルに保存する機能を追加しましょう。