Flask模板jinja2

模板预热

• 在渲染模板的时候，默认会从项目根目录下的‘templates‘目录下查找模板。

• 如果不想把模板文件放在‘templates‘目录下，那么可以在‘Flask‘初始化的时候指定‘template_folder‘来指定模板的路径

模块传参数

• 1.在使用‘render_template‘渲染模板的时候，可以传递关键字参数。以后直接在模板中使用就可以了

• 2.如果你的参数过多，那么可以将所有的参数放到一个字典中，然后再传这个字典参数的时候，使用两个星号，将字典打散成关键字参数

• 3.如果想要再HTML中访问我们传递的参数 比如传递的是 username=‘xiaoxin‘

  • 如果是关键字参数 直接{{username}}，就可以将我们的参数对应的内容映射到前端页面上

  • 如果传递的是字典 比如

    • content = {‘name‘:‘age‘} 那么就可以{{content.name}} 就能将里面的age映射到前端上

    • 使用**content 相当于将字典里面的参数，变成关键字传参,然后就可以直接{{username}}，将我们参数的内容映射到前端网页上

模板中使用url_for

• 模板中的url_for跟我们后台视图函数中的url_for使用起来基本是一模一样的，也是传递视图函数的名字，也可以传递参数

• 再html里面使用的时候，需要再urlfor 左右两边加上 {{url_for(‘func‘)}}

过滤器的基本使用

• 有时候我们想要再模板中对一些变量进行处理,那么就必须需要类似于Python中的函数一样，可以将这个值传到函数中，然后做一些操作

• 基本语法:

  • {{variable|过滤器名字}}。使用管道符号‘|‘进行组合

