漢字クイズ
漢字の読み方を入力して正解を競うクイズアプリ。正解率・経過時間・苦手漢字の重点出題機能付き。
1. アプリ概要
漢字の読み方を入力して正解を競うクイズアプリ。正解率・経過時間・苦手漢字の重点出題機能付き。
このアプリはgamesカテゴリの実践的なPythonアプリです。使用ライブラリは tkinter(標準ライブラリ)、難易度は ★☆☆ です。
このアプリは「ゲーム」カテゴリです。ゲーム実装は GUI イベント処理・状態管理・描画ループを同時に学べる教材で、画面・入力・ロジックの三層分離の感覚が掴めます。tkinter(標準ライブラリ) を活かして実装するこの構造は、他のアプリにも応用が効きます。
完成形を見てから細部の解説に進む流れが効果的です。実行→気になる箇所を解説で確認→自分の手で改造、というサイクルで定着が早まります。
カスタマイズ章では具体的な拡張アイデアを示しています。一つ実装するごとに動作確認することで、変更が予期せぬ副作用を起こさないかも体感できます。
2. 機能一覧
- 漢字クイズのメイン機能
- 直感的なGUIインターフェース
- 入力値のバリデーション
- エラーハンドリング
- 結果の見やすい表示
- クリア機能付き
3. 事前準備・環境
Python 3.10 以上 / Windows・Mac・Linux すべて対応
以下の環境で動作確認しています。
- Python 3.10 以上
- OS: Windows 10/11・macOS 12+・Ubuntu 20.04+
4. 完全なソースコード
右上の「コピー」ボタンをクリックするとコードをクリップボードにコピーできます。
import random
import time
import tkinter as tk
from tkinter import messagebox, ttk
# 漢字 → 読み方 (複数読みは | で区切り)
KANJI_DATA = {
"桜": "さくら",
"紅葉": "もみじ|こうよう",
"雪": "ゆき",
"海": "うみ",
"山": "やま",
"川": "かわ",
"空": "そら",
"星": "ほし",
"月": "つき",
"太陽": "たいよう",
"風": "かぜ",
"雲": "くも",
"雨": "あめ",
"虹": "にじ",
"雷": "かみなり",
"蝶": "ちょう",
"蛍": "ほたる",
"鯨": "くじら",
"鷲": "わし",
"象": "ぞう",
"麒麟": "きりん",
"薔薇": "ばら",
"向日葵": "ひまわり",
"紫陽花": "あじさい",
"煙突": "えんとつ",
"鞄": "かばん",
"玄関": "げんかん",
"厨房": "ちゅうぼう",
"醤油": "しょうゆ",
"珈琲": "コーヒー",
}
class App066:
"""漢字クイズ"""
def __init__(self, root):
self.root = root
self.root.title("漢字クイズ")
self.root.geometry("620x460")
self.root.configure(bg="#f8f9fc")
self.score = 0
self.total = 0
self.start_ts = time.time()
self.weights = {k: 1 for k in KANJI_DATA}
self.current = None
self._build_ui()
self.next_question()
self._tick()
def _build_ui(self):
"""UI を構築する"""
title = tk.Frame(self.root, bg="#3776ab", pady=12)
title.pack(fill=tk.X)
tk.Label(title, text="漢字クイズ", font=("Noto Sans JP", 16, "bold"),
bg="#3776ab", fg="white").pack()
info = tk.Frame(self.root, bg="#f8f9fc")
info.pack(fill=tk.X, pady=8)
self.score_label = tk.Label(info, text="正解 0 / 0",
font=("Noto Sans JP", 12), bg="#f8f9fc",
fg="#3776ab")
self.score_label.pack(side=tk.LEFT, padx=20)
self.time_label = tk.Label(info, text="経過: 0秒",
font=("Noto Sans JP", 12), bg="#f8f9fc")
self.time_label.pack(side=tk.RIGHT, padx=20)
self.q_label = tk.Label(self.root, text="",
font=("Noto Sans JP", 60, "bold"),
bg="white", relief=tk.GROOVE,
width=6, height=1)
self.q_label.pack(pady=15)
self.entry = ttk.Entry(self.root, font=("Noto Sans JP", 16),
justify="center", width=18)
self.entry.pack(pady=4)
self.entry.bind("<Return>", lambda e: self._answer())
self.entry.focus_set()
btns = tk.Frame(self.root, bg="#f8f9fc")
btns.pack(pady=8)
ttk.Button(btns, text="回答", command=self._answer).pack(side=tk.LEFT, padx=4)
ttk.Button(btns, text="スキップ", command=self.next_question).pack(side=tk.LEFT, padx=4)
ttk.Button(btns, text="リセット", command=self.reset).pack(side=tk.LEFT, padx=4)
self.fb = tk.Label(self.root, text="", bg="#f8f9fc",
font=("Noto Sans JP", 12))
self.fb.pack(pady=4)
def _weighted_choice(self):
"""重みに基づいて漢字を選ぶ"""
items = list(self.weights.items())
total = sum(w for _, w in items)
r = random.uniform(0, total)
s = 0
for k, w in items:
s += w
if r <= s:
return k
return items[-1][0]
def next_question(self):
"""新しい問題を出題する"""
self.current = self._weighted_choice()
self.q_label.config(text=self.current)
self.entry.delete(0, tk.END)
self.fb.config(text="")
self.entry.focus_set()
def _answer(self):
"""回答を判定する"""
if self.current is None:
return
ans = self.entry.get().strip()
if not ans:
return
self.total += 1
accepts = KANJI_DATA[self.current].split("|")
if ans in accepts:
self.score += 1
self.fb.config(text="正解!", fg="green")
self.weights[self.current] = max(1, self.weights[self.current] - 1)
else:
self.fb.config(text=f"不正解。正解: {accepts[0]}", fg="red")
self.weights[self.current] += 3
rate = int(self.score / self.total * 100) if self.total else 0
self.score_label.config(text=f"正解 {self.score} / {self.total} ({rate}%)")
# 1秒後に次の問題
self.root.after(900, self.next_question)
def reset(self):
"""成績をリセットする"""
if not messagebox.askyesno("確認", "成績をリセットしますか?"):
return
self.score = 0
self.total = 0
self.start_ts = time.time()
self.weights = {k: 1 for k in KANJI_DATA}
self.score_label.config(text="正解 0 / 0")
self.next_question()
def _tick(self):
"""経過時間を更新する"""
elapsed = int(time.time() - self.start_ts)
self.time_label.config(text=f"経過: {elapsed}秒")
self.root.after(1000, self._tick)
if __name__ == "__main__":
root = tk.Tk()
app = App066(root)
root.mainloop()
5. コード解説
漢字クイズのコードを詳しく解説します。クラスベースの設計で各機能を整理して実装しています。
クラス設計とコンストラクタ
App066クラスにアプリの全機能をまとめています。__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ファイルを作成する
新しいファイルを作成して app066.py と保存します。
-
2クラスの骨格を作る
App066クラスを定義し、__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:保存機能の追加
処理結果をファイルに保存する機能を追加しましょう。