可以以 HTML 的形式返回绑定到某个 URL 的函数的输出。例如,在以下脚本中, hello() 函数将使用 <h1> 标签呈现 ‘Hello World’。
from flask import Flask
app = Flask(__name__)
@app.route('/')
def index():
return '<html><body><h1>'Hello World'</h1></body></html>'
if __name__ == '__main__':
app.run(debug = True)
但是,从 Python 代码生成 HTML 内容很麻烦,尤其是在需要放置变量数据和 Python 语言元素(如条件或循环)时。这需要经常从 HTML 中转义。
这是可以利用 Flask 所基于的 Jinja2 模板引擎的地方。而不是从函数返回硬编码 HTML,可以通过 render_template() 函数呈现HTML文件。
from flask import Flask
app = Flask(__name__)
@app.route('/')
def index():
return render_template(‘hello.html’)
if __name__ == '__main__':
app.run(debug = True)
Flask 将尝试在 templates 文件夹中找到 HTML 文件,该文件存在于此脚本所在的文件夹中。
- Application folder
- Hello.py
- templates
- hello.html
术语 ‘web templating system(web模板系统)’ 指的是设计一个 HTML 脚本,其中可以动态插入变量数据。web 模板系统包括模板引擎,某种数据源和模板处理器。
Flask 使用 jinga2 模板引擎。Web 模板包含用于变量和表达式(在这些情况下为 Python 表达式)的 HTML 语法散布占位符,这些是在呈现模板时替换的值。
以下代码在 templates 文件夹中另存为 hello.html 。
<!doctype html>
<html>
<body>
<h1>Hello {{ name }}!</h1>
</body>
</html>
接下来,从 Python shell 运行以下脚本:
from flask import Flask, render_template
app = Flask(__name__)
@app.route('/hello/<user>')
def hello_name(user):
return render_template('hello.html', name = user)
if __name__ == '__main__':
app.run(debug = True)
当开发服务器开始运行时,打开浏览器并输入URL http://localhost:5000/hello/mvl
URL 的变量部分插入 {{name}} 占位符。
Jinja2 模板引擎使用以下分隔符从 HTML 转义。
- {% … %} 用于语句
- {{ … }} 用于表达式可以打印到模板输出
- {# … #} 用于未包含在模板输出中的注释
- # … ## 用于行语句
在下面的示例中,演示了在模板中使用条件语句。hello() 函数的 URL 规则接受整数参数。它被传递到 hello.html 模板。其中,比较接收的数字(marks)的值(大于或小于50),因此有条件地呈现 HTML。
Python脚本如下:
from flask import Flask, render_template
app = Flask(__name__)
@app.route('/hello/<int:score>')
def hello_name(score):
return render_template('hello.html', marks = score)
if __name__ == '__main__':
app.run(debug = True)
hello.html的HTML模板脚本如下:
<!doctype html>
<html>
<body>
{% if marks>50 %}
<h1> Your result is pass!</h1>
{% else %}
<h1>Your result is fail</h1>
{% endif %}
</body>
</html>
请注意,条件语句 if-else 和 endif 包含在分隔符 {%…%} 中。
运行 Python 脚本并访问 URL http://localhost/hello/60 然后访问 http://localhost/hello/30 ,以查看 HTML 的输出是否有条件地更改。
Python 循环结构也可以在模板中使用。在以下脚本中,当在浏览器中打开 URL http://localhost:5000/result 时,result() 函数会将字典对象发送到模板 results.html。
result.html 的 Template 部分使用 for 循环将字典对象 result{} 的键和值对呈现为 HTML 表的单元格。
从 Python shell 运行以下代码:
from flask import Flask, render_template
app = Flask(__name__)
@app.route('/result/')
def result():
dict = {'phy':50,'che':60,'maths':70}
return render_template('result.html', result = dict)
if __name__ == '__main__':
app.run(debug = True)
将以下 HTML 脚本保存为 templates 文件夹中的 result.html:
<!doctype html>
<html>
<body>
<table border = 1>
{% for key, value in result.iteritems() %}
<tr>
<th> {{ key }} </th>
<td> {{ value }} </td>
</tr>
{% endfor %}
</table>
</body>
</html>
这里,对应于 For 循环的 Python 语句再次包含在 {%…%} 中,而表达式 key 和 value 放在 {{}} 中。
开发开始运行后,在浏览器中打开 http://localhost:5000/result 即可获得以下输出:
注意:
python3 中以上代码会报错:
jinja2.exceptions.UndefinedError
jinja2.exceptions.UndefinedError: 'dict object' has no attribute 'iteritems'
解决:
python3 下应将 HTML 脚本 result.html 改为:
<!doctype html>
<html>
<body>
<table border = 1>
{% for key, value in result.items() %}
<tr>
<th> {{ key }} </th>
<td> {{ value }} </td>
</tr>
{% endfor %}
</table>
</body>
</html>
改动的部分为 {% for key, value in result.iteritems() %} 改为了 {% for key, value in result.items() %}