Flask – 模板


可以以 HTML 的形式返回绑定到某个 URL 的函数的输出。例如,在下面的脚本中,hello()函数将渲染“Hello World”并附加<h1>标签。

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 文件,该文件夹位于该脚本所在的同一文件夹中。

  • 应用程序文件夹
    • 你好.py
    • 模板
      • 你好.html

术语“Web 模板系统”是指设计可以动态插入可变数据的 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 的变量部分插入到{{ name }}占位符处。

网页模板系统示例

jinja2模板引擎使用以下分隔符来转义 HTML。

  • {% ... %} 用于语句
  • {{ ... }} 用于打印到模板输出的表达式
  • {# ... #} 表示未包含在模板输出中的注释
  • # ... ## 用于行语句

在以下示例中,演示了模板中条件语句的使用。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-elseendif包含在分隔符{%..%}中。

运行 Python 脚本并访问 URL http://localhost/hello/60,然后访问 http://localhost/hello/30以查看有条件更改的 HTML 输出。

Python 循环结构也可以在模板内部使用。在以下脚本中,当在浏览器中打开URL http://localhost:5000/result时, result()函数将字典对象发送到模板results.html 。

result.html的模板部分使用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.items() %}
            <tr>
               <th> {{ key }} </th>
               <td> {{ value }} </td>
            </tr>
         {% endfor %}
      </table>
   </body>
</html>

在这里,与For循环相对应的 Python 语句再次包含在 {%..%} 中,而表达式key 和 value则放在{{ }}内。

开发开始运行后,在浏览器中打开http://localhost:5000/result,得到以下输出。

表格模板示例