Flask 简明教程

Flask – Templates

可以以 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 模板引擎的地方。可以使用 render_template() 函数呈现 HTML 文件，而不从函数返回硬编码的 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 会尝试在模板文件夹中查找 HTML 文件，该文件夹与该脚本存在的文件夹相同。

  1. Application folder Hello.pytemplates hello.html

术语 ‘web templating system’ 涉及设计 HTML 脚本，可在其中动态插入变量数据。Web 模板系统包含一个模板引擎、某种数据源和一个模板处理器。

Flask 使用 jinja2 模板引擎。Web 模板包含穿插放置的变量和表达式（在此情况下为 Python 表达式）的 HTML 语法，这些变量和表达式在呈现模板时会被替换值。

以下代码作为 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 的 variable 部分插入到 {{ name }} 占位符中。

web templating system example

jinja2 模板引擎使用以下定界符从 HTML 中转义。

  1. {% …​ %} 用于语句

  2. {{ …​ }}，表示输出到模板的表达式

  3. {# …​ #}，表示未包含在模板输出中的注释

  4. = … ##，表示行语句

在以下示例中，演示了模板中的条件语句用法。指向 hello() 函数的 URL 规则接受整数参数。它传到 hello.html 模板。在其内部，比较收到的数字值（分数）（大于或小于 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 的模板部分使用 for loop ，以将字典对象 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 脚本保存为 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 循环的 Python 语句同样用 {%..%} 括起来，而表达式 key and value 则放在 {{ }} 中。

开发开始运行后，在浏览器中打开 http://localhost:5000/result ，以获取以下输出。

table template example