render_template関数で渡せるのは変数だけですか？

いいえ、変数以外にも辞書やリスト、数値や文字列などの基本データ型も渡せます。ただし、テンプレート内で扱いやすいように、辞書形式で渡すのが一般的です。

render_templateで指定するHTMLファイルはどこに置くべきですか？

通常は「templates」フォルダの中にHTMLファイルを置きます。Flaskはこのフォルダ名をデフォルトで認識するので、特別な設定なしで読み込むことができます。

render_template関数の引数に日本語の変数名を使っても大丈夫ですか？

Pythonとしてはエラーにならない場合もありますが、テンプレート側との整合性や可読性の観点から、英語の変数名を使うのが推奨されます。

2025年4月11日 2025年10月29日ながみえ

【Flask】render_template関数を理解しよう｜Chapter2-4

ながみえ

本記事には広告（アフィリエイトリンク）が含まれます。リンク経由で申込が発生した場合、当サイトが報酬を受け取る可能性があります。

一つ前のページではurl_for関数について学習しました。

今回は render_template関数について見ていきましょう。

Chapter１：Flask入門編
Chapter２：Jinja2入門編
　・Chapter2-1：Jinja2とは何か｜テンプレートエンジン入門
　・Chapter2-2：テンプレートの継承を理解しよう
　・Chapter2-3：url_for関数を理解しよう
　・Chapter2-4：render_template関数を理解しよう ◁今回はここ
　・Chapter2-5：テンプレートと繰り返し処理
　・Chapter2-6：テンプレートと分岐処理
Chapter３：フィルター編
Chapter４：フォーム編
Chapter５：データベース編
Chapter６：エラーハンドリングとデバッグ編
Chapter７：アプリ開発編

FlaskでWebアプリケーションを作る際、HTMLファイルにPython側から値を渡して表示することがとても重要になります。

その橋渡しをしてくれるのが render_template()関数です。

この関数を使えば、HTMLのテンプレートとPythonコードをうまく組み合わせて、ユーザーごとに異なる内容を表示するような動的なページを簡単に作ることができます。

この記事では、render_template() 関数の基本的な使い方について、具体的なコード例と共にわかりやすく解説していきます。

Flask開発を Stream Deck でボタン化しよう！

Flaskは非常に軽量かつシンプルなフレームワークですが、それゆえに定型作業が多く、開発は単調な作業の連続になりがちです。

それこそがFlaskのメリットであり、習得難易度が低い理由でもありますが、単調な作業は退屈で、ミスも起こりやすいでしょう。

そこで役に立つのが Stream Deck 。

このような定型手順が多い作業を “ボタン化” することで視覚化。

圧倒的に効率的かつストレスフリーな開発環境が簡単に手に入ります↓↓

render_template()関数の役割と使い方【初心者向け】

【Python】勉強猫がノートパソコンを前にして学習を始める様子。記事内の学習スタート用イラスト

render_template とは直訳すると「テンプレートを描画する」という意味で、FlaskにおいてHTMLテンプレートを表示する際に使われる関数です。

例えば「ユーザー名を表示する」ようなページを作りたいとき、Python側のコードでユーザー名を変数として定義し、それをHTMLに渡して表示させる場面があります。

そんなときに render_template() 関数を使います。

単一データの渡し方｜PythonコードとHTMLテンプレートの連携例

テンプレートに渡す値が一つである場合は、以下のような書き方をします。

render_template("テンプレートファイル名", 変数名=値)

テンプレートファイルは templates フォルダ内に保存されている必要があります。

任意のフォルダ/
├── app.py
└── templates/（フォルダ）
    └── テンプレート.html

また変数名はテンプレート内で使用する名前、値はPython側で定義された値になります。

例えば、ユーザー名を渡して表示するコードを見てみましょう。以下の二つのコードをコピーして保存し、実行してみてください。

from flask import Flask, render_template  # flaskモジュールの中のFlaskクラスとrender_template関数をインポート
app = Flask(__name__)

@app.route("/")  # もしこのURLにアクセスされたら
def index():
    user_name = "太郎"  # 表示させたい名前
    return render_template("hello.html", name = user_name)  # name変数をテンプレートに渡す
		 # render_template("テンプレートファイル名", 変数名=値)
  
if __name__ == "__main__":
    app.run(debug=True)

<!DOCTYPE html>
<html>
<head>
    <title>Hello</title>
</head>
<body>
    <h1>こんにちは、{{ name }}さん！</h1>
</body>
</html>

user_name というPython側の変数を name という名前でテンプレートに渡しています。
HTML側では {{ name }} と書くことでその値を表示できます。
テンプレート内の {{ }} は「この中の変数を表示」という意味になります。

複数データをまとめて渡す方法と実用例

テンプレートに渡す値が複数ある場合は、以下のような書き方をします。

render_template("テンプレートファイル名", 変数名1=値1, 変数名2=値2, ...)

複数の値を同時に渡す場合も、同様にキーワード引数で指定します。

名前と年齢を表示するコードの例を見てみましょう。

from flask import Flask, render_template  # flaskモジュールの中のFlaskクラスとrender_template関数をインポート
app = Flask(__name__)

@app.route("/profile")  # もしこのURLにアクセスされたら
def profile():
    user_name = "花子"  # 表示させたい名前
    user_age = 25       # 表示させたい年齢
    return render_template("profile.html", name = user_nam, age = user_age)
		 # render_template("テンプレートファイル名", 変数名1=値1, 変数名2=値2, ...)
  
if __name__ == "__main__":
    app.run(debug=True)

<!DOCTYPE html>
<html>
<head>
    <title>プロフィール</title>
</head>
<body>
    <h1>プロフィールページ</h1>
    <p>名前：{{ name }}</p>
    <p>年齢：{{ age }}歳</p>
</body>
</html>

Python側で user_name と user_age を定義し、それぞれ name と age としてテンプレートに渡しています。
テンプレートでは {{ name }} や {{ age }} を使って表示します。
複数のデータを一度に渡せることで、より柔軟なテンプレートが作れるようになります。

まとめ

render_template 関数は、Flaskにおけるテンプレート（HTML）とPythonの値をつなぐ重要な関数です。

1つの値を渡すのも、複数の値を渡すのも基本構文は簡単で、初心者でも直感的に使いやすく設計されています。

次回の記事では、テンプレート内での繰り返し処理（for文）について学び、より動的で実用的なページの作り方を学習していきましょう。

サイト改善アンケート｜1分だけ、ご意見をお聞かせください

本サイトでは、みなさまの学習をよりサポートできるサービスを目指しております。
そのため、ご利用者のみなさまの「プログラミングを学習する理由」などをアンケート形式でお伺いしています。

ご協力いただけますと幸いです。

アンケート

２．Flaskを学習する主な理由は何ですか？１．このサイトをどのように活用していますか？また、今後どのように活用したいですか？４．自由にコメント・ご意見・リクエスト等があればご記入ください。（任意）

１．このサイトをどのように活用していますか？また、今後どのように活用したいですか？

この記事だけ、単発で利用する予定
必要な記事をピックアップして参照したい
記事を順番に読み進めて、体系的に学習したい
その他

２．Flaskを学習する主な理由は何ですか？

３．今後、副業や転職を考えていますか？

４．自由にコメント・ご意見・リクエスト等があればご記入ください。（任意）

練習問題：本のタイトルと著者名をWebページで表示するアプリを作ろう

【Python】勉強猫がノートパソコンに向かい、練習問題に挑戦する様子。記事内の休憩用イラスト

この問題では、Python側で定義した「本のタイトル」と「著者名」をテンプレートに渡し、それらの情報をWebページ上に表示するアプリを作成します。

テンプレートでは変数を使って受け取った値を画面に表示できるようにしてください。

この問題の要件

以下の要件に従ってコードを完成させてください。

/ にアクセスしたときに、「本のタイトル」と「著者名」の2つの情報をテンプレートに渡して表示すること
タイトルには「吾輩は猫である」、著者には「夏目漱石」という文字列を使用すること
render_template() 関数を使用して、テンプレートファイル（book.html）を返すこと
book.html では、渡された2つの情報を {{ }} を使ってHTML上に表示すること
HTMLには「タイトル：」と「著者：」というラベルをつけて表示すること

ただし、以下のような実行結果となるコードを書くこと。

おすすめの本

タイトル：吾輩は猫である  
著者：夏目漱石

正解コード

例えば、以下のようなプログラムが考えられます。

正解コード

from flask import Flask, render_template

# Flaskのアプリケーションオブジェクトを作成
app = Flask(__name__)

# "/" にアクセスがあったときに実行される処理
@app.route("/")
def show_info():
    # 表示させたい情報（今回は本のタイトルと著者名）
    # → 今回の記事で学んだ「テンプレートに複数の値を渡す方法」を使用
    title = "吾輩は猫である"
    author = "夏目漱石"
    
    # render_template関数を使って、テンプレートファイルを表示
    # この関数はテンプレートと値を結びつけてHTMLとして返す
    return render_template("book.html", book_title=title, book_author=author)

# Flaskアプリを起動（デバッグモードON）
if __name__ == "__main__":
    app.run(debug=True)

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>おすすめの本</title>
</head>
<body>
    <h1>おすすめの本</h1>

    <!-- Pythonから渡された「book_title」と「book_author」を表示 -->
    <!-- {{ }} はJinja2の構文で、変数の中身をテンプレート内に表示する -->
    <p>タイトル：{{ book_title }}</p>
    <p>著者：{{ book_author }}</p>
</body>
</html>

もっと分かりやすい学習サイトにするために

この記事を読んで「ここが分かりにくかった」「ここが難しかった」等の意見を募集しています。

世界一わかりやすいFlask学習サイトにするため、ぜひ問い合わせフォームからご意見下さい。

<<前のページ

Flaskの記事一覧

次のページ>>

FAQ｜render_template関数の使い方に関するよくある質問

Q1. render_template関数で渡せるのは変数だけですか？: いいえ、変数以外にも辞書やリスト、数値や文字列などの基本データ型も渡せます。ただし、テンプレート内で扱いやすいように、辞書形式で渡すのが一般的です。

Q2. render_templateで指定するHTMLファイルはどこに置くべきですか？: 通常は「templates」フォルダの中にHTMLファイルを置きます。Flaskはこのフォルダ名をデフォルトで認識するので、特別な設定なしで読み込むことができます。

Q3. render_template関数の引数に日本語の変数名を使っても大丈夫ですか？: Pythonとしてはエラーにならない場合もありますが、テンプレート側との整合性や可読性の観点から、英語の変数名を使うのが推奨されます。