初心者向け No.087

アンケートフォーム

ラジオ・チェックボックス・テキストを組み合わせたアンケートフォーム。回答をCSVに保存できる。

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

📋 目次

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

1. アプリ概要

ラジオ・チェックボックス・テキストを組み合わせたアンケートフォーム。回答をCSVに保存できる。

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

このアプリは「入門」カテゴリです。ウィンドウ・ウィジェット・イベントの基本構造を反復することで、後から複雑なアプリを作るときの骨格が身につきます。tkinter（標準ライブラリ） を活かして実装するこの構造は、他のアプリにも応用が効きます。

コピー＆実行で動作確認 → コード解説で構造理解 → カスタマイズで応用、の 3 ステップで進めると、短時間で本質を押さえられます。

アプリを完成させた後は、自分の使い方に合わせて改造するのが学びを定着させる近道です。カスタマイズ章のアイデアを足がかりに、独自機能を一つ追加してみてください。

2. 機能一覧

アンケートフォームのメイン機能
直感的なGUIインターフェース
入力値のバリデーション
エラーハンドリング
結果の見やすい表示
クリア機能付き

3. 事前準備・環境

ℹ️

動作確認環境

Python 3.10 以上 / Windows・Mac・Linux すべて対応

以下の環境で動作確認しています。

Python 3.10 以上
OS: Windows 10/11・macOS 12+・Ubuntu 20.04+

4. 完全なソースコード

💡

コードのコピー方法

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

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

app087.py

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import csv
from datetime import datetime


class App087:
    """アンケートフォーム: ラジオ・チェック・テキストを CSV 保存"""

    HOBBIES = ["読書", "映画", "スポーツ", "音楽", "ゲーム", "旅行"]
    SATISFACTION = [
        ("非常に満足", 5),
        ("満足", 4),
        ("普通", 3),
        ("不満", 2),
        ("非常に不満", 1),
    ]

    def __init__(self, root):
        self.root = root
        self.root.title("アンケートフォーム")
        self.root.geometry("600x650")
        self.root.configure(bg="#f8f9fc")
        self._build_ui()

    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=20, pady=15)
        main.pack(fill=tk.BOTH, expand=True)

        # 名前
        name_frame = ttk.LabelFrame(main, text="お名前 (任意)", padding=8)
        name_frame.pack(fill=tk.X, pady=4)
        self.name_var = tk.StringVar()
        ttk.Entry(name_frame, textvariable=self.name_var, width=40).pack(fill=tk.X)

        # ラジオボタン: 満足度
        sat_frame = ttk.LabelFrame(main, text="Q1. このアプリの満足度は？", padding=8)
        sat_frame.pack(fill=tk.X, pady=4)
        self.sat_var = tk.IntVar(value=0)
        for label, val in self.SATISFACTION:
            ttk.Radiobutton(sat_frame, text=label, variable=self.sat_var, value=val).pack(anchor="w")

        # チェックボックス: 趣味
        hob_frame = ttk.LabelFrame(main, text="Q2. 趣味 (複数選択可)", padding=8)
        hob_frame.pack(fill=tk.X, pady=4)
        self.hobby_vars = {}
        for i, hobby in enumerate(self.HOBBIES):
            v = tk.BooleanVar()
            self.hobby_vars[hobby] = v
            ttk.Checkbutton(hob_frame, text=hobby, variable=v).grid(row=i // 3, column=i % 3, sticky="w", padx=8, pady=2)

        # 自由記述
        com_frame = ttk.LabelFrame(main, text="Q3. ご意見・ご感想", padding=8)
        com_frame.pack(fill=tk.BOTH, expand=True, pady=4)
        self.comment_text = tk.Text(com_frame, height=5, font=("Noto Sans JP", 10))
        self.comment_text.pack(fill=tk.BOTH, expand=True)

        # 操作ボタン
        btn = tk.Frame(main, bg="#f8f9fc")
        btn.pack(pady=10)
        ttk.Button(btn, text="CSVに保存", command=self.save_csv).pack(side=tk.LEFT, padx=4)
        ttk.Button(btn, text="プレビュー", command=self.preview).pack(side=tk.LEFT, padx=4)
        ttk.Button(btn, text="クリア", command=self.clear).pack(side=tk.LEFT, padx=4)

    def _collect(self):
        """フォーム入力を辞書として収集する"""
        if self.sat_var.get() == 0:
            raise ValueError("満足度を選択してください")
        hobbies = [h for h, v in self.hobby_vars.items() if v.get()]
        return {
            "timestamp": datetime.now().strftime("%Y-%m-%d %H:%M:%S"),
            "name": self.name_var.get().strip(),
            "satisfaction": self.sat_var.get(),
            "hobbies": ";".join(hobbies),
            "comment": self.comment_text.get("1.0", tk.END).strip(),
        }

    def save_csv(self):
        """回答を CSV に追記保存する"""
        try:
            row = self._collect()
        except ValueError as e:
            messagebox.showwarning("入力エラー", str(e))
            return
        path = filedialog.asksaveasfilename(
            defaultextension=".csv",
            filetypes=[("CSVファイル", "*.csv")],
            initialfile="survey.csv",
        )
        if not path:
            return
        # 既存ファイルにヘッダーが無い場合のみ書き込み
        try:
            import os
            write_header = not os.path.exists(path) or os.path.getsize(path) == 0
            with open(path, "a", newline="", encoding="utf-8-sig") as f:
                writer = csv.DictWriter(f, fieldnames=list(row.keys()))
                if write_header:
                    writer.writeheader()
                writer.writerow(row)
            messagebox.showinfo("保存完了", f"回答を保存しました:\n{path}")
        except Exception as e:
            messagebox.showerror("保存エラー", f"保存に失敗しました: {e}")

    def preview(self):
        """送信内容をプレビュー表示する"""
        try:
            row = self._collect()
        except ValueError as e:
            messagebox.showwarning("入力エラー", str(e))
            return
        msg = "\n".join(f"{k}: {v}" for k, v in row.items())
        messagebox.showinfo("回答内容プレビュー", msg)

    def clear(self):
        """フォームを初期化する"""
        self.name_var.set("")
        self.sat_var.set(0)
        for v in self.hobby_vars.values():
            v.set(False)
        self.comment_text.delete("1.0", tk.END)


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

5. コード解説

アンケートフォームのコードを詳しく解説します。クラスベースの設計で各機能を整理して実装しています。

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

App087クラスにアプリの全機能をまとめています。__init__でウィンドウ設定、_build_ui()でUI構築、process()でメイン処理を担当します。責任の分離により、コードが読みやすくなります。