Flask Web开发 3.0 模板_flask文档3.0

想要开发出易于维护的程序，关键在于编写形式简洁且结构良好的代码。到目前为止我们接触到的示例都太简单，无法说明这一点，但Flask视图函数的两个完全独立的作用却被融合在了一起，这就会产生一个问题。

视图函数的作用很简单，即生成请求的响应。 对于简单的请求来说，这就足够了，但是一般而言，请求会改变程序的状态，而这种变化也会在视图函数中产生。

例如，用户在网站注册了一个新账户。用户在表单中输入电子邮件地址和密码，然后点击提交按钮。服务器接收到包含用户输入数据的请求，然后Flask把请求分发到处理注册请求的视图函数。这个视图函数需要访问数据库，添加新用户，然后生成响应回送浏览器。这两个过程分别称为业务逻辑和表现逻辑。

把业务逻辑和表现逻辑混在一起会导致代码难以理解和维护。假设要为一个大型表格构建一个HTML代码，表格中的数据由数据库中读取的数据以及必要的HTML字符串连接在一起。把表现逻辑移到模板中能够提升程序的可维护性。

模板是一个包含响应文本的文件，其中包含用占位变量表示的动态部分，其具体值只在请求的上下文中才能知道。使用真实值替换变量，再返回最终得到的响应字符串，这一过程称为渲染。为了渲染模板，Flask使用了一个名为Jinja2的强大模板引擎。

3.1 Jinja2模板引擎

形式最简单的Jinja2模板就是一个包含响应文本的文件。下面的例子是一个Jinja2模板，它和第二章helloworld示例中的index()视图函数的响应一样。Jinja2模板要放在整个Flask Web 工程的templates文件夹里。

<h1>Hello world!</h1>

<h1>Hello,{
  { name }}!</h1>

3.1.1 渲染模板

默认情况下，Flask在程序文件夹的templates文件夹中寻找模板。在示例程序的下一个版本中，要把前面定义的两个模板放在templates文件夹下，分别命名为index.html和user.html。然后，我们需要改一下程序中的视图函数，以便渲染这些模板。

from flask import render_template
@app.route('/')
def index():
    return render_template('index.html')
 
@app.route('/user/<name>')
def user(name):
    return render_template('user.html',name = name)
 
if __name__ == '__main__':
    app.run(debug=True)

3.1.2 变量

上面的代码在模板中使用的{ { name }}结构表示一个变量，它是一种特殊的占位符，告诉模板引擎这个位置的值从渲染模板时使用的数据中获取。

Jinja2能识别所有类型的变量，甚至是一些复杂的类型，例如列表、字典和对象。在模板中使用变量的一些示例如下：

<p>A value from a dictionary:{
  { mydict['key'] }}.</p>
<p>A value from a list:{
  { mylist[3] }}.</p>
<p>A value from a list,with a variable index:{
  { mylist[myintvar] }}.</p>
<p>A value from an object's method:{
  { myobj.somemethod }}.</p>

<h1>Hello,{
  { name|capitalize }}!</h1>

• safe：渲染值时不进行转义
• capitalize：把值的首字母转换成大写，其他字母转换成小写
• lower：把值转换成小写形式
• upper：把值转换成大写形式
• title：把值中的每个单词的首字母都转换成大写
• trim：把值的首尾空格去掉
• striptags：渲染之前把值中所有的HTML标签都删掉

3.1.3 控制结构

{% if user %}
    Hello ,{
   { user }}!
{% else %}
    Hello,Stranger!
{% endif %}