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中，如果放到其他地方，那么就不会被渲染

猜你喜欢