• 过滤器是通过管道符号(|)进行使用的，列如{{name|length}},将返回name的长度。过滤器相当于是一个函数，把当前的变量传入到过滤器中，然后过滤器根据自己的功能，再返回相应的值，之后再将结果渲染到页面中。Jinja2中内置了许多过滤器，再这里可以看到所有的过滤器，现在对一些常用的过滤器进行详解:

  • abs(value):返回一个数的绝对值 列如-1|abs

  • default(value,default_value,boolean=false):如果当前变量没有值e，则会使用参数中的值来代替。{{name|defaule(‘xiaotuo‘)}} --如果name不存在，则会使用xiaotuo来替代.boolean=False默认是再只有这个变量为undefined的时候才会使用default中的值，如果想使用python的形式判断是否为false(列如:None,空字符串，空列表，空字典等)，则可以传递boolean=true

    • 也可以使用or来替代default(‘默认值‘,boolean=True).例如

      • {{singature or ‘此人很懒，没人留下说明‘}}

  • 自动转义过滤器:

    • escape(value)或e:转义字符. 会将< 、>等符号转义成HTML中的符号。列如:content|escape 或content|e

    • safe(value):如果开启了全局转义,那么safe过滤器会将变量关掉转义。示例:content_html|safe

    • autoescape标签,可以对他里面的代码块关闭或开启自动转义

      • {%autoescape off/on%} off是关闭自动转义 on是开启自动转义

      • .....代码块

      • {%endautoescape%}

  • first(value):返回一个序列的第一个元素。names|first

  • format(value,*args,**kwargs):格式化字符串。例如

    • {{"%s-%s"|format(‘hello?‘,"Foo!”)}} 将输出: hello?-Foo!

  • last(value):返回一个序列的最后一个元素。示例names|last

  • length(value):返回一个序列或者字典的长度。示例names|length

  • join(value,d=u")：将一个序列用d这个参数的值拼接成字符串

  • int(value): 将值转换为int类型

  • float(value): 将值转换为float类型

  • lower(value):将字符串转换为小写

  • upper(value):将字符串转换为大写

  • replace(value,old,new): 将old替换成new的字符串

  • truncate(value,length=255,killwords=False): 截取length长度的字符串

  • striptags(value): 删除字符串中所有的HTML标签，如果出现多个空格，将替换成一个空格

  • trim: 截取字符串前面和后面的空白字符

  • string(value): 将变量转换成字符串

  • wordcount(s): 计算一个长字符串中单词的个数

• 自定义模板过滤器

  • 过滤器本质上就是一个函数，如果在模板中调用这个过滤器，那么就会将这个变量的值作为第一个参数传给过滤器这个函数，然后函数的返回值会作为这个过滤器的返回值。需要使用到一个装饰器 @app.template_filter(‘cut‘)

  • 1.在python文件中，写好自己的过滤器。

    • @app.template_filter(‘cut‘) #装饰器里面传的我们自定义过滤器的名字，方便再HTML中使用

    • def cut(value): value是当再html中调用这个自定义过滤器的时候，会将调用这个自定义过滤器的变量传给value

      • value = value.replace(‘hello‘,‘‘)

      • return value

  • 2.在HTML中

    • < p>{{story|cut}} < /p>

控制语句详解

• 所有的控制语句都是放在{%....%}中，并且有一个语句{%endxxx%}来进行结束.Jinja2中 常用的控制语句有if/for....in...,现对他们进行详解

  • 1.‘if‘: if语句和python中的类似，可以使用>,<,<=,>=,==,!=来进行判断，也可以通过‘and or not,()‘来进行逻辑合并操作，以下看列子

    • + {% if kenny.sick %}
        + kenny is sick.
      + {% elif kenny.dead %}
        + You killed Kenny！ You bastard!!!
      + {%else%}
        + Kenny looks okay---so far
      + {%endif%}

  • 2.‘for....in...‘:‘for‘循环可以遍历任何一个序列包括数组、字典、元组。并且可以进行反向遍历。以下将用几个列子进行解释:

    • 普通的遍历

      • + < ul>
        + {%for user in usres%}
        + < li>{{user.username|e}} < /li>
        + {%endfor%}
        + < /ul>

    • 遍历字典:

      • + < dl>
        + {%for key,value in my_dice.iteritems() %}
        + < dt> {{key|e}}</ dt>
        + < dd> {{value|e}}< /dd>
        + {{%endfor%}}
        + < /dl>

    • 如果序列中没有值的时候，进入‘else‘

      • + < ul>
        + {%for user in usres%}
        + < li>{{user.username|e}} < /li>
        + {%else%}
        + < li>< em>no users found< /em>< /li>
        + {%endfor%}
        + < /ul>

    • 并且Jinja中的for循环还包含以下变量，可以用来获取当前的遍历状态:

      • 变量 描述

      • loop.index 当前迭代的索引(从1开始)

      • loop.index0 当前迭代的索引(从0开始)

      • loop.first 是否是第一次迭代，返回Ture或False

      • loop.last 是否是最后一次迭代，返回True或False

      • loop.length 序列的长度

    • 另外，不可以使用continue和break表达式来控制循环的执行

宏的使用

• 宏的概念和基本使用

  • 模板中的宏跟python中的函数类似，可以传递函数，但是不能有返回值，可以将一些经常用到的代码片段放到宏中，然后把一些不固定的值抽取出，来当成一个变量，使用宏的时候，参数可以为默认值。以下将用一个列子来进行解释：

    • 定义宏

      • + {%macro input(name,value="",type=‘text‘)%}
          + < input type="{{type}}",name="{{name}}",value="{{value|e}}">
        + {%endmacro%}

  • 以上列子可以抽出了一个input标签，指定了一些默认参数。那么我们以后创建‘input‘标签的时候，可以通过她快速的创建

    • 使用宏

      • + < p>{{input(‘usename‘) }}< /p>
        + < p>{{input(‘password‘,type=‘password‘)  }} < /p>

• import语句

  • 在真实的开发中，会将一些常用的宏单独放在一个文件中，在需要使用的时候，再从这个文件中进行导入。‘import‘语句的用法跟‘python‘中的‘import‘类似,可以直接‘import....as....‘,也可以 from....import.... 或者 from....import....as...,假设现在有一个文件，叫做forms.html,里面有两个宏分别为 input和textarea 如下

    • + {%macro input(name,value="",type=‘text‘)%}
        - < input type="{{type}}",name="{{name}}",value="{{value|e}}">
      + {%endmacro%}
      + {%macro textarea(name,value="",rows=10,cols=40)%}
        - < textarea name="{{name}}"  rows="{{rows}}" cols="{{cols}}">{{value|e}} < /textarea>
      + {%endmacro%}

  • 导入宏的列子

    • 宏文件路径，不要以相对路径去寻找，都要以‘templates‘作为绝对路径去找

    • 如果想要在导入宏的时候，就把当前模板的一些参数传给宏所在的模板，那么就应该在导入的时候使用with context 示例

      • from ‘xxx.html‘ import input with context

    • + 1.import....as....形式:
        + {%import ‘forms.html‘ as forms%}
        + < dl>
          + < dt>Username< /dt>
          + < dd>{{forms.input(‘username‘) }} < /dd>
          + < dt>Password< /dt>
          + < dd>{{forms.input(‘password‘,type=‘password‘) }} < /dd>
        + < /dl>
        + < p> {{forms.textarea(‘comment‘) }} < /p>
      + 2.from...import....as..../from....import...形式
        + {%from ‘forms.html‘ import  input as input_field,textarea %}

• include标签

  • 这个标签相当于是直接将指定的模板代码复制粘贴到当前位置

  • ‘include‘标签，如果想要使用父模板中的变量，直接用就可以了，不需要使用with context

  • include的路径，也是跟import 一样，直接从‘templates‘根目录下去找，不要以相对路径去找

    • {%include ‘路径名.html‘%}

• set和with语句以及模板中定义变量

  • set语句:

    • 在模板中，可以使用‘set‘语句来定义变量，示例如下

      • {%set username=‘小鑫‘%}

      • 一旦定义了这个变量，那么在后面的代码中，都可以使用这个变量，就类似于python的变量定义是一样的

  • with语句:

    • with语句定义的变量，只能在‘with‘语句块中使用，超过了这个代码块，就不能在再使用了。示例代码块如下

      • + {%with classroom=‘xiaoxin1‘%}
        + < p> 班级: {{classroom}} < /p>
        + {%endwith%}

    • with语句也不一定要跟一个变量，可以定义一个空的‘with‘语句，以后再‘with’块中通过‘set‘定义的变量，就只能再这个‘with‘块中使用了

      • + {%with %}
        + {%set classroom=‘xiaoxin1‘%}
        + < p> 班级: {{classroom}} < /p>
        + {%endwith%}

• 加载静态文件(图片、CSS、JS)

  • 1.加载静态文件使用的是url_for函数，然后第一个参数需要为‘static‘,第二个参数需要为一个关键字参数 ‘filename="路径" ‘ 示例:

    • {{url_for("static",filename="xxx") }}

  • 路径查找，要以当前项目的‘static’目录作为根目录

• 模板继承详解

  • 为什么需要模板继承

    • 模板继承可以把一些公用的代码单独抽取出去放到一个父模板中，以后子模版直接继承就可以使用了，这样可以减少重复性的代码，并且以后修改起来也比较方便

  • 模板继承语法：

    • 使用‘extends关键语句‘，来指明继承的父模板。父模板的路径，也是相对于templates文件夹下的绝对路径。示例代码如下

      • {%extends ‘base.html‘%}

  • block语法:

    • 一般在父模板中，只能定义一些公用的代码。子模版可能要根据具体的需求实现不同的代码。这时候父模板就应该有能力提供一个接口，让子模板来实现，从而实现具体业务需求的功能。

    • 在父模板中

      • {%block block的名字%}
        {%endblock%}

    • 在子模版中 也叫方法重写(重写父模板里面的block)

      • + {%block block的名字%}
        + 子模版中的代码
        + {%endblock%}

  • 调用父模板代码blcok中的代码

    • 默认情况下，子模版如果实现了父模板定义的block，那么子模版block中的代码就会覆盖掉父模板中的代码。如果想要在子模版中仍然保持父模板中的代码，那么可以使用{{super()}}来实现。 示例如下

      • 父模板

        • + {%block block的名字%}
          + 这是父模板里面的代码
          + {%endblock%}

      • 子模版

        • + {%block block的名字%}
          + {{super()}}
          + 这是子模版中的代码
          + {%endblock%}

  • 调用另外一个block中的代码

    • 如果想要在另外一个模板中使用其他模板中的代码，那么可以通过{{self.其他block名字()}} 就可以了 示例代码如下

      • + {%block title%}
        + 这是首页
        + {%endblock%}
        + 
        + {%block body_block%}
        + {{self.title()}}
        + 我是子模版中的代码
        + {%endblock%}

  • 其他注意事项

    • 1.子模版中的代码，第一行，应该是‘extends‘

    • 2.子模版中，如果想要实现自己的代码，应该放到block中，如果放到其他地方，那么就不会被渲染