如何用Jinja2继承未定义的变量？

在使用Jinja2模板引擎时，如果你尝试继承一个未定义的变量，通常会遇到UndefinedError。这是因为Jinja2在渲染模板时，会检查所有变量是否已经定义。

基础概念

Jinja2是一个现代的Python模板语言，它被广泛用于Web开发中。模板继承允许你创建一个基础模板，并在其他模板中重用和扩展这个基础模板。

解决方法

为了避免这个问题，你可以采取以下几种方法：

1. 默认值

你可以为变量提供一个默认值，这样即使变量未定义，也不会抛出错误。

{% extends layout|default('base.html') %}

在这个例子中，如果layout变量未定义，Jinja2会使用base.html作为默认值。

2. 检查变量是否存在

你可以在模板中使用defined测试来检查变量是否已定义。

{% if layout is defined %}
    {% extends layout %}
{% else %}
    {% extends 'base.html' %}
{% endif %}

在这个例子中，如果layout变量已定义，Jinja2会继承它；否则，会继承base.html。

3. 在视图函数中定义变量

确保在视图函数中正确地传递了所有需要的变量。

from flask import Flask, render_template

app = Flask(__name__)

@app.route('/')
def index():
    layout = 'custom_layout.html'  # 确保这个变量被定义
    return render_template('index.html', layout=layout)

在这个例子中，layout变量在视图函数中被定义并传递给模板。

示例代码

以下是一个完整的示例，展示了如何在Flask应用中使用Jinja2模板继承，并处理未定义变量的情况。

# app.py
from flask import Flask, render_template

app = Flask(__name__)

@app.route('/')
def index():
    layout = 'custom_layout.html'  # 确保这个变量被定义
    return render_template('index.html', layout=layout)

if __name__ == '__main__':
    app.run(debug=True)

<!-- templates/index.html -->
{% extends layout|default('base.html') %}

{% block content %}
    <h1>Welcome to the homepage</h1>
{% endblock %}

<!-- templates/base.html -->
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Base Template</title>
</head>
<body>
    {% block content %}{% endblock %}
</body>
</html>