初心者向け No.082

時間割ビューアー

曜日×時限グリッドに授業を入力・表示する時間割アプリ。セルクリックで編集しJSONに保存する。

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

📋 目次

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

1. アプリ概要

曜日×時限グリッドに授業を入力・表示する時間割アプリ。セルクリックで編集しJSONに保存する。

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

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

完成形を見てから細部の解説に進む流れが効果的です。実行→気になる箇所を解説で確認→自分の手で改造、というサイクルで定着が早まります。

カスタマイズ章では具体的な拡張アイデアを示しています。一つ実装するごとに動作確認することで、変更が予期せぬ副作用を起こさないかも体感できます。

時間割ビューアー実行画面（Linux Mint） — 実行画面（Linux Mint）

2. 機能一覧

「保存」ボタン（_save()）・「クリア」ボタン（clear_all()）で操作
マウス操作 <Button-1> から edit_cell() を実行
JSON ファイルの保存（「保存」ボタン）・読み込み（起動時に自動実行）
messagebox.askyesno()・messagebox.showerror() によるダイアログ通知
ウィンドウはタイトル「時間割ビューアー」・サイズ 680x485 で起動

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. 完全なソースコード

💡

コードのコピー方法

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

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

app082.py

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


class App082:
    """時間割ビューアー"""

    DAYS = ("月", "火", "水", "木", "金")
    PERIODS = 6
    SAVE_FILE = "timetable.json"

    def __init__(self, root):
        self.root = root
        self.root.title("時間割ビューアー")
        self.root.geometry("680x485")
        self.root.minsize(680, 485)
        self.root.configure(bg="#f8f9fc")
        # data[period][day] = subject
        self.data = [["" for _ in self.DAYS] for _ in range(self.PERIODS)]
        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=20, pady=20)
        main_frame.pack(fill=tk.BOTH, expand=True)

        grid_frame = tk.Frame(main_frame, bg="#f8f9fc")
        grid_frame.pack(fill=tk.BOTH, expand=True)

        # ヘッダー
        tk.Label(grid_frame, text="", width=8, bg="#dee2e6", relief=tk.RIDGE).grid(row=0, column=0, sticky="nsew")
        for c, day in enumerate(self.DAYS):
            tk.Label(grid_frame, text=day, bg="#dee2e6", relief=tk.RIDGE, font=("Noto Sans JP", 11, "bold")).grid(row=0, column=c + 1, sticky="nsew")

        self.cell_labels = []  # [[label]]
        for r in range(self.PERIODS):
            tk.Label(grid_frame, text=f"{r+1}限", bg="#dee2e6", relief=tk.RIDGE, font=("Noto Sans JP", 11, "bold")).grid(row=r + 1, column=0, sticky="nsew")
            row_labels = []
            for c in range(len(self.DAYS)):
                lab = tk.Label(grid_frame, text="", bg="white", relief=tk.RIDGE, font=("Noto Sans JP", 11), height=2)
                lab.grid(row=r + 1, column=c + 1, sticky="nsew", padx=1, pady=1)
                lab.bind("<Button-1>", lambda e, r=r, c=c: self.edit_cell(r, c))
                row_labels.append(lab)
            self.cell_labels.append(row_labels)

        for c in range(len(self.DAYS) + 1):
            grid_frame.columnconfigure(c, weight=1)
        for r in range(self.PERIODS + 1):
            grid_frame.rowconfigure(r, weight=1)

        btn_frame = tk.Frame(main_frame, bg="#f8f9fc")
        btn_frame.pack(pady=8)
        ttk.Button(btn_frame, text="保存", command=self._save).pack(side=tk.LEFT, padx=4)
        ttk.Button(btn_frame, text="クリア", command=self.clear_all).pack(side=tk.LEFT, padx=4)

        tk.Label(main_frame, text="セルをクリックして授業名を入力してください。",
                 bg="#f8f9fc", fg="#666").pack(anchor="w")

    def edit_cell(self, r, c):
        """セルをクリックで編集"""
        cur = self.data[r][c]
        val = simpledialog.askstring(
            "授業入力", f"{r+1}限 {self.DAYS[c]}曜日の授業名:", initialvalue=cur
        )
        if val is None:
            return
        self.data[r][c] = val.strip()
        self._save()
        self._refresh()

    def clear_all(self):
        """全セルクリア（要確認）"""
        if not messagebox.askyesno("確認", "全セルをクリアしますか?"):
            return
        self.data = [["" for _ in self.DAYS] for _ in range(self.PERIODS)]
        self._save()
        self._refresh()

    def _refresh(self):
        """表示を再描画"""
        for r in range(self.PERIODS):
            for c in range(len(self.DAYS)):
                v = self.data[r][c]
                self.cell_labels[r][c].config(text=v if v else "—", fg="#222" if v else "#bbb")

    def _load(self):
        """JSON保存ファイルを読込"""
        if os.path.exists(self.SAVE_FILE):
            try:
                with open(self.SAVE_FILE, "r", encoding="utf-8") as f:
                    d = json.load(f)
                if isinstance(d, list) and len(d) == self.PERIODS:
                    self.data = [[(row[c] if c < len(row) else "") for c in range(len(self.DAYS))] for row in d]
            except Exception:
                pass

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


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

5. コード解説

時間割ビューアーのコードを、実際に書かれている実装に沿って解説します。

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

App082 クラスにアプリの全機能をまとめています（メソッド7個・全121行）。__init__ ではタイトル「時間割ビューアー」とウィンドウサイズ 680x485 を設定します。そのあと _build_ui() → _load() → _refresh() の順に呼び出して初期状態を作ります。