チェックリスト
タスクの追加・完了・削除ができるチェックリスト。完了率をプログレスバーで表示しファイルに保存する。
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 json
import os
import tkinter as tk
from tkinter import ttk, messagebox, filedialog
class App081:
"""チェックリスト"""
DEFAULT_FILE = os.path.join(os.path.expanduser("~"), ".checklist.json")
def __init__(self, root):
self.root = root
self.root.title("チェックリスト")
self.root.geometry("560x520")
self.root.configure(bg="#f8f9fc")
# tasks: list of dict(text, done)
self.tasks = []
self._build_ui()
self._load_default()
self._refresh_view()
def _build_ui(self):
"""UIを構築する"""
title_frame = tk.Frame(self.root, bg="#3776ab", pady=12)
title_frame.pack(fill=tk.X)
tk.Label(
title_frame, text="チェックリスト",
font=("Noto Sans JP", 16, "bold"),
bg="#3776ab", fg="white"
).pack()
main = tk.Frame(self.root, bg="#f8f9fc", padx=16, pady=12)
main.pack(fill=tk.BOTH, expand=True)
# 入力欄
form = tk.Frame(main, bg="#f8f9fc")
form.pack(fill=tk.X, pady=(0, 6))
self.task_var = tk.StringVar()
e = ttk.Entry(form, textvariable=self.task_var, font=("Noto Sans JP", 11))
e.pack(side=tk.LEFT, fill=tk.X, expand=True)
e.bind("<Return>", lambda ev: self.add_task())
ttk.Button(form, text="追加", command=self.add_task).pack(side=tk.LEFT, padx=4)
# ボタン
btns = tk.Frame(main, bg="#f8f9fc")
btns.pack(fill=tk.X, pady=4)
ttk.Button(btns, text="完了切替", command=self.toggle_done).pack(side=tk.LEFT, padx=2)
ttk.Button(btns, text="削除", command=self.delete_selected).pack(side=tk.LEFT, padx=2)
ttk.Button(btns, text="完了済を一括削除", command=self.clear_done).pack(side=tk.LEFT, padx=2)
ttk.Button(btns, text="保存", command=self.save_tasks).pack(side=tk.RIGHT, padx=2)
ttk.Button(btns, text="読込", command=self.load_tasks).pack(side=tk.RIGHT, padx=2)
# リスト
list_frame = ttk.LabelFrame(main, text="タスク一覧", padding=4)
list_frame.pack(fill=tk.BOTH, expand=True, pady=4)
self.listbox = tk.Listbox(list_frame, font=("Noto Sans JP", 11),
bg="white", relief=tk.FLAT, selectmode=tk.SINGLE,
activestyle="none")
self.listbox.pack(fill=tk.BOTH, expand=True, side=tk.LEFT)
self.listbox.bind("<Double-Button-1>", lambda e: self.toggle_done())
sb = ttk.Scrollbar(list_frame, command=self.listbox.yview)
self.listbox.configure(yscrollcommand=sb.set)
sb.pack(side=tk.RIGHT, fill=tk.Y)
# プログレスバー + ステータス
status = tk.Frame(main, bg="#f8f9fc")
status.pack(fill=tk.X, pady=(4, 0))
self.progress = ttk.Progressbar(status, mode="determinate", maximum=100)
self.progress.pack(fill=tk.X, side=tk.TOP)
self.status_var = tk.StringVar()
tk.Label(status, textvariable=self.status_var, bg="#f8f9fc",
font=("Noto Sans JP", 10)).pack(anchor="w", pady=(2, 0))
def add_task(self):
"""タスクを追加する"""
text = self.task_var.get().strip()
if not text:
return
self.tasks.append({"text": text, "done": False})
self.task_var.set("")
self._refresh_view()
def toggle_done(self):
"""選択タスクの完了状態を切り替え"""
sel = self.listbox.curselection()
if not sel:
return
idx = sel[0]
self.tasks[idx]["done"] = not self.tasks[idx]["done"]
self._refresh_view()
if idx < self.listbox.size():
self.listbox.selection_set(idx)
def delete_selected(self):
"""選択タスクを削除"""
sel = self.listbox.curselection()
if not sel:
return
del self.tasks[sel[0]]
self._refresh_view()
def clear_done(self):
"""完了済タスクを一括削除"""
before = len(self.tasks)
self.tasks = [t for t in self.tasks if not t["done"]]
if before != len(self.tasks):
self._refresh_view()
def save_tasks(self):
"""タスクをファイルに保存"""
path = filedialog.asksaveasfilename(
defaultextension=".json",
filetypes=[("JSON", "*.json")],
initialfile="checklist.json",
)
if not path:
return
try:
with open(path, "w", encoding="utf-8") as f:
json.dump(self.tasks, f, ensure_ascii=False, indent=2)
# デフォルトとしても保存
try:
with open(self.DEFAULT_FILE, "w", encoding="utf-8") as f:
json.dump(self.tasks, f, ensure_ascii=False, indent=2)
except OSError:
pass
messagebox.showinfo("完了", f"保存しました: {path}")
except OSError as e:
messagebox.showerror("エラー", f"保存失敗: {e}")
def load_tasks(self):
"""タスクをファイルから読み込み"""
path = filedialog.askopenfilename(filetypes=[("JSON", "*.json")])
if not path:
return
try:
with open(path, "r", encoding="utf-8") as f:
data = json.load(f)
if not isinstance(data, list):
raise ValueError
self.tasks = [
{"text": str(d.get("text", "")), "done": bool(d.get("done", False))}
for d in data if isinstance(d, dict)
]
self._refresh_view()
except (OSError, ValueError, json.JSONDecodeError) as e:
messagebox.showerror("エラー", f"読込失敗: {e}")
def _load_default(self):
"""デフォルト保存ファイルがあれば自動読み込み"""
if os.path.exists(self.DEFAULT_FILE):
try:
with open(self.DEFAULT_FILE, "r", encoding="utf-8") as f:
data = json.load(f)
if isinstance(data, list):
self.tasks = [
{"text": str(d.get("text", "")), "done": bool(d.get("done", False))}
for d in data if isinstance(d, dict)
]
except (OSError, json.JSONDecodeError):
pass
def _refresh_view(self):
"""リストとプログレスバーを更新"""
self.listbox.delete(0, tk.END)
for t in self.tasks:
mark = "[x]" if t["done"] else "[ ]"
self.listbox.insert(tk.END, f"{mark} {t['text']}")
if t["done"]:
self.listbox.itemconfig(tk.END, fg="#888")
total = len(self.tasks)
done = sum(1 for t in self.tasks if t["done"])
ratio = (done / total * 100) if total else 0
self.progress["value"] = ratio
self.status_var.set(f"完了 {done} / {total} 件 ({ratio:.0f}%)")
if __name__ == "__main__":
root = tk.Tk()
app = App081(root)
root.mainloop()
5. コード解説
チェックリストのコードを詳しく解説します。クラスベースの設計で各機能を整理して実装しています。
クラス設計とコンストラクタ
App081クラスにアプリの全機能をまとめています。__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ファイルを作成する
新しいファイルを作成して app081.py と保存します。
-
2クラスの骨格を作る
App081クラスを定義し、__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：保存機能の追加
処理結果をファイルに保存する機能を追加しましょう